Chatwoot Captain: IA nativa, OpenRouter, Companies e 2FA

O Chatwoot Captain é o agente de IA nativo do Chatwoot. Com ele você monta um assistente que atende a caixa de entrada, consulta uma base de conhecimento e transfere para um humano quando precisa, sem depender do n8n para o básico. A cada versão ele ganha recursos, e boa parte do que antes exigia automação externa já cabe dentro dele.

No vídeo, gravado em novembro de 2025 com o Chatwoot 4.8.0 recém-lançado, eu passei pelas novidades que mais importam no dia a dia: o Captain com documentos, cenários, ferramentas de API, proteções e diretrizes; a possibilidade de usar outro provedor de IA além da OpenAI; o módulo Companies; o 2FA; e os novos ajustes de anexos e webhook. Aqui organizo tudo isso com o que observar antes de ativar.

Captain e a camada Enterprise do Chatwoot

O Chatwoot é open source, mas tem uma camada Enterprise. No vídeo, o Captain e o Companies aparecem como recursos dessa camada: numa instalação própria comum, eles não aparecem no menu. Antes de planejar o atendimento em cima deles, confira os planos no site oficial do Chatwoot.

Para acompanhar o que muda em cada versão, a fonte é a página de releases do Chatwoot no GitHub. Vale ler antes de atualizar, porque muitas atualizações também corrigem falhas de segurança.

Como funciona o Chatwoot Captain

O fluxo básico:

1. crie um assistente nas configurações do Captain;
2. conecte uma ou mais caixas de entrada a ele;
3. a partir daí, toda conversa nova nessa caixa é atendida primeiro pelo assistente.

Vale para qualquer tipo de caixa: WhatsApp, e-mail, Facebook, Instagram, Telegram.

Um detalhe confunde muita gente: quando o Captain está ligado na caixa, os tickets entram como pendentes. Parece que as conversas sumiram, mas é só o filtro. Mude o filtro para pendentes e você vê o que está com a IA. Quando você abre o ticket, o Captain para de interferir, porque ele só atua nos pendentes. Quando ele percebe que o cliente precisa de um humano, ele mesmo abre o ticket.

Base de conhecimento, cenários e playground

FAQs e documentos. A base de conhecimento é o que a IA consulta para responder: produtos, preços, endereço, horários. Você cadastra perguntas e respostas à mão ou sobe documentos. Antes só dava por URL. No vídeo já era possível subir PDF direto, com limite de 10 MB por arquivo. O Chatwoot processa o documento e cadastra o conteúdo na base.

Cenários. Servem para direcionar a conversa num caso específico. Exemplo: consulta de CPF, com os dados que o bot precisa pedir antes de seguir.

Playground. Você conversa com o assistente direto na tela, sem precisar testar pelo WhatsApp em produção. Acelera muito o ajuste do comportamento.

Ferramentas: o Captain chamando a sua API

As ferramentas foram a novidade que mais me chamou atenção. Antes, para o bot consultar um sistema externo, o caminho era o n8n. Agora o Captain tem ferramentas personalizadas: você configura uma requisição com URL, autenticação, parâmetros e resposta, e cita a ferramenta no prompt.

Exemplos de uso:

• coletar o CPF e consultar um serviço de crédito;
• buscar o status de um pedido pelo número;
• chamar um fluxo seu no n8n.

Na época da gravação, as ferramentas aceitavam GET e POST. Já dá para fazer bastante coisa com os dois.

Prompt dividido: diretrizes, proteções e cenários

No n8n, a gente costuma colocar tudo num prompt só, muitas vezes em YAML ou XML. O Chatwoot separou isso em partes, o que ajuda quem não sabe estruturar prompt:

Um aviso: o campo de descrição do assistente não é o prompt. Ele serve só para identificar o assistente na lista.

IA externa: OpenRouter no lugar da OpenAI

A chave de IA do Captain é configurada no super admin e vale para todas as empresas da instalação. Até então, o Captain ficava preso à OpenAI. Nas versões que eu mostro no vídeo, apareceu o campo para trocar a URL do endpoint. Isso permite usar qualquer provedor compatível com a API da OpenAI.

O exemplo do vídeo é o OpenRouter, que faz o roteamento para vários modelos, pagos e gratuitos:

1. crie uma conta no OpenRouter e gere uma chave de API;
2. no super admin do Chatwoot, na área do Captain, cole a chave;
3. informe a URL do endpoint (https://openrouter.ai/api/v1);
4. escreva o nome do modelo;
5. teste no playground.

Na gravação, o modelo Grok 4.1 Fast estava gratuito no OpenRouter e funcionou bem com o Captain. Disponibilidade e preço de modelo mudam com frequência, então confira na hora. Deixando o campo vazio, o Captain usa a OpenAI normalmente. E atenção: o provedor precisa seguir o mesmo padrão de API da OpenAI, e nem todos seguem.

Para quem revende, existe ainda o limite por conta: no super admin você define quantas respostas e quantos documentos cada empresa pode usar a cada 30 dias. Assim você cobra conforme o consumo e não estoura a sua chave.

Companies, 2FA, anexos e webhook

Companies. Agrupa contatos por empresa, útil para atendimento B2B, em que você fala com várias pessoas do mesmo cliente. Não tem relação com as contas da revenda. No vídeo o recurso ainda estava em construção: eu cadastrei as empresas pelo banco de dados porque não havia botão para criar.

2FA. A autenticação em dois fatores foi liberada numa versão anterior (no vídeo eu cito a 4.6). No self-hosted, você adiciona três variáveis de criptografia na stack, tanto no serviço web quanto no Sidekiq, com a indentação certa. Os nomes estão no .env.example oficial do Chatwoot. Gere três chaves aleatórias, atualize a stack e cada usuário ativa o 2FA no próprio perfil, lendo o QR code num app como o Google Authenticator. Guarde os códigos de recuperação.

Webhook. No super admin, em configurações gerais, agora dá para ajustar o tempo limite do webhook. Isso resolve o caso clássico de mensagem que chega no cliente mas aparece com erro no Chatwoot, porque a Evolution ou outra API demorou mais que o limite para confirmar.

Anexos. O limite de tamanho, que era de 40 MB e só mudava no código, passou a ser configurável no super admin.

O lado honesto dos anexos grandes

Poder liberar até 2 GB não quer dizer que vai chegar. Com API não oficial, a sessão do WhatsApp Web dá timeout, e até 40 MB às vezes já falhava. Com a API oficial a chance é maior, mas também não é garantia.

Minha recomendação, depois de anos mexendo nisso: mantenha entre 40 e 80 MB. Se o seu cliente tenta mandar um arquivo grande e falha, a culpa cai em você. Arquivo maior que isso vai melhor como link do Google Drive, que inclusive fica mais profissional. Se você usa WAHA ou Evolution, leia também o artigo sobre Evolution Go com Chatwoot.

Perguntas frequentes

O que é o Chatwoot Captain?

É o agente de IA nativo do Chatwoot. Ele atende as caixas de entrada conectadas, consulta uma base de conhecimento e transfere para um humano quando precisa, em canais como WhatsApp, e-mail, Facebook, Instagram e Telegram.

O Captain aparece no Chatwoot instalado no próprio servidor?

Não numa instalação própria comum. O Captain e o Companies fazem parte da camada Enterprise do Chatwoot, então confira os planos no site oficial antes de planejar o atendimento em cima deles.

Dá para usar o Captain com outra IA além da OpenAI?

Sim. No super admin dá para trocar a URL do endpoint e usar qualquer provedor compatível com a API da OpenAI, como o OpenRouter. Com o campo vazio, o Captain usa a OpenAI normalmente.

Por que as conversas somem quando ligo o Captain?

Elas não somem: com o Captain ligado na caixa, os tickets entram como pendentes. Mude o filtro para pendentes para ver o que está com a IA.

Como ativar o 2FA no Chatwoot self-hosted?

Adicione três variáveis de criptografia na stack, no serviço web e no Sidekiq, com chaves aleatórias, e atualize a stack. Depois, cada usuário ativa o 2FA no próprio perfil lendo o QR code num app como o Google Authenticator.

Captain, flows e Kanban no mesmo lugar

O Captain cobre bem o atendimento com IA dentro do Chatwoot. Se você quer somar a isso Kanban, flows visuais, disparador, chat interno, ligações pelo WhatsApp e white label, o AstraChat é o Chatwoot Pro da Astra Online, no seu servidor, sem cobrança por atendente. O construtor visual de bots que eu desenvolvi está explicado no artigo sobre o FlowBuilder no Chatwoot.

Ele vem na Comunidade Astra Online, com código-fonte, atualizações, grupo VIP e a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Chame no WhatsApp e me diga qual atendimento você quer colocar na mão da IA primeiro.