Mailbox Personalizado - Cliente Webmail para Perfex CRM

Cliente de Webmail Completo Integrado ao Perfex CRM

O módulo Mailbox Personalizado é um cliente de webmail robusto e totalmente integrado ao painel do Perfex CRM. Gerencie toda sua comunicação por email diretamente no sistema, com recursos avançados de IMAP, sincronização automática, anexos, rascunhos e conversas organizadas por leads.

Principais Funcionalidades

• Cliente Webmail Completo: Interface de email completa dentro do painel administrativo do Perfex
• Integração IMAP: Sincronização automática com servidor de email via protocolo IMAP
• Sincronização Automática via Cron: Sistema de scan automático de emails do servidor (hook after_cron_run)
• Configuração por Staff: Cada membro da equipe configura sua própria senha de email (campo mail_password na tabela staff)
• Caixa de Entrada (Inbox): Gestão completa de emails recebidos com tabela dedicada (mail_inbox)
• Caixa de Saída (Outbox): Controle de emails enviados com tabela separada (mail_outbox)
• Sistema de Anexos: Upload e download de arquivos anexos com pasta dedicada (uploads/mailbox/inbox/)
• Rascunhos (Drafts): Salve emails em rascunho para finalizar depois
• Sistema de Respostas: Responda emails com rastreamento (reply_from_id e reply_type)
• Marcações e Filtros: Marque emails como lido, estrelado, importante ou mova para lixeira
• Contador de Não Lidos: Badge no menu lateral mostrando número de emails não lidos em tempo real
• Menu Sidebar Integrado: Acesso rápido via ícone de envelope no menu principal (posição 6)
• Conversas por Lead: Histórico completo de comunicação por email vinculado a cada lead
• Aba de Conversação: Nova aba "Conversation" na página de detalhes do lead
• Configurações Flexíveis: Painel de configurações dedicado com opções de IMAP, criptografia, pasta, frequência
• Assinatura de Email: Campo personalizado para assinatura de cada staff member (mail_signature)
• Suporte a CC e BCC: Envie cópias e cópias ocultas de emails
• Sistema de Pastas: Organize emails em pastas (inbox como padrão)
• Detecção de Anexos: Flag has_attachment para identificar emails com arquivos
• Multi-destinatários: Suporte a múltiplos destinatários (To, CC, BCC)

Tabelas do Banco de Dados

Estrutura robusta com 3 tabelas principais:

• mail_inbox: Armazena emails recebidos com campos from_staff_id, to_staff_id, subject, body, date_received, read, stared, important, trash, from_email
• mail_outbox: Gerencia emails enviados com sender_staff_id, subject, body, date_sent, draft, reply_from_id, reply_type
• mail_attachment: Controle de anexos com mail_id, file_name, file_type, type (inbox/outbox)
• mail_conversation: Vinculação de emails com leads através de outbox_id, inbox_id e lead_id

Configurações Avançadas

Painel de configurações completo (posição 36 no menu de settings):

• mailbox_enabled: Ativar/desativar o módulo
• mailbox_imap_server: Servidor IMAP para conexão
• mailbox_encryption: Tipo de criptografia (SSL/TLS)
• mailbox_folder_scan: Pasta para escanear (padrão: Inbox)
• mailbox_check_every: Frequência de verificação em minutos (padrão: 3 minutos)
• mailbox_only_loop_on_unseen_emails: Processar apenas emails não lidos

Sistema de Sincronização IMAP

Recursos avançados de sincronização automática:

• Conexão via biblioteca php-imap (vendor/autoload.php)
• Scan automático via cron job (hook after_cron_run)
• Controle de última verificação por staff (campo last_email_check)
• Processamento de anexos automatizado
• Extração de corpo do email em texto plano (getPlainTextBody)
• Parsing de endereços (To, CC, From com regex)
• Suporte a Reply-To headers
• Marcação de mensagens como lidas no servidor (setUnseenMessage)
• Detecção automática de staff por email (get_staff_id_by_email)
• Tratamento de links do Google Drive (handle_google_drive_links_in_text)

Interface do Usuário

• CSS Personalizado: Arquivo mailbox_styles.css com versionamento
• JavaScript Dedicado: mailbox_js.js para funcionalidades interativas
• Badge de Notificação: Contador visual de emails não lidos no menu (ex: "Mailbox • 5")
• Ícone Envelope: fa-envelope-square para identificação rápida
• Aba em Leads: Aba "Conversation" com histórico completo de comunicação

Para Quem é Este Módulo?

• Equipes de Vendas: Gerencie comunicação com prospects diretamente no CRM
• Equipes de Suporte: Centralize atendimento por email com histórico por cliente
• Gestores: Monitore comunicação da equipe sem sair do sistema
• Consultores: Mantenha histórico completo de conversas com clientes
• Agências: Organize comunicação por projeto e cliente
• Empresas B2B: Rastreie toda comunicação comercial vinculada a leads

Benefícios Práticos

• Elimine a necessidade de alternar entre CRM e cliente de email
• Centralize toda comunicação em um único sistema
• Vincule automaticamente emails a leads e conversas
• Melhore rastreabilidade com histórico completo por lead
• Reduza tempo de resposta com interface integrada
• Economize horas de trabalho evitando cópia manual de emails
• Facilite colaboração com visibilidade de comunicação da equipe
• Garanta que nenhum email importante seja perdido

Fluxo de Trabalho

1. Configuração: Admin configura servidor IMAP nas settings
2. Credenciais: Cada staff member configura sua senha de email
3. Sincronização: Cron job escaneia servidor a cada X minutos
4. Recebimento: Emails são baixados e salvos em mail_inbox
5. Notificação: Badge no menu mostra emails não lidos
6. Visualização: Staff acessa mailbox e lê emails
7. Resposta: Emails podem ser respondidos diretamente
8. Vinculação: Conversas são automaticamente vinculadas a leads
9. Histórico: Aba "Conversation" mostra timeline completo

Recursos Técnicos Avançados

• Biblioteca php-imap: Processamento robusto de IMAP via vendor/autoload.php
• Simple HTML DOM: Parsing de HTML para extração de conteúdo
• Hooks Integrados: after_cron_run, app_admin_head, app_admin_footer, admin_init
• Migration Support: Hook migration_tables_to_replace_old_links para atualizações
• Helper Functions: Arquivo de helpers dedicado (mailbox/mailbox)
• Sistema de Upload: Pasta dedicada com proteção (index.html)
• Unique Filename: Função unique_filename para evitar conflitos
• MIME Detection: get_mime_by_extension para tipos de arquivo

Segurança e Performance

• Senhas de email armazenadas na tabela staff (campo mail_password)
• Controle de acesso baseado em staff_id
• Proteção de pasta de uploads com index.html
• Verificação de frequência para evitar sobrecarga (check_every)
• Opção de processar apenas emails não lidos
• Log de atividades em caso de falha de conexão IMAP

Informações Técnicas

• Versão: 2.0.3
• Autor: Taffarel Dev
• Compatibilidade: Perfex CRM 3.0 ou superior
• Requisitos: Servidor com suporte a IMAP, Cron jobs habilitado, Composer/autoload
• Tecnologias: PHP IMAP, Simple HTML DOM, jQuery, CSS3

Este módulo está licenciado sob a Licença MIT.