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. Usarfetchde dentro da UI com headerbrowser-id. Nunca bater em/rest/loginou/rest/me. Detalhes emn8n-bepex.md. - Make: antes de alterar
{{N.campo}}num blueprint, inspecionar a última execução real (History). HTTP module tem dois campos (bodyedata) — setar ambos. Detalhes emmake-bepex.md. - SES: no n8n, nunca usar o node nativo
awsSesnemform-urlencodedcom AWS auth (double-encode do@). UsarcontentType: raw+encodeURIComponentmanual. Detalhes emamazon-ses.md. - Segredos: ver
credenciais.md. Zero valores reais no repo.