Módulo Diletec Marketing

Visão Geral do Módulo DiletecMKT

O módulo DiletecMKT adiciona ao Perfex CRM uma camada completa de automação de marketing, permitindo orquestrar campanhas multicanal com e-mail, SMS e notificações push. A solução centraliza a criação, o agendamento e o acompanhamento das campanhas, garantindo rastreamento de abertura, cliques e comportamento por contato. Tudo foi desenhado seguindo os padrões da base Perfex/CodeIgniter para manter consistência, segurança e extensibilidade.

Principais Recursos

• Campanhas Dinâmicas: criação de campanhas orientadas a clientes ou leads, com filtros combináveis e lógica AND/OR.
• Fila Inteligente: geração automática de uma fila de envio (diletecmkt_queue) para controlar pendências, processamento, falhas e sucesso por destinatário.
• Mensagens Multicanal: suporte a e-mails com templates personalizáveis, SMS com gateway já integrado e push notifications via módulo Firebase (biblioteca Fcm_diletec).
• Rastreamento Completo: pixel de abertura e redirecionamento encurtado para cliques, com registros detalhados em diletecmkt_email_events, diletecmkt_link_map e diletecmkt_link_events.
• Reentrada Controlada: campanhas podem aceitar novos contatos mesmo após iniciadas, com janela de reentrada baseada em dias (cooldown) e checagem automática de status.
• Integração com Cron: o cron dispara diletecmkt_campaigns->process_queue() e sync_dynamic_campaigns(), garantindo que envios e atualizações ocorram em segundo plano.
• Relatórios em Tempo Real: dashboards mostram pendências, envios, falhas e taxas de abertura/clique por campanha ou por destinatário.

Arquitetura e Estrutura de Dados

1. Entidades Principais

   • diletecmkt_mkt: dados das campanhas (nome, filtros, templates, opções de reentrada, preferências multicanal).
   • diletecmkt_queue: fila dos destinatários com status, tentativas, mensagens de erro, tokens de tracking e payloads.
   • diletecmkt_email_events / diletecmkt_link_events: logs de abertura e clique, incluindo IP, user-agent e timestamp.
   • diletecmkt_link_map: tabela de correspondência para cada link rastreado dentro de um e-mail.
   • diletecmkt_email_status: base reservada para status retornados por provedores (bounce, rejeição etc.), pronta para evoluções futuras.

2. Bibliotecas e Modelos

   • Diletecmkt_campaigns: combina fila, envio, tracking e regeneração.
   • Diletecmkt_queue_model, Diletecmkt_recipients_model, Diletecmkt_tracking_model: abstraem as operações de enfileiramento, filtros avançados, tokens, métricas agregadas e coleta de eventos.
   • Fcm_diletec: biblioteca do módulo Firebase responsável pelo envio de push notifications para tokens cadastrados em fcm_tokens.

3. Tracking e Métricas

   • Na hora do envio, a biblioteca injeta um pixel de abertura (/diletecmkt/tracking/open/<token>) e reescreve cada link com diletecmkt/tracking/click/<token>.
   • Aberturas e cliques são registrados por fila e campanha, permitindo relatórios agregados e visão detalhada por contato.

Fluxo de Envio

1. A campanha é criada/atualizada, e seus destinatários são calculados pelos modelos.
2. A fila (diletecmkt_queue) recebe registros com payload, tokens e agendamento.
3. O cron processa os pendentes, envia e-mail/SMS/push e marca status.
4. Tracking registra interações e o frontend atualiza métricas.

Requisitos e Boas Práticas

• É necessário executar a rotina de instalação/upgrade (install.php) para criar/alterar tabelas.
• Configure um gateway de SMS e o módulo Firebase para push, caso queira usar esses canais.
• Habilite o cron do Perfex para que a fila seja processada automaticamente.
• Utilize os filtros com atenção: o módulo respeita as regras de prefixo diletecwoo_ e os padrões de Query Builder do CodeIgniter.

Quer saber Como criar uma Campanha no Módulo Diletec Marketing? acesse https://cp.diletec.com.br/knowledge-base/article/como-criar-uma-campanha-no-modulo-diletec-marketing