IA Chatwoot Bepex¶

Chatbots de IA integrados ao Chatwoot da Bepex via n8n + LangChain + OpenRouter. Um roteador central recebe todos os webhooks do Chatwoot e direciona cada mensagem para o workflow de IA correto conforme a inbox.

Visão executiva¶

Sistema de atendimento automatizado por IA que responde mensagens de clientes e prospects no Chatwoot da Bepex (chat.bepex.com.br, account 2). Arquitetura modular:

IA ROUTER V2 — roteador central; recebe os webhooks do Chatwoot e encaminha para o workflow certo
IA losand — chatbot multi-site (Losand, Chapas Expandidas, Chapas Perfuradas) com handoff para atendente
IA Prospecção — chatbot comercial para prospecção de representantes (inboxes 62/63/64)
IA Atendimento Arquitetos — clone da IA Prospecção adaptado ao atendimento de arquitetos (INATIVO)
Sub-workflows compartilhados — debounce e split de mensagens

Fluxo de uma mensagem¶

WhatsApp/Web → Chatwoot → Webhook POST /v2/router
                              ↓
                        IA ROUTER V2 (iT5a8VV2vPF6ZpYL)
                              ↓
                    Switch por inbox_id / ia_responsavel
                       ↓              ↓              ↓
                  IA losand      IA Prospecção    DIFY DEV (legado)
                       ↓              ↓
                  AI Agents      AI Agent único
                  (3 prompts)    (prompt comercial)
                       ↓              ↓
               split msg Chatwoot (resposta fatiada)

Status dos workflows¶

Workflow	ID	Status	Inboxes
IA ROUTER V2	`iT5a8VV2vPF6ZpYL`	ATIVO	Todas (roteador)
IA losand	`DiOL7QWomFFc9LY8`	ATIVO	41, 59, 60
IA Prospecção	`4wLT4ni6udXSnVS9`	ATIVO	62, 63, 64
IA Atendimento Arquitetos	`OC6so0JJTp5YseW7`	INATIVO (aguarda chips + validação)	70, 71, 72 (placeholders)

Índice da subpasta¶

Documento	Conteúdo
`README.md` (este)	Visão executiva, fluxo, status dos workflows
`arquitetura.md`	Fluxo nó-por-nó de ROUTER, IA losand, IA Prospecção; padrões de design (debounce, label-lock, split, Convert Types, ativação por tag)
`referencia-tecnica.md`	IDs, webhook URLs, credentials, nodes, sub-workflows, inboxes, labels, tabelas Postgres, automações Chatwoot
`historico.md`	Cronologia: criação da IA Prospecção, os 3 bugs do pipeline (05/23), clone Arquitetos (06/30)

Dependências¶

Chatwoot: chat.bepex.com.br (account 2) — SEM MCP (operação via API direta ou browser)
n8n: n8n.bepex.com.br / n8n-hook.bepex.com.br (webhooks)
OpenRouter: modelo de LLM (via credential n8n)
PostgreSQL: memória de chat (n8n_chat_histories / n8n_chat_histories_prospeccao / n8n_chat_histories_arquitetos)
Sub-workflow debounce: VahE4IePbduQNU9t
Sub-workflow split msg: Drj76ljZtSPIXj2x
Error workflow: GEyXmIklTx6i3QBC

Segredos: os paths de webhook dos workflows de IA são UUIDs que disparam execução — nos docs migrados aparecem como placeholders (${WEBHOOK_IA_LOSAND_UUID}, ${WEBHOOK_IA_PROSPECCAO_UUID}, ${WEBHOOK_DIFY_LEGADO_UUID}, ${WEBHOOK_ARQ_ATENDIMENTO_UUID}). Valores reais no arquivo restrito de segredos (ver de-para da migração).