Ofertas

Sistema de campanhas comerciais pontuais para a Bepex. Envia mensagens personalizadas geradas por IA a leads do Pipedrive via email (Amazon SES) e/ou WhatsApp (Chatwoot). Roda no n8n self-hosted.

O que é

Diferente do Conteúdo Infinito (nutrição contínua), o Ofertas é para campanhas com prazo definido: promoções, lançamentos, ações sazonais. O operador escolhe um filtro do Pipedrive, um nome de campanha e o canal (email, WhatsApp ou ambos). O sistema cria uma fila de atividades no Pipedrive e depois processa lead a lead com mensagens personalizadas por IA.

Stack: n8n (orquestração) · Pipedrive (CRM + fila de atividades) · OpenRouter (IA) · Amazon SES (email, domínio bepexmkt.com.br) · Chatwoot (WhatsApp, chat.bepex.com.br account 2).

Status atual

EM PRODUÇÃO — campanha "Reengajamento Jun 2026" lançada em 2026-06-11 (1.565 atividades).

Item	Estado
WF-Oferta-Launcher	Inativo (manual — só reativar para a próxima campanha)
WF-Oferta-Dispatcher	Ativo (crons 8h+14h seg-sex) desde 2026-06-11
WF-Oferta-Worker	Ativo (webhook GET, self-trigger 5-15min) desde 2026-06-11
Email senders	relacionamento@ e contato@ em bepexmkt.com.br (round-robin)
Bug multi-email SES	Corrigido (2026-06-29) — split de multi-email no Code "Prepara Email SES"
Pendência menor	"Salva Inbox Pipedrive" no Worker ainda comentado (TODO, não-crítico)

Componentes

• WF-Oferta-Launcher — disparo manual, cria a fila de atividades no Pipedrive.
• WF-Oferta-Dispatcher — crons 8h+14h, verifica se há ofertas pendentes e aciona o Worker.
• WF-Oferta-Worker — processa 1 lead por vez, gera a mensagem por IA, envia email/WhatsApp, self-trigger com wait aleatório 5–15 min.

Fluxo nó-por-nó em arquitetura.md; IDs/credenciais em referencia-tecnica.md.

Decisões arquiteturais importantes

1. Pipedrive como fila (não PostgreSQL). Atividades servem de task queue — mais simples, sem banco extra. Cada lead ganha uma atividade oferta_email, oferta_whatsapp ou oferta_emailwhatsapp.
2. IA só no Worker, nunca no Launcher. O Launcher só cria a fila; a mensagem personalizada é gerada no momento do envio para usar o contexto mais fresco do lead.
3. Self-trigger com wait aleatório 5–15 min. Cadência mais humana e imprevisível; para automaticamente fora do horário comercial (8–12 + 14–18 BRT, seg-sex).
4. Round-robin de inboxes WhatsApp (pool [64, 61] no Chatwoot) para distribuir carga.
5. Guard de horário dupla (Dispatcher + Worker).
6. SES com raw body (workaround obrigatório do n8n — nunca node nativo awsSes nem contentType: form-urlencoded).
7. Unsubscribe reaproveitado do Conteúdo Infinito (WF4 — Opt-out Email), link no rodapé de cada email.

Como operar no dia a dia

Lançar uma campanha

1. Criar filtro no Pipedrive com os leads que devem receber a oferta.
2. Abrir o WF-Oferta-Launcher no n8n e editar o nó Config: filter_id, campaign_name, tipo_atividade (oferta_email | oferta_whatsapp | oferta_emailwhatsapp).
3. Executar manualmente (Test Workflow) e verificar o resumo (quantas atividades criadas / leads pulados).
4. Ativar Dispatcher e Worker. Os envios começam no próximo horário comercial (8h ou 14h).

Monitorar

• Dispatcher roda 2x/dia (8h e 14h, seg-sex) — execução rápida (<5s), só verifica pendências.
• Worker roda N vezes/dia (1 lead por execução, ~30–60s) e se re-dispara se houver mais; para automaticamente fora do horário.
• Atividades no Pipedrive são marcadas "done" conforme processadas.

Parar / finalizar

• Desativar Dispatcher e Worker no n8n. Atividades pendentes ficam no Pipedrive até reativar; para cancelar definitivamente, deletar as atividades pendentes.

Índice da subpasta

Documento	Conteúdo
README.md (este)	Visão executiva, status, decisões-chave, como operar
arquitetura.md	Fluxo nó-por-nó dos 3 workflows, self-trigger, design patterns
referencia-tecnica.md	IDs, credenciais (nomes), field keys, activity types, webhook URLs, dados de teste, E2E
ARQUIVOS.md	Manifesto de anexos e pesquisas one-off relacionadas

Skills relacionadas

n8n · n8n-bepex · n8n-bepex-pipedrive · amazon-ses-bepex · whatsapp-bepex.