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

O Captain é um assistente de IA que ajuda você a responder com mais rapidez e precisão. Com o recurso "Traga sua própria chave" (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 será usado. Em uma configuração auto-hospedada, o Captain envia dados apenas para o modelo de IA que você escolher.

Este guia mostrará como habilitar o Captain em 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ê tem:

• Chatwoot Enterprise Edition  com um plano pago.

• Acesso administrativo ao  Console do Super Administrador .

• Uma chave de API OpenAI válida  .

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

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

Habilitando o Capitão no Console do Super Administrador

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

Faça login no  Console do Super Administrador . Navegue até  Configurações → Capitão .

Preencha os campos de configuração:

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

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

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

4. Chave da API do Firecrawl (opcional)  – Recomendada para melhor rastreamento de sites e documentação.

   Clique em  Enviar  para salvar sua configuração.

Habilitando o Capitão para uma Conta

Após habilitar o Capitão globalmente, ative-o para contas individuais:

1. No  Console do Superadministrador , acesse  Contas .

2. Selecione a conta para a qual deseja ativar o recurso Capitão e clique em  Editar .

3. Na  seção Recursos Premium  , ative a opção  Capitão  .

4. Salve as alterações.

Solução de problemas

Se o capitão não responder como esperado:

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

• Verifique se o  nome do modelo  corresponde a um modelo compatível.

• Certifique-se de que sua  chave de API do Firecrawl  seja válida se estiver usando o recurso de rastreamento.

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

Se o Capitão ainda não estiver respondendo, revise os registros do servidor Chatwoot, tanto dos processos web quanto dos processos de trabalho, para identificar quaisquer erros e compartilhe os detalhes desses erros com a equipe de suporte para obter mais assistência.