Chatwoot — mensageria da Bepex¶
Camada de mensageria (WhatsApp + email) do stack. As automações da Bepex tocam duas superfícies Chatwoot diferentes — é a fonte de confusão mais comum, então começa por aí.
As duas superfícies (importante)¶
| Superfície | URL | Papel na Bepex | account_id |
|---|---|---|---|
| Chatwoot Bepex | chat.bepex.com.br |
Inboxes de prospecção, IA e comercial (WhatsApp via bridge de API) | 2 |
| Chatwoot white-label (CWMKT) | atendimento.agencialacos.com.br |
Hospeda o WhatsApp comercial e pessoal do operador (contas multi-empresa) | 3 = "Rafa Pessoal" |
⚠️ O WhatsApp comercial da Bepex vive na conta 3 / inbox 26 do Chatwoot white-label (
atendimento.agencialacos.com.br), não nochat.bepex.com.br. Nunca usarchat.bepex.com.brpara operar o WhatsApp comercial Bepex. Ver skillwhatsapp-bepex.Já o
chat.bepex.com.br(account 2) é onde ficam os inboxes de prospecção (62/63/64), IA (losand 41/59/60, prospecção 62/63/64), pré-vendas (61) e o WhatsApp Bepex comercial dos disparadores (inbox 27, usado pelos cenários Make). São instâncias separadas com bancos separados.
Inboxes conhecidos¶
chat.bepex.com.br (account 2)¶
| inbox_id | Canal | Uso |
|---|---|---|
| 27 | WhatsApp (API) | Disparador Vendas (Make) — nutrição/comercial |
| 41 / 59 / 60 | IA losand | |
| 61 | Pré-vendas frio (Caramelo) | |
| 62 / 63 / 64 | WhatsApp (API) | Prospecção (Representantes / IA Prospecção) — sender slots A/B/C |
Inboxes 62/63 são
Channel::Apie não propagam delivery receipts — o consumidor vê HTTP 200 mesmo sem entrega. Limitação estrutural do stack (ver projeto Rede de Representantes).
atendimento.agencialacos.com.br (account 3 = "Rafa Pessoal")¶
| inbox_id | Canal | Uso |
|---|---|---|
| 25 | Rafa Pessoal | |
| 26 | WhatsApp Bepex comercial (conv 56 = Enríco, conv 23 = Pedro/Bê, etc.) |
Credencial de API (n8n)¶
| Nome no n8n | ID | Uso |
|---|---|---|
| Chatwoot Bepex (Header Auth) | FzLnFD8cohSYSYIN |
API do chat.bepex.com.br account 2 (usada por Caramelo, Reps, IA Chatwoot) |
O token de API do Chatwoot (
chat.bepex.com.br) e o inbox_identifier do WhatsApp Bepex são segredos → vercredenciais.md(${CHATWOOT_BEPEX_API_TOKEN},${CHATWOOT_INBOX_IDENTIFIER_WHATS_BEPEX}). O token de API do Chatwoot white-label (atendimento.agencialacos.com.br) é credencial cross-empresa (Laços) e não pertence a este repo — fica fora do escopo Bepex.
Padrões de operação via API¶
- Estar no domínio antes de chamadas relativas (CORS bloqueia de outros domínios): navegar para a URL do Chatwoot primeiro.
- Assíncrono no
javascript_tool:awaitnão funciona — usar.then()+window._vare ler na chamada seguinte. - Labels antes de automações: criar a label ANTES da regra de automação que a referencia; senão a regra não associa (fazer PUT depois para forçar re-associação).
- Paginação:
page=2às vezes repete os dados — buscar tudo empage=1quando possível. - Busca de contato é accent-sensitive — buscar por nome com acento falha; usar telefone como fallback.
- Resolver em lote:
atualizar_status_conversausa POST/toggle_status(resolve/reabre/snooze).
MCP Chatwoot¶
Existe um MCP Chatwoot histórico apontando para a instância Laços (operações da agência). Para a
Bepex, o MCP Chatwoot Bepex foi criado (workflow n8n nWE1aU08WJX0OG3X, chat.bepex.com.br
account 2), expondo as ferramentas listar_conversas, buscar_mensagens, enviar_mensagem,
atualizar_status_conversa, adicionar_label, listar_inboxes, listar_labels, buscar_contato.
O projeto (blueprint importável) e as instruções de instalação/conexão moram em
mcp-servers/. Construído em 2026-07-14 a partir do conhecimento documentado (a
conferir contra o blueprint original da Laços). Ver skill chatwoot-setup para automações/labels/super-admin.
Plataforma¶
O atendimento.agencialacos.com.br roda um fork white-label CWMKT (Chatwoot v4.13.0.1) com
feature flags extras (enabled_features_wootmate[...]: ASAAS, Kanban CRM, N8N, Typebot, Wavoip,
WhatsApp Group Messaging, etc.). Suporte do fork via grupo WhatsApp "Agencialacos White Label". Custo
do white-label em custos.md.
⚠️ Conceder acesso de usuário a uma conta (Super Admin → Account Users) é ação de controle de permissões — não executar automaticamente, nem via subagente. Preparar a tela e levantar IDs; quem clica em "Create Account user" é o operador humano.