Comment activer Captain sur les installations auto-hébergées ?

Captain est un assistant IA qui vous aide à répondre plus rapidement et avec plus de précision. Avec Bring Your Own Key (BYOK), vous pouvez utiliser votre propre clé API provenant d’OpenAI ou de tout service IA compatible. Vous contrôlez les données, les coûts et le modèle utilisé. En configuration auto-hébergée, Captain envoie les données uniquement au modèle IA de votre choix.

Ce guide vous montrera comment activer Captain dans votre édition Enterprise auto-hébergée, ajouter votre clé API et configurer un modèle personnalisé si vous le souhaitez.

Prérequis

Avant de commencer, assurez-vous d’avoir :

• Chatwoot Enterprise Edition avec un forfait payant.

• Un accès administrateur à la Console Super Admin.

• Une clé API OpenAI valide.

• (Optionnel) Un endpoint API compatible OpenAI auto-hébergé.

• (Optionnel) Une clé API Firecrawl pour une exploration documentaire améliorée.

Activer Captain dans la Console Super Admin

Pour activer Captain au niveau de l’installation :

Connectez-vous à la Console Super Admin. Allez dans Paramètres → Captain.

Remplissez les champs de configuration :

1. Clé API OpenAI (Obligatoire) – La clé permettant d’authentifier les requêtes vers OpenAI ou un service compatible.

2. Modèle OpenAI (Obligatoire) – Par défaut : gpt-4o-mini. Vous pouvez choisir un autre modèle supporté comme gpt-5.

3. Endpoint API OpenAI (Optionnel) – Saisissez votre endpoint API personnalisé si vous utilisez un modèle auto-hébergé.

4. Clé API Firecrawl (Optionnel) – Recommandé pour optimiser l’exploration de sites web et de documentation.

   Cliquez sur Valider pour enregistrer la configuration.

Activer Captain pour un compte

Après avoir activé Captain globalement, activez-le pour les comptes individuels :

1. Dans la Console Super Admin, allez dans Comptes.

2. Sélectionnez le compte pour lequel vous souhaitez activer Captain et cliquez sur Modifier.

3. Dans la section Fonctionnalités Premium, activez Captain.

4. Enregistrez les modifications.

Dépannage

Si Captain ne répond pas comme prévu :

• Vérifiez que la clé API OpenAI est correcte et active.

• Assurez-vous que le nom du modèle correspond à un modèle pris en charge.

• Vérifiez que votre clé API Firecrawl est valide si vous utilisez l’exploration.

• Confirmez que Captain est activé à la fois au niveau de l’installation et du compte.

Si Captain ne répond toujours pas, consultez les journaux serveur de Chatwoot pour les processus web et worker afin d’identifier d’éventuelles erreurs, puis partagez les détails avec l’équipe support pour une assistance complémentaire.