Pular para conteúdo

Stack — visão geral do backbone Bepex

Mapa da fundação técnica sobre a qual todas as automações comerciais da Bepex rodam. Detalhes de cada componente ficam no doc dedicado (ver README.md). Aqui é a foto de conjunto.

As peças

Componente Papel Onde roda Doc
n8n (self-hosted) Motor de automação — quase toda a lógica vive aqui n8n.bepex.com.br (SQLite, processo único) n8n-bepex.md
Make.com Ponte de disparo WhatsApp (cenários Disparador Vendas) Org 115055, região US1 make-bepex.md
Pipedrive CRM — fonte/fila de leads e atividades SaaS (bepex.pipedrive.com) referência de campos: skill n8n-bepex-pipedrive
Chatwoot Camada de mensageria (WhatsApp + email) 2 superfícies (ver doc) chatwoot.md
Amazon SES Envio de email em volume (nutrição, prospecção, marketing) AWS us-east-2 amazon-ses.md
PostgreSQL Banco das automações (pool_conteudos, representantes, arquitetos, memória de agentes) credencial n8n Postgres n8n v2 ver n8n-bepex.md
Redis Cache/fila auxiliar do stack de automação
Open WebUI Casca de chat dos agentes (padrão Betão) — inteligência fica no n8n EasyPanel self-hosted open-webui-betao.md
OpenRouter Gateway de LLM de todos os agentes/IA conta rafael@bepex.com.br openrouter.md

Como as peças se conectam

O padrão dominante é Pipedrive como fila → n8n orquestra → Make/SES/Chatwoot entregam. Exemplo canônico (nutrição "Conteúdo Infinito"):

Pipedrive (atividades de nutrição pendentes)
   │
   ▼
n8n WF1 (motor de IA) ──► escolhe conteúdo, monta mensagem
   │
   ▼
n8n WF2 (fila de disparo)
   ├─ canal = WhatsApp ─► Make webhook (Disparador Vendas 1-6) ─► Chatwoot ─► WhatsApp
   │                                                                  │
   │                                                    callback ◄────┘
   └─ canal = Email ────► Amazon SES ─► caixa do lead
   │
   ▼
n8n WF3 (cadência) ◄── callback do Make/SES ── agenda próxima atividade no Pipedrive

Variações do mesmo esqueleto aparecem em Ofertas, Rede de Representantes (base PostgreSQL em vez de Pipedrive), Prospecção de Arquitetos, Caramelo e IA Chatwoot. Os agentes conversacionais (Betão, Kowalski, Bê, Sobe Obras) trocam o gatilho Pipedrive por um chat via Open WebUI → webhook n8n, mas a inteligência continua no n8n + OpenRouter + memória PostgreSQL.

Ambientes e domínios

Domínio Serve
n8n.bepex.com.br Interface/API REST da instância n8n
n8n-hook.bepex.com.br Webhooks de produção do n8n
chat.bepex.com.br Chatwoot Bepex (account 2) — inboxes de prospecção/IA/comercial
atendimento.agencialacos.com.br Chatwoot white-label CWMKT — hospeda o WhatsApp comercial/pessoal (account 3)
us1.make.com/115055 Org Make da Bepex
us-east-2.console.aws.amazon.com/ses Amazon SES
n8n-openwebui.fetrtm.easypanel.host Open WebUI (padrão Betão)
bepex.com.br / bepexmkt.com.br Domínios de email (corporativo / marketing)

Hospedagem física

  • Digital Ocean (conta rafael@bepex.com.br) — droplets que rodam o n8n e serviços de apoio.
  • AWS Lightsail (us-east-2) — serviços de apoio adicionais; o SES em si é quase gratuito.
  • EasyPanel — hospeda o Open WebUI (v0.10.1).
  • CWMKT — fornecedor do Chatwoot white-label (fork, cobrado em BRL fixo).

Custo consolidado por serviço em custos.md.

Regras operacionais críticas (herdadas da prática)

  • n8n: nunca navegar (page load) para endpoints /rest/* — mata a sessão. Usar fetch de dentro da UI com header browser-id. Nunca bater em /rest/login ou /rest/me. Detalhes em n8n-bepex.md.
  • Make: antes de alterar {{N.campo}} num blueprint, inspecionar a última execução real (History). HTTP module tem dois campos (body e data) — setar ambos. Detalhes em make-bepex.md.
  • SES: no n8n, nunca usar o node nativo awsSes nem form-urlencoded com AWS auth (double-encode do @). Usar contentType: raw + encodeURIComponent manual. Detalhes em amazon-ses.md.
  • Segredos: ver credenciais.md. Zero valores reais no repo.