Como habilitar o Captain em instalações auto-hospedadas?

O Captain é um assistente de IA que ajuda você a responder mais rápido e com maior precisão. Com o Bring Your Own Key (BYOK), você pode usar sua própria chave de API da OpenAI ou de qualquer serviço de IA compatível. Você controla os dados, os custos e qual modelo é utilizado. Em uma instalação auto-hospedada, o Captain só envia dados para o modelo de IA que você escolher.

Este guia vai mostrar como habilitar o Captain na sua Enterprise Edition auto-hospedada, adicionar sua chave de API e configurar um modelo personalizado, se desejar.

Pré-requisitos

Antes de começar, certifique-se de que você possui:

• Chatwoot Enterprise Edition com um plano pago.

• Acesso de administrador ao Super Admin Console.

• Uma chave de API OpenAI válida.

• (Opcional) Um endpoint de API compatível com OpenAI auto-hospedado.

• (Opcional) Uma chave de API Firecrawl para uma melhor varredura de documentação.

Habilitando o Captain no Super Admin Console

Para habilitar o Captain no nível da instalação:

Faça login no Super Admin Console. Navegue até Configurações → Captain.

Preencha os campos de configuração:

1. Chave de API OpenAI (Obrigatório) – A chave para autenticar solicitações para a OpenAI ou serviço compatível.

2. Modelo OpenAI (Obrigatório) – O padrão é gpt-4o-mini. Você pode escolher outro modelo suportado como gpt-5.

3. Endpoint de API OpenAI (Opcional) – Insira seu endpoint de API personalizado caso esteja usando um modelo auto-hospedado.

4. Chave de API Firecrawl (Opcional) – Recomendado para melhor varredura de sites e documentação.

   Clique em Enviar para salvar sua configuração.

Habilitando o Captain para uma Conta

Depois de habilitar o Captain globalmente, ative-o para contas individuais:

1. No Super Admin Console, acesse Contas.

2. Selecione a conta para a qual deseja habilitar o Captain e clique em Editar.

3. Na seção Recursos Premium, ative o Captain.

4. Salve as alterações.

Solução de problemas

Se o Captain não estiver respondendo conforme o esperado:

• Verifique se a chave de API OpenAI está correta e ativa.

• Confira se o nome do modelo corresponde a um modelo suportado.

• Certifique-se de que sua chave de API Firecrawl é válida caso esteja utilizando a varredura.

• Confirme que o Captain está ativado tanto no nível da instalação quanto da conta.

Se o Captain ainda não estiver respondendo, revise os logs do servidor Chatwoot tanto dos processos web quanto do worker para identificar quaisquer erros e compartilhe esses detalhes de erro com a equipe de suporte para uma assistência adicional.