IA no Chatwoot auto-hospedado: opções e configuração

Escolha a opção de IA

Na consulta de 16 de outubro de 2026, a página oficial de planos auto-hospedados lista Captain em Premium Support e Enterprise, não na Community Edition. Consulte os termos atuais antes de decidir.

• Captain: avalie a IA nativa, seu plano e as condições de tratamento de dados.
• Serviço externo: conecte um Agent Bot ao GPT KeFu e mantenha sua caixa de entrada. A IA continua externa; não é uma instalação totalmente local.
• Agent Bot próprio: implemente a lógica ou conecte um fluxo de automação. Você mantém o bot, as fontes de conhecimento e as regras de atendimento humano.

• Planos oficiais do Chatwoot auto-hospedado
• Guia oficial de Agent Bots

1. Reúna os dados da instância e da caixa de entrada

Crie um projeto Chatwoot no GPT KeFu. Abra as configurações da caixa de entrada no Chatwoot e copie a URL do navegador. O formulário pode extrair a URL base, Account ID e Inbox ID, ou você pode preenchê-los manualmente.

A URL base é a origem HTTPS sem /app. Account ID aparece após /app/accounts/ e Inbox ID após /settings/inboxes/. Em Profile Settings, copie o Access Token pessoal de um administrador, não o Bot Access Token.

2. Crie o bot e salve o segredo de assinatura

Em Settings → Bots, crie ou edite um Agent Bot e copie o Webhook Secret. Ele assina callbacks e não é o token de API. Cole-o no campo de assinatura do Agent Bot no GPT KeFu.

Se o bot exigir uma URL antes de salvar a conexão, use temporariamente uma URL HTTPS pública sob seu controle, sem vincular a caixa de entrada. Copie o segredo e salve a conexão no GPT KeFu para obter a URL definitiva. Isso ainda não ativa respostas.

3. Configure o callback definitivo

Substitua a URL temporária pela URL de webhook do Agent Bot exibida no GPT KeFu. Vincule o bot em Bot Configuration da caixa de entrada correta e salve.

Use o segredo desse mesmo bot. Deixe o webhook opcional de conta desativado nesta configuração: o Agent Bot já informa mudanças de status. O webhook de conta, se necessário depois, usa URL e segredo próprios.

4. Valide os dois sentidos e ative a IA

1. Execute Check connection para verificar acesso à API com as credenciais salvas.
2. Envie uma nova mensagem como visitante à caixa vinculada. Confira se um callback assinado foi validado; execute a verificação novamente, se necessário.
3. Após validar API e callback, ative as respostas de IA.
4. Envie outra mensagem nova e confira a resposta no Chatwoot. A mensagem usada para validar o callback não recebe resposta retroativa automática.

Identifique a etapa que falhou

• Falha de API: confira origem HTTPS, token de administrador, Account ID, Inbox ID e bloqueios de proxy ou firewall.
• Callback pendente: confira a vinculação do bot e a URL definitiva. Envie uma mensagem de visitante, não de atendente.
• Assinatura inválida: copie o Webhook Secret do mesmo Agent Bot e confirme suporte a callbacks assinados. Não desative a verificação de assinatura.
• Conexão válida sem resposta: confira ativação da IA, recursos do plano, modelo e eventual pausa após atendimento humano.