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**](https://www.firecrawl.dev/) 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**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTmNKL1FFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a3ab35644fcf7dc2bd5efc131fbe219e1305ca31/Screenshot%202025-08-15%20at%2011.51.50%E2%80%AFAM.png)

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ3NLL1FFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8a4b8f28eaaa80f8fae85881aa9345ea1e8cb8c4/Screenshot%202025-08-15%20at%2011.50.26%E2%80%AFAM.png)

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.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQjRLL1FFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--df5095b551827cac323bd59ce90b30b932a5b50a/Screenshot%202025-08-15%20at%2011.52.31%E2%80%AFAM.png)

## 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.