Captain

Commencez avec Captain AI

Captain est l’IA de Chatwoot. Il peut répondre à vos clients, aider vos agents à rédiger des réponses, et apprendre à partir de vos documents d’aide et de conversations passées. Ce que Captain peut faire Fonctionnalité Ce qu’il fait Qui l’utilise Page Assistant Répond aux clients dans les boîtes de réception que vous connectez, et transfère à votre équipe lorsqu’il ne peut pas aider Clients Configurer un assistant Captain et connecter vos boîtes de réception Connaissances Apprend à partir de pages web, PDF et FAQ que vous ajoutez Administrateurs Ajouter des documents aux connaissances de Captain Limites, consignes et scénarios Contrôle ce que l’assistant répond, la manière dont il répond, et ce qu’il fait dans des situations précises Administrateurs Définir les limites, consignes et scénarios de Captain Audience et planification Limite les clients auxquels l’assistant répond, et quand il le fait Administrateurs Contrôler à qui Captain répond et quand Outils personnalisés Permet à l’assistant de consulter vos propres systèmes, comme le statut d’une commande Administrateurs Configurer des outils personnalisés pour Captain Copilot Aide les agents à résumer, rédiger des réponses et rechercher des informations pendant leur travail Agents Travaillez plus rapidement avec Captain Copilot Mémoires Sauvegarde les informations clés sur les clients en tant que notes de contact pour la prochaine fois Assistant Utiliser les Mémoires de Captain Aide IA dans l’éditeur et la boîte Reformule, résume et suggère des réponses dans l’éditeur, transcription audio, et Suggérer avec Captain pour les étiquettes et priorités d’une conversation Agents ; admins les activent Conditions Captain dans l’automatisme Une règle d’automatisation peut demander à Captain si une conversation correspond à une description, par exemple « le client veut annuler » Administrateurs Plan & accès Offre Captain Hacker (gratuit) Non inclus Startups Inclus, avec crédits IA mensuels Business Inclus, avec plus de crédits IA mensuels. Ajoute des outils personnalisés Enterprise Inclus, avec le plus de crédits IA mensuels - Les montants de crédits par offre et le prix d’appoint sont disponibles sur Tarifs & Offres > Crédits Captain AI. Comment les crédits sont utilisés est expliqué sur Crédits et utilisation Captain AI. - Rôle : seuls les administrateurs peuvent créer ou modifier assistants, documents, FAQ et outils. Les agents peuvent consulter les assistants, les essayer dans le Playground, examiner les suggestions de FAQ et utiliser Copilot. - Auto-hébergé : Captain est inclus dans les offres Premium et Enterprise auto-hébergées, avec votre propre clé OpenAI. Voir Activer Captain sur auto-hébergé. - Essai gratuit : Captain n’est pas disponible pendant l’essai gratuit. Comment vérifier si vous l’avez Cherchez Captain dans la barre latérale de gauche. Si vous cliquez dessus et voyez Mettre à niveau pour utiliser Captain AI, votre compte est sur l’offre Hacker. Un administrateur peut effectuer la mise à niveau depuis Facturation. Configuration & essai L’ordre habituel : 1. Configurer un assistant Captain et connecter vos boîtes de réception, puis le tester dans le Playground. 2. Ajouter des documents aux connaissances de Captain pour qu’il connaisse votre produit. 3. Optionnel : Contrôler à qui Captain répond et quand, Définir les limites, consignes et scénarios de Captain, Configurer des outils personnalisés pour Captain. Les administrateurs auto-hébergés commencent par Activer Captain sur auto-hébergé. Maximiser la valeur - Maintenez les connaissances à jour : examinez les suggestions de FAQ chaque semaine. Voir Ajouter des FAQ et examiner les suggestions de FAQ dans Captain - Surveillez l’Aperçu de l’assistant pour la Couverture des connaissances et le nombre de conversations traitées. - Confiez une conversation à l’assistant vous-même : sélectionnez-le dans le menu déroulant de l’attribution de la conversation. Voir Configurer un assistant Captain et connecter vos boîtes de réception - Vérifiez l’utilisation des crédits dans Facturation. Voir Crédits et utilisation Captain AI. Ce qui change dans les autres fonctionnalités lorsque Captain est activé - Chat en direct sur le site : le message « nous sommes absents » n’est pas affiché pendant que l’assistant répond. - Poursuivre les conversations par email : la demande d’email n’est affichée que si l’assistant transfère la conversation. - Message d’accueil de la boîte de réception : le message d’accueil de la boîte n’est pas envoyé pendant que l’assistant gère la conversation. Si l’assistant répond à tout le monde (audience réglée sur Tout le monde), les clients dans ses boîtes ne voient pas le message d’accueil. - La leçon 5 du guide Commencer ici montre Captain de bout en bout. Voir Leçon 5 : Actions IA. Dépannage Si Captain ne répond pas, donne de mauvaises réponses, ou n’apprend pas, allez sur Dépanner Captain.

Configurez un assistant Captain et connectez vos boîtes de réception.

Découvrir Un assistant répond aux clients dans les boîtes de réception que vous lui connectez, et passe la conversation à votre équipe lorsqu'il ne peut pas aider. Plan & accès : Startups, Business ou Enterprise Tarification & Offres. Les administrateurs créent, modifient et suppriment des assistants. Les agents peuvent les consulter et utiliser le Playground. Chaque boîte de réception peut avoir un assistant. Installer & essayer Avant de commencer - Au moins une boîte de réception à connecter (chat en direct, WhatsApp, Instagram, email et autres). - Des connaissances à ajouter juste après : pages web, PDFs ou FAQs. Sans connaissances, l’assistant aura peu de matière pour répondre. - Crédits Captain : chaque réponse de l’assistant à un client utilise des crédits. 1. Créer l’assistant 1. Allez dans Captain > Assistants. 2. Lancez le nouvel assistant : - Aucun assistant pour l’instant : cliquez sur Créer un nouvel assistant sur la page vide. - Vous avez déjà un assistant : ouvrez le sélecteur d’assistants à côté du nom de l’assistant et cliquez sur Créer un assistant. 3. Remplissez : Nom, Description et Nom du produit sont obligatoires. La description peut comporter jusqu'à 500 caractères. - Nom : un nom interne, par exemple "Assistant support". - Description : à quoi sert l’assistant. Indiquez un objectif, pas des instructions. - Nom du produit : le produit qu’il prend en charge. Il s’en sert lorsqu’il parle de votre produit. Captain ne répond qu’aux questions concernant le produit que vous nommez ici, donc indiquez votre marque ou le nom du produit, pas une fonctionnalité spécifique. 4. Choisissez les fonctionnalités (toutes désactivées par défaut) : - Générer des FAQs à partir des conversations résolues : Captain propose de nouvelles FAQs issues des conversations résolues. Voir Ajouter des FAQs et vérifier les suggestions de FAQ dans Captain. - Capturer des informations clés comme souvenirs des échanges clients. Voir Utiliser les mémoires Captain. - Inclure les sources dans les réponses : la réponse affiche le document utilisé. 5. Cliquez sur Créer. - Si c’est votre premier assistant, Chatwoot ouvre ses FAQs. - Si vous avez utilisé le sélecteur, Chatwoot reste sur l’assistant que vous consultiez. Sélectionnez le nouvel assistant dans le sélecteur avant l’étape suivante. 2. Connecter une boîte de réception 1. Sélectionnez le nouvel assistant dans le sélecteur, puis allez dans Boîtes de réception. 2. Cliquez sur Connecter une nouvelle boîte de réception, choisissez la boîte, et confirmez. Tant qu’aucune boîte de réception n'est connectée, l’Aperçu de l’assistant affiche : “Cet assistant n’est encore connecté à aucune boîte de réception, il ne répondra donc pas aux conversations.” 3. Définir ce qu'il dit et quand il clôt les discussions Ouvrez les Paramètres de l’assistant. - Paramètres de base : activez Autoriser l’accès aux informations de contact si l’assistant doit utiliser les détails du contact lors de la réponse. - Paramètres système : - Message de transfert : ce que dit l’assistant lorsqu’il passe la conversation à votre équipe. - Quand les clients arrêtent de répondre : choisissez l’Action lorsque le client cesse de répondre et le temps d’attente (5 minutes à 24 heures ; 60 minutes par défaut). - Laisser Captain examiner (recommandé) : Captain décide de résoudre ou de transférer. Par défaut. - Toujours résoudre : Captain résout chaque conversation après le délai. - Attendre le client : Captain ne résout jamais automatiquement. Il peut toutefois transférer si le client le demande. - Envoyer un message lors de la résolution (activé par défaut) envoie le Message de résolution avant que Captain ne clôt la discussion. Le tester 1. Ouvrez l’assistant et allez dans le Playground. 2. Posez les questions les plus fréquentes de vos clients. Vérifiez que les réponses sont précises, concises et dans votre ton. 3. Posez une question à laquelle il ne devrait pas savoir répondre. Vérifiez qu’il dit ne pas pouvoir aider et propose de vous mettre en contact avec votre équipe. Il transfère lorsque vous acceptez. 4. La réponse peut mettre quelques secondes à apparaître ; vous pouvez laisser la page ouverte pendant ce temps. 5. Puis, envoyez un vrai message à la boîte de réception connectée, par exemple via votre widget web, et observez la réponse. Les messages dans le Playground utilisent des crédits, comme les réponses aux clients. Tester les modifications avant de les enregistrer Dans le Playground, ouvrez Test setup pour essayer des modifications sans impacter l’assistant. Les changements ne s’appliquent qu’à la session de test, sauf si vous les enregistrez. - Connaissances : collez du texte dans Texte de référence pour tester une réponse avant d’en faire un document. Cliquez sur Ajouter le document de façon permanente pour le conserver. - Scénarios, Recommandations et Garde-fous : ajoutez un élément temporaire avec Ajouter au test (↵), ou utilisez Inclure dans ce test pour activer/désactiver les éléments enregistrés pour ce test. Cliquez sur Ajouter le scénario de façon permanente, Ajouter la recommandation de façon permanente ou Ajouter le garde-fou de façon permanente pour les conserver. - Sous chaque réponse, Détails d'exécution affiche les scénarios et règles utilisés, les appels d’outils et les éventuels transferts. - Réinitialiser la configuration de test efface tout ce qui est temporaire. Maximiser la valeur - Ajoutez des connaissances ensuite : Ajouter des documents à la base Captain. - Choisissez à qui et quand il répond : Contrôler à qui Captain répond et quand. - Façonnez ses réponses : Définir les garde-fous, recommandations et scénarios de Captain. - Vérifiez dans l’Aperçu de l’assistant les conversations traitées, la Couverture des connaissances et un Résumé Captain. - Passez vous-même une conversation à l’assistant : dans la liste des assignés d'une conversation, choisissez l’assistant (seul celui connecté à cette boîte est listé). La conversation passe en attente et l’assistant prend le relais, même si les règles d'audience ou de planification l’auraient ignorée. Pour la reprendre, assignez-la à une personne. - Utilisez le sélecteur d’assistants (Passer d’un assistant à l’autre) si vous en exécutez plusieurs, par exemple un par marque ou par langue. - L’assistant lit les anciens messages publics de la conversation, y compris ceux envoyés avant sa connexion. Il ne voit jamais les notes privées. - Pour surveiller les performances de l’assistant, utilisez son Aperçu. Voir Aperçu et rapports Captain. Dépanner Symptôme Cause probable Que faire L’assistant ne répond jamais Aucune boîte de réception connectée Connectez-en une dans Boîtes de réception Impossible de connecter une boîte La boîte a déjà un assistant Déconnectez-la d’abord de l’autre assistant Réponses vagues ou incorrectes Peu ou pas de connaissances ajoutées Ajoutez des documents et FAQs, puis testez à nouveau dans le Playground Impossible de voir Créer un nouvel assistant Vous n’êtes pas administrateur Demandez à un administrateur D'autres causes, même silencieuses : Dépanner Captain.

Ajoutez des documents aux connaissances du Capitaine.

Découvrir Les documents permettent à votre assistant d'en savoir plus sur votre produit. Ajoutez des pages de site web ou des fichiers PDF, et Captain les lit, répond à partir de leur contenu et crée des FAQ sur cette base. Plan & accès : Startups, Business ou Enterprise Tarifs & plans. Les administrateurs peuvent ajouter, actualiser et supprimer des documents. Chaque offre payante inclut jusqu'à 2 000 documents. La limite est partagée entre tous les assistants du compte, et chaque PDF ou page web explorée compte pour un document. Configuration & essai Avant de commencer - Un assistant. Voir Créer un assistant Captain et connecter vos boîtes de réception. - Les pages de site web doivent être publiques. Captain ne peut pas lire les pages nécessitant une connexion. - Les fichiers PDF doivent faire 10 Mo ou moins et contenir du vrai texte (les images scannées peuvent ne pas être lisibles). - Si votre site bloque les crawlers dans robots.txt, autorisez d'abord Chatwoot (ci-dessous). Ajouter un site web ou un PDF 1. Allez dans Captain > Documents. 2. Cliquez sur Créer un nouveau document. 3. Choisissez le Type de document : - URL : saisissez l'adresse de la page. Captain lit cette page ainsi que les pages liées sous le même chemin. Par exemple, https://example.com/help inclut toutes les pages qui commencent par cette adresse. - Fichier PDF : cliquez sur Choisir un fichier PDF et sélectionnez le fichier. 4. Facultatif : ajoutez un Nom de document (facultatif). 5. Sélectionnez l’assistant puis cliquez sur Créer. Captain lit et indexe le contenu. Les pages qu'il découvre en explorant le site sont ajoutées en tant que documents distincts. Autoriser Chatwoot à explorer votre site Chatwoot utilise Firecrawl pour lire les sites web et suit votre robots.txt. Si certaines pages sont bloquées, ajoutez ceci à https://votredomaine.com/robots.txt : User-agent: FirecrawlAgent Allow: / Vérifiez que le fichier est bien accessible à cette adresse, puis ajoutez ou actualisez le document. Si votre robots.txt bloque le crawler au moment d'ajouter un site, aucune page n'est ajoutée et aucune erreur n'est affichée. L’assistant donnera alors des réponses incomplètes ou génériques. Tester 1. Ouvrez le menu du document et choisissez Voir les détails. 2. Vérifiez que Contenu exploré (ou Détails du PDF) affiche votre texte et que FAQs associées liste des questions pertinentes. 3. Posez une question issue de cette page dans le Playground de l’assistant. Obtenez de la valeur - Gardez les documents à jour : utilisez Actualiser maintenant sur un document ou sélectionnez-en plusieurs puis cliquez sur Actualiser. La liste indique la dernière date de mise à jour de chaque document. - Les documents de site web sont aussi actualisés automatiquement : chaque mois pour Startups (le 1er du mois), chaque semaine pour Business (le dimanche) et chaque jour pour Enterprise. Le traitement pouvant être plus long, la page peut ne pas être actualisée à cette heure précise. Les fichiers PDF importés ne sont pas actualisés automatiquement. - Une exploration de site web ajoute jusqu'à 500 pages, et jamais plus que le quota restant de documents. - Privilégiez les sources ciblées, comme votre centre d'aide, plutôt que tout un site marketing. - Utilisé dans les conversations indique dans quelles conversations un document a été utilisé. - Supprimer un document efface tout ce que Captain a appris à partir de celui-ci. - Les articles du centre d’aide ne sont pas lus automatiquement. Pour les utiliser, ajoutez l’adresse de votre centre d’aide comme un document URL. Chaque version linguistique d’un article est une page distincte, donc chaque version compte pour un document. - Les FAQs générées à partir d’un document sont publiées immédiatement. Elles sont listées sous FAQs et ne nécessitent aucune validation. - Les FAQs générées par Captain sont toujours dans la langue de votre compte. L’assistant répond néanmoins dans la langue du client. - Captain ne retire pas les informations personnelles ou confidentielles des contenus que vous ajoutez. N’ajoutez que des contenus que vous acceptez que l’assistant cite aux clients. Dépannage Symptôme Cause probable Que faire Le statut affiche Échec de synchronisation avec Accès refusé La page nécessite une connexion ou votre site a bloqué la requête (erreur 401 ou 403). Rendez la page publique, ou autorisez la requête sur votre site. Ajout d’un site mais aucune page n’apparaît, ou les réponses sont génériques Votre robots.txt bloque peut-être le crawler. Autorisez-le comme indiqué dans Autoriser Chatwoot à explorer votre site , puis réajoutez le document. Page non trouvée L’URL est incorrect ou la page a été déplacée Corrigez l’URL et réessayez d’ajouter le document La page a mis trop de temps à répondre Votre site était lent Utilisez Réessayer l’actualisation plus tard La page a retourné un contenu vide Le contenu s'affiche seulement avec des scripts, ou la page est vide Utilisez une page avec texte en clair ou importez un PDF Mise à jour interrompue Une actualisation n’a pas abouti Utilisez Réessayer l’actualisation Les détails du PDF indiquent qu’aucun contenu lisible n’a pu être extrait PDF scanné ou seulement en image Importez un PDF en texte Bandeau : Limite de documents atteinte Le compte a 2 000 documents parmi tous ses assistants Supprimez les documents inutiles ou voyez Tarifs & plans Autres causes : Dépanner Captain.

Ajoutez des FAQ et examinez les suggestions de FAQ dans Captain.

Découvrir Les FAQ sont des paires de questions et réponses que votre assistant utilise pour répondre. Vous pouvez les écrire vous-même, et Captain en suggère de nouvelles à partir de vos documents et des questions fréquemment posées par les clients. Forfait & accès : Startups, Business ou Enterprise Tarification & Forfaits. Les administrateurs rédigent et modifient les FAQ. Tout le monde peut consulter les suggestions de FAQ ; les agents ne voient que les suggestions provenant des conversations auxquelles ils ont accès. Configuration & essai Avant de commencer - Un assistant avec quelques documents. Voir Ajouter des documents à la base de connaissances de Captain. - Pour les suggestions issues des conversations, activez Générer des FAQ à partir des conversations résolues dans l'assistant. Voir Configurer un assistant Captain et connecter vos messageries Rédiger une FAQ 1. Allez dans Captain > FAQs. 2. Cliquez sur Créer une nouvelle FAQ. 3. Saisissez la question et la réponse, choisissez l'assistant, puis cliquez sur Créer. Examiner les suggestions de FAQ Captain regroupe les questions récurrentes des clients en suggestions et les classe par ordre de demande. Les suggestions sont rédigées dans la langue de votre compte. Les suggestions proviennent uniquement de conversations résolues auxquelles un agent a répondu. Les conversations gérées uniquement par Captain ne créent pas de suggestions. 1. Allez dans Captain > FAQs et cliquez sur Vérifier les suggestions (ou ouvrez Suggestions de FAQ). 2. Ouvrez une suggestion. Conversations sources affiche les conversations associées. 3. Modifiez la question ou la réponse si nécessaire, puis cliquez sur Enregistrer les modifications. 4. Cliquez sur Approuver pour l'ajouter à la base de connaissances de Captain, ou sur Ignorer pour la supprimer. Les FAQ générées par Captain à partir d'un document sont listées sous FAQ associées de ce document. Les FAQ créées à partir de vos documents sont publiées immédiatement et ne nécessitent aucune approbation. Tester Posez la question approuvée dans le Playground de l'assistant et vérifiez qu'il utilise bien votre réponse. Valeur ajoutée - Examinez les suggestions chaque semaine. Elles proviennent de vraies questions clients et comblent donc les lacunes les plus importantes. - Gardez les réponses courtes et précises. Une question par FAQ. - L’onglet Vue d'ensemble de l'assistant affiche la Couverture des connaissances : FAQ approuvées contre suggestions en attente d’examen. Une bannière apparaît lorsque des suggestions sont prêtes. - Utilisez Rechercher des FAQ... et sélectionnez-en plusieurs à supprimer d'un coup. Dépannage Symptôme Cause probable Que faire Aucune suggestion n’apparaît Générer des FAQ à partir des conversations résolues est désactivé, ou peu de conversations ont été résolues. Ou aucun agent n’a répondu dans ces échanges. Il faut au moins une réponse agent. Activez l’option dans l’assistant et patientez L’assistant donne toujours l’ancienne réponse La FAQ est une suggestion, non approuvée Approuvez-la Impossible de créer ou modifier une FAQ Vous n’êtes pas administrateur Demandez à un administrateur ou approuvez plutôt des suggestions Un agent voit moins de suggestions qu'un admin Les agents ne voient que les suggestions des conversations auxquelles ils ont accès Comportement attendu Aucune conversation source accessible trouvée. Les conversations sont dans des messageries auxquelles vous n’avez pas accès, ou ont été supprimées Demandez à un administrateur ayant l'accès de vérifier Autres causes : Dépanner Captain.

Définir les garde-fous, directives et scénarios du Capitaine

Découvrir Trois ensembles de règles encadrent votre assistant : les Garde-fous décident des questions auxquelles il répond, les Directives de réponse déterminent le ton de ses réponses, et les Scénarios lui indiquent quoi faire dans des situations spécifiques. Planification & accès : Startups, Business ou Enterprise Tarifs & forfaits. Les administrateurs peuvent les modifier. Ils font partie de chaque compte Captain, sur chaque forfait payant. Ensemble de règles Utilisation Exemple Garde-fous Garder l'assistant sur le sujet et l’éloigner des questions interdites « Ne donne pas de conseils juridiques ou médicaux. » Directives de réponse Ton, longueur et structure des réponses « Limite les réponses à trois phrases maximum. Sois amical, pas formel. » Scénarios Gestion pas-à-pas d’une situation, avec option d’utiliser un outil dédié « Lorsqu’un client demande un remboursement, demande le numéro de commande, vérifie-le avec l’outil de recherche, puis transmets. » Mettre en place & essayer Avant de commencer - Un assistant. Voir Configurer un assistant Captain et connecter vos boîtes de réception. - Pour les scénarios qui font appel à vos systèmes, un outil personnalisé. Voir Configurer des outils personnalisés pour Captain. Ajouter des garde-fous et des directives de réponse 1. Rendez-vous dans Captain, ouvrez l’assistant, puis accédez à Paramètres. 2. Ouvrez Garde-fous ou Directives de réponse. 3. Cliquez sur Ajouter un garde-fou ou Ajouter une directive de réponse, saisissez la règle en une phrase brève, puis cliquez sur Créer. 4. Pour ajouter une règle issue des exemples, tapez dans la case sous les exemples puis cliquez sur Ajouter et enregistrer (↵), ou appuyez sur Entrée. 5. Pour modifier une règle, cliquez sur son icône crayon, éditez le texte, puis appuyez sur Entrée. Ajouter un scénario 1. Rendez-vous dans Captain, ouvrez l’assistant, puis accédez à Scénarios. 2. Cliquez sur Ajouter un scénario et remplissez : - Titre : un nom court, par exemple « Demande de remboursement ». - Description : quand ce scénario s’applique. - Comment gérer : ce que doit faire l’assistant, étape par étape. Pour utiliser un outil à une étape, tapez @ et sélectionnez-le dans la liste, par exemple Transfert vers un humain ou un de vos outils personnalisés. Si le scénario doit finir avec votre équipe, ajoutez le transfert en dernière étape. 3. Cliquez sur Créer. 4. Pour modifier un scénario, ouvrez-le, modifiez les champs, puis cliquez sur Mettre à jour. Tester Dans le Playground, posez une question pour chaque règle (par exemple une question hors-sujet, et une demande de remboursement). Vérifiez que la réponse suit bien la règle. En tirer profit - Commencez avec trois à cinq garde-fous et directives. Ajoutez-en si un problème réel se présente dans les conversations. - Formulez les règles comme des instructions à un nouveau membre de l’équipe, pas comme des mots-clés. - Les garde-fous sont des instructions pour l’IA, pas un filtre. Ils réduisent fortement les réponses hors-sujet mais ne les excluent pas totalement, gardez donc le Message de transfert explicite. - Si un outil utilisé dans un scénario est désactivé, ce scénario peut cesser de fonctionner. Chatwoot vous avertit avant la désactivation. Résolution des problèmes Symptôme Cause probable Que faire L’assistant ignore une règle La règle est floue ou en conflit avec une autre Reformulez-la en une phrase claire, supprimez les conflits Le scénario ne s’exécute jamais La description de la situation ne correspond pas à la façon dont les clients la formulent Décrivez la situation avec les mots propres aux clients Le scénario s’arrête en cours Son outil personnalisé est désactivé ou a échoué Vérifiez l’outil dans Outils Pas de menu Scénarios pour l’assistant Le compte est Hackeur (gratuit), ou sur auto-hébergé Captain n’est pas activé Passez à une offre supérieure ou demandez à l’admin d’activer Captain Plus de causes : Dépanner Captain.

Contrôlez à qui et quand Captain répond

Découvrir Vous pouvez choisir à quels clients l’assistant répond (Audience) et quand (Planification). Les conversations que l’assistant ne prend pas en charge restent Ouvertes pour votre équipe. L’Audience et la Planification appartiennent à l’assistant, elles s’appliquent donc à chaque boîte de réception connectée. Plan & accès : Startups, Business ou Enterprise : Tarification & Offres. Les administrateurs modifient ces paramètres. Configurez et essayez Avant de commencer - Un assistant connecté à une boîte de réception. Voir Configurer un assistant Captain et connecter vos boîtes de réception. - Pour une planification, les horaires d’ouverture activés pour cette boîte, dans ses propres paramètres. Voir Horaires d’ouverture et Répondeur automatique. - Pour des règles d’audience sur vos propres données, les attributs personnalisés du contact que vous souhaitez utiliser. Voir Comprendre les Contacts. Choisir l’audience 1. Allez dans Captain > Assistants, ouvrez l’assistant, puis allez dans Paramètres > Audience. 2. Choisissez : - Tout le monde : l’assistant répond à chaque conversation dans ses boîtes de réception. C’est l’option par défaut. - Audience spécifique : l’assistant ne répond qu’aux clients qui correspondent à vos conditions. 3. Pour une audience spécifique, ajoutez des conditions. Chacune possède un attribut, un opérateur et une valeur. - Attributs du contact : Nom, E-mail, Téléphone, Identifiant, Pays, Ville, Société, Date de création, Dernière activité, Bloqué, Étiquettes. - Attributs de la conversation : Utilisateur connecté, Langue du navigateur. La langue du navigateur provient uniquement du widget du site web, cela ne fonctionne donc pas pour WhatsApp, Telegram, SMS ou d’autres canaux. Étiquettes signifie les étiquettes de contact, pas celles de la conversation. Utilisateur connecté signifie que le visiteur a été vérifié via la validation d'identité (HMAC) dans le widget de votre site web. - Vos attributs personnalisés du contact. - Les opérateurs que vous pouvez choisir dépendent de l’attribut. Par exemple, Nom propose seulement égal et non égal, E-mail propose aussi contient (utilisez-le pour cibler un domaine comme @acme.com), et les dates proposent supérieur à, inférieur à et jours avant. 4. Choisissez si les clients doivent correspondre à toutes les conditions ou à l’une d’elles. Vous pouvez grouper les conditions, par exemple « Abonnement est Pro ET (Pays est US OU Pays est Canada) ». Vous pouvez imbriquer les groupes sur un seul niveau : un groupe peut contenir des sous-groupes, mais un sous-groupe ne peut pas contenir un autre groupe. 5. Enregistrez. Choisir la planification 1. Dans les mêmes Paramètres, ouvrez Planification. 2. Choisissez À tout moment (par défaut), Pendant les horaires d'ouverture ou En dehors des horaires d'ouverture. 3. Enregistrez. Les deux règles doivent être validées : l’assistant ne répond que lorsque le client est dans l’audience et que cela correspond à la planification. Testez 1. Démarrez une nouvelle conversation en tant que client correspondant, pendant la plage horaire choisie. L’assistant répond. 2. Démarrez-en une en tant que client ne correspondant pas. Elle sera dirigée vers votre équipe sans réponse d’assistant. Maximiser la valeur - Configurations courantes : assistant uniquement en dehors des horaires d’ouverture ; assistant seulement pour les utilisateurs connectés du site web ; assistant pour tout le monde sauf les clients avec l’étiquette « VIP ». - Les règles sont vérifiées au démarrage d’une conversation ou lors de la réouverture d’une conversation résolue, pas à chaque message. Une fois que l’assistant est dans une conversation, il y reste jusqu’à ce que la conversation soit résolue ou transférée. Les modifications s’appliquent uniquement aux nouvelles conversations et à celles rouvertes. - La recherche de texte ne tient pas compte de la casse. Les numéros de téléphone correspondent avec ou sans le + initial. Une case à cocher jamais renseignée est considérée comme décochée. - La planification suit les horaires d’ouverture et le fuseau horaire de la boîte de réception. Si le fuseau horaire est incorrect, l’assistant peut être absent la majeure partie de la journée de vos clients, sans avertissement. - Ces règles décident quand l’assistant intervient automatiquement. Un agent peut toujours transférer n’importe quelle conversation à l’assistant via la liste de sélection de l’attributaire, ce qui ignore l’audience et la planification. Voir Configurer un assistant Captain et connecter vos boîtes de réception. Dépannage Symptôme Cause probable Que faire L’assistant répond à quelqu’un que vous avez exclu Les informations du contact ont changé après le début de la conversation Comportement normal. La règle s’applique à partir de la prochaine nouvelle conversation ou conversation rouverte. Ouvrez le contact et vérifiez ses attributs dans la barre latérale. Captain vérifie les valeurs du contact au démarrage. L’assistant intervient alors qu’il n’aurait pas dû Un agent a attribué manuellement la conversation à l’assistant Comportement normal. L’attribution manuelle ignore l’audience et la planification La planification n’a aucun effet Les horaires d’ouverture ne sont pas activés pour cette boîte de réception. Sans horaires, c’est « toujours » Activez les horaires d’ouverture dans les paramètres de la boîte de réception Votre attribut n’apparaît pas dans la liste Il s’agit d’un attribut personnalisé de la conversation. Seuls les attributs personnalisés du contact fonctionnent Utilisez plutôt un attribut du contact. Créez-le dans Paramètres › Attributs personnalisés et choisissez Contact . Impossible d’enregistrer l’audience Une condition ne contient pas de valeur (en rouge), ou Audience spécifique sans conditions Complétez ou supprimez la condition. Est présent et N’est pas présent (pour les dates seulement) ne nécessitent pas de valeur. L’assistant est muet pour tout le monde L’audience ou la planification exclut tous les clients Vérifiez les deux paramètres, puis Dépanner Captain

Configurer des outils personnalisés pour le Capitaine

Découvrir Les outils personnalisés permettent à l’assistant d’appeler vos propres systèmes pendant une conversation, par exemple pour vérifier une commande, une garantie ou une réservation, au lieu de transférer la demande. Forfait & accès : Business ou Enterprise (Tarifs & forfaits). Sur Startups, Outils affiche généralement Mettre à niveau pour utiliser les outils avec Captain. Chaque assistant dispose de sa propre liste d’outils. Les administrateurs créent les outils, et seuls les administrateurs peuvent voir les identifiants enregistrés. En auto-hébergement : le Super Admin active les Outils personnalisés pour le compte. Configuration & essai Avant de commencer - Un endpoint HTTPS sur un nom d’hôte public. Chatwoot bloque le HTTP simple, les adresses IP, localhost, les réseaux privés et les adresses .local. - Le endpoint doit accepter la connexion en moins de 2 secondes et répondre en moins de 20 secondes, avec une réponse de 1 Mo ou moins. - Ses identifiants, s’il en a besoin. Créer un outil 1. Allez dans Captain > Outils et cliquez sur Créer un nouvel outil. Utilisez d’abord le sélecteur d’assistant en haut pour choisir l’assistant pour lequel l’outil est destiné. Le formulaire s’ouvre dans un panneau latéral. 2. Remplissez : - Nom de l’outil : court, par exemple "Recherche de commande" (55 caractères ou moins). - Description : quand l’assistant doit l’utiliser, rédigée comme un briefing pour un nouvel agent. Cela détermine si l’assistant choisira cet outil. - Méthode : GET pour lire des données ; POST, PUT ou PATCH pour envoyer ou modifier des données ; DELETE pour supprimer quelque chose. - URL du endpoint : utilisez {{ parameter_name }} pour les valeurs que l’assistant remplit, par exemple https://api.example.com/orders/``{{ order_id }}. - Type d’authentification : Aucun, Bearer Token, Basic Auth ou Clé API (avec Nom de l’en-tête et Valeur de l’en-tête). À utiliser pour les identifiants. - En-têtes : cliquez sur Ajouter un en-tête pour les en-têtes fixes dont votre API a besoin à chaque appel, comme une version d’API ou un identifiant de locataire (jusqu’à 16). Les valeurs sont envoyées telles quelles. Chatwoot gère Authorization, Host, Content-Length, Content-Type et tout en-tête commençant par X-Chatwoot lui-même, vous ne pouvez donc pas les ajouter. - Paramètres : cliquez sur Ajouter un paramètre pour chaque valeur que l’assistant doit récupérer auprès du client. Donnez un nom, un type, une description, et cochez Requis si nécessaire. - Modèle de corps de requête (Optionnel) : pour POST, PUT ou PATCH. Ceci et le modèle de réponse se trouvent sous Modèles. Le modèle de requête est un corps JSON. Prend en charge Liquid, par exemple {{ order_id }} pour un paramètre. - Modèle de réponse (Optionnel) : sélectionnez les champs dont l’assistant a besoin, par exemple Commande {{ response.order_id }} statut : {{ response.status }}. Lisez la réponse de l’API via response, par exemple {{ response.status }}. Laissez le modèle vide pour envoyer le JSON brut à Captain. 3. Cliquez sur Tester la connexion, puis Créer. Tester la connexion ne fonctionne que pour les endpoints sans modèles ni corps de requête. Pour les autres, testez dans le bac à sable. Un résultat vert signifie que votre endpoint a retourné un statut 2xx : il est joignable et a accepté les identifiants. Testez-le Posez une question dans le Bac à sable qui nécessite l’outil, par exemple "Où est la commande 1234 ?". Vérifiez que la réponse utilise de vraies données. Maximisez la valeur - Les outils personnalisés sont optimaux pour les recherches avec des entrées claires, comme un statut de commande, une réservation ou un enregistrement par ID. - Chaque assistant peut avoir jusqu’à 50 outils. Gardez néanmoins la liste courte : avec beaucoup d’outils, l’assistant risque de choisir le mauvais. - Ajouter, modifier, désactiver ou supprimer un outil ne concerne que l’assistant affiché. Les outils qui existaient avant que les outils ne soient spécifiques par assistant ont été copiés pour chaque assistant, vérifiez donc chacun. - Vous gérez plusieurs assistants ? N’attribuez à chacun que les outils dont il a besoin. - Désactivez un outil grâce à son interrupteur au lieu de le supprimer. Si un scénario l’utilise, Chatwoot vous avertit d’abord. Voir Définir les garde-fous, lignes directrices et scénarios de Captain. - Chatwoot envoie des en-têtes à chaque appel afin que votre système connaisse le compte, la conversation, l’e-mail et le téléphone du contact, l’assistant, et si le contact est vérifié. Pour les données privées, vérifiez l’en-tête X-Chatwoot-Contact-Inbox-Verified avant de répondre. Sans validation d’identité, un visiteur peut saisir n’importe quel e-mail dans le widget. Les outils renvoyant uniquement des données publiques n’ont pas besoin de cette vérification. Voir Comment activer la validation d’identité dans Chatwoot ?. - Si votre API retourne du texte saisi par les clients, ne renvoyez que les champs structurés nécessaires. Captain lit la réponse telle quelle, donc un texte libre peut contenir des instructions qui pourraient être suivies. Dépannage Symptôme Cause probable Que faire La connexion a échoué Endpoint injoignable, pas en HTTPS, ou mauvais identifiants Vérifiez l’URL et les identifiants ; assurez-vous qu’il s’agit d’un HTTPS public La connexion a échoué avec 401 Les identifiants sont incorrects Vérifiez le Type d’authentification et les identifiants La connexion a échoué avec 403 Votre API a rejeté la requête Les requêtes de test n’envoient pas d’en-têtes de contact, donc un endpoint qui en a besoin échouera au test. Testez dans le bac à sable La connexion a échoué avec 404 Chemin d’URL incorrect Vérifiez le chemin de l’URL La connexion a échoué avec un délai imparti Votre API a mis plus de 20 secondes à répondre, ou 2 secondes à se connecter Accélérez le endpoint URL rejetée Adresse IP, localhost ou adresse privée Utilisez un nom d’hôte public Un en-tête est rejeté Il s’agit d’un en-tête défini par Chatwoot, d’un doublon, ou sa valeur contient des variables Supprimez-le ou déplacez les identifiants dans Type d’authentification Un outil est absent sur un autre assistant Les outils appartiennent à un seul assistant Passez sur cet assistant et créez l’outil là-bas Impossible d’ajouter un nouvel outil L’assistant possède déjà 50 outils Supprimez les outils inutilisés L’assistant n’utilise jamais l’outil La description est trop vague Reformulez la Description afin de préciser exactement quand l’utiliser L’assistant utilise le mauvais outil Trop d’outils ou des descriptions qui se recoupent Retirez ou désactivez des outils ; rendez les descriptions distinctes Réponse lente ou absente, puis transfert Endpoint a mis plus de 20 secondes ou a retourné plus de 1 Mo Accélérez le endpoint ; réduisez la réponse grâce à un modèle de réponse Autres causes : Dépanner Captain.

Travaillez plus rapidement avec Captain Copilot

Découvrir Copilot est un assistant IA pour les agents, intégré à chaque conversation. Demandez-lui de résumer, de rédiger une réponse, de vérifier le ton, de traduire ou de chercher une information. Abonnement & accès : Startups, Business ou Enterprise Tarification et forfaits. Tout agent peut l’utiliser, dans n’importe quelle boîte de réception. Il n’y a rien à activer par boîte. Chaque requête Copilot utilise des crédits Captain. Configuration & essai Avant de commencer - Au moins un assistant Captain. Copilot utilise les connaissances d’un assistant lors de ses recherches. Copilot consulte également vos articles du centre d’aide si vous avez l’autorisation de gérer la base de connaissances. L’assistant n’a pas besoin d’être connecté à une boîte de réception. Pour une IA qui aide les agents sans jamais répondre aux clients, créez un assistant et ne le reliez à aucune boîte. Voir Configurer un assistant Captain et connecter vos boîtes. Utiliser Copilot 1. Ouvrez une conversation. 2. À droite, ouvrez l’onglet Copilot. 3. Choisissez un exemple dans Essayez ces suggestions (Résumer cette conversation, Suggérer une réponse, Évaluer cette conversation), ou saisissez votre propre demande. En dehors d'une conversation, Copilot propose Conversations à haute priorité et Lister les contacts à la place. 4. Si vous avez plusieurs assistants, utilisez Sélectionner un assistant pour choisir l’expertise à utiliser. 5. Lorsque Copilot propose une réponse qui vous convient, cliquez sur Utiliser ceci pour la placer dans la boîte de réponse. Modifiez, puis envoyez. 6. Cliquez sur Réinitialiser pour recommencer. Tester Ouvrez une conversation réelle, choisissez Suggérer une réponse, et vérifiez que le brouillon utilise bien vos connaissances produit. Obtenez de la valeur - Soyez précis : « Rédige une réponse polie expliquant le retard et propose une livraison vendredi » fonctionne mieux que « répondre ». - Relisez toujours un brouillon avant envoi. Copilot suggère ; l’agent décide. - Utilisez Afficher les étapes pour voir comment Copilot a trouvé sa réponse. - Suggérer une réponse dans Copilot utilise la configuration complète de l’assistant sélectionné : sa description, les consignes de réponse, garde-fous et FAQ. Suggérer une réponse dans l’éditeur de réponses utilise uniquement les FAQ (de l’assistant relié à la boîte, ou de toutes les FAQ approuvées du compte), sans consignes ni ton. - Les actions de l’éditeur comme reformuler et résumer sont des fonctionnalités IA distinctes. - Pour obtenir des étiquettes suggérées ou une priorité pour une conversation, utilisez Suggérer avec Captain dans la barre latérale de la conversation. Dépannage Symptôme Cause probable Que faire Aucun onglet Copilot Compte en Hacker (gratuit), ou Captain non activé Voir Démarrer avec Captain AI « Vous n’avez plus de crédits Copilot. Vous pouvez en acheter dans la section facturation. » Plus de crédits Achetez des crédits dans Facturation , ou attendez le renouvellement « Une erreur s’est produite lors de la génération de la réponse. Veuillez réessayer. » Erreur temporaire Réessayez Les réponses ignorent vos documents Mauvais assistant sélectionné, ou pas de documents Utilisez Sélectionner un assistant ; ajoutez des documents Autres causes : Dépanner Captain.

Utilisez Capitaine Souvenirs

Découvrir Avec la fonction mémoires activée, l’assistant enregistre les informations clés d’une conversation sous forme de notes sur le contact, afin que votre équipe, et Copilot, disposent du contexte la prochaine fois. L’assistant ne lit pas ces notes lorsqu’il répond aux clients. Plan & accès : Startups, Business ou Enterprise (Tarifs & Abonnements). Un administrateur l’active par assistant. Configurer & essayer Avant de commencer - Un assistant. Voir Configurer un assistant Captain et connecter vos boîtes de réception. Activer les mémoires 1. Allez dans Captain > Assistants, ouvrez l’assistant, puis allez dans Paramètres. 2. Activez Enregistrer les informations clés des interactions avec les clients comme mémoires. 3. Enregistrez. Ce qui est enregistré Des détails utiles pour la prochaine fois, tels que : - Les préférences et les produits ou forfaits utilisés par le client. - Les questions récurrentes ou problèmes. - Les besoins particuliers, comme une intégration dont il dépend. - Le contexte tel que la taille de l’équipe. Tester Ayez une conversation où vous mentionnez une préférence, par exemple « Nous utilisons l’offre Pro et nous préférons l’email », puis terminez la discussion. Ensuite, ouvrez le contact et vérifiez les Notes. En tirer parti - Les mémoires apparaissent dans les Notes du contact avec « Bot » comme auteur et l’heure de l’enregistrement. Les agents les voient dans la barre latérale de la conversation. - Les mémoires sont enregistrées lorsqu’une conversation dans une boîte de réception connectée est résolue, que ce soit par l’assistant ou un agent, tant que le compte dispose de crédits. - Les agents peuvent supprimer une mémoire mais ne peuvent pas la modifier. - Informez les clients de ce que vous stockez, conformément à votre politique de confidentialité. Dépanner Symptôme Cause probable Que faire Aucune note n’apparaît Le bouton est désactivé, la conversation n’est pas encore résolue, ou rien d’important à enregistrer Vérifiez le paramètre ; terminez la conversation Arrêt des mémoires Les crédits sont épuisés Voir Crédits et utilisation Captain AI Notes pour certains contacts seulement Seules les conversations résolues dans les boîtes connectées à l’assistant créent des mémoires Comportement attendu Autres causes : Dépanner Captain.

Crédits et utilisation de Captain AI

Découvrir Le Capitaine utilise des crédits IA. Chaque formule payante inclut des crédits gratuits chaque mois, et vous pouvez en acheter plus. Formule & accès : Startups, Business ou Entreprise. Le nombre de crédits inclus pour chaque formule, ainsi que le prix de recharge, sont indiqués sur Tarification & Formules > Crédits IA Capitaine. Les administrateurs voient l'utilisation et achètent des crédits dans Facturation. Configurer & essayer Ce qui utilise des crédits Chacune de ces actions consomme un crédit : - Une réponse de l’assistant à un client. - Un message dans le Playground de l’assistant. - Une demande Copilot. - Une action d’éditeur, comme reformuler, résumer ou suggérer une réponse. - Une transcription audio. L’ajout de documents, l’approbation de FAQ, les suggestions d’étiquette et de priorité de Suggérer avec Capitaine, et les conditions Capitaine dans les règles d’automatisation n’utilisent pas de crédits. Voir votre utilisation 1. Allez dans Paramètres > Facturation. 2. La section Capitaine affiche les Crédits et Documents utilisés. Cliquez sur Rafraîchir pour mettre à jour. Acheter plus de crédits 1. Dans Facturation > Capitaine, cliquez sur Acheter plus de crédits. 2. Choisissez un lot et cliquez sur Acheter des crédits, puis confirmez. Votre carte enregistrée est débitée immédiatement. Crédits achetés : - Sont ajoutés immédiatement et utilisés après les crédits mensuels de votre formule. - Expirent après 6 mois. - Nécessitent un abonnement actif pour être utilisés. - Ne sont pas remboursables. Tester Après l’achat, vérifiez le nouveau solde dans Facturation > Capitaine. En tirer parti - Les crédits mensuels se réinitialisent à la date de renouvellement de votre formule. Acheter des crédits ou changer de formule ne réinitialise pas votre utilisation. - Les crédits mensuels non utilisés ne sont pas reportés. Si vous consommez plus que vos crédits mensuels, l’excédent sera débité sur les crédits achetés. - Lorsque vous changez de formule, votre solde augmente ou diminue de la différence entre les crédits mensuels des deux formules. Votre utilisation reste inchangée. - Modifier votre nombre de sièges ne réinitialise pas l’utilisation. - Pour faire durer vos crédits : connectez l’assistant uniquement aux boîtes de réception où il est utile, utilisez les règles d’audience et de planning (Contrôler qui Capitaine répond et quand), et désactivez les fonctionnalités IA inutilisées, comme la transcription. - Une bannière vous alerte lorsque vous avez utilisé plus de 80 % de vos crédits. Il n’y a pas d’alerte par email, et les crédits ne se rechargent pas automatiquement. - L’utilisation est comptabilisée en un seul total pour le compte. Elle n’est pas répartie par agent, assistant ou fonctionnalité. Pour voir les performances de chaque assistant, utilisez son Aperçu (Aperçu et rapports Capitaine). Dépanner Symptôme Cause probable Que faire Les nouvelles conversations vont directement à l’équipe sans réponse de l’assistant Plus de crédits Acheter des crédits ou attendre le renouvellement L’assistant dit "Transfert à un autre agent pour une assistance supplémentaire." en cours de conversation Plus de crédits pendant la conversation Acheter des crédits ou attendre le renouvellement Copilot indique que vous n’avez plus de crédits Copilot Plus de crédits Acheter des crédits ou attendre le renouvellement L’utilisation n’est pas revenue à 0 après l’achat Comportement attendu. L’utilisation se réinitialise seulement au renouvellement ; l’achat ajoute simplement au solde Aucun Les crédits sont utilisés plus vite que prévu L’assistant est actif sur des boîtes très sollicitées, ou les fonctionnalités IA sont très utilisées Restreindre l’audience ou le planning ; désactiver les fonctions inutiles Impossible d’acheter des crédits Vous n’êtes pas administrateur, ou aucun abonnement actif Demandez à un administrateur ; vérifiez l’abonnement Autres causes : Dépanner Capitaine.

Activer Captain en auto-hébergement

Découvrir Vous pouvez exécuter Captain sur votre propre installation de Chatwoot avec votre propre clé OpenAI. Plan & accès : inclus dans les forfaits Premium et Entreprise en auto-hébergement. Voir Enterprise Edition. Vous devez avoir accès à la console Super Admin. L'édition Communautaire n'inclut pas Captain. Premium et Entreprise bénéficient des mêmes fonctionnalités et réglages pour Captain. Configuration & essai Avant de commencer - Une clé API OpenAI. - Optionnel : un point de terminaison compatible OpenAI si vous hébergez votre propre modèle. - Optionnel : une clé API Firecrawl pour un meilleur crawl des sites web. Sans cela, Chatwoot utilise un crawler intégré plus simple. 1. Configurer Captain pour l'installation 1. Ouvrez la console Super Admin et allez dans Paramètres. 2. Sur la carte Captain, cliquez sur l’icône des paramètres (roue dentée). 3. Remplissez : - Clé API OpenAI. - OpenAI Model définit le modèle pour les fonctionnalités Copilot et éditeur. Laissez vide pour utiliser gpt-4.1-mini. L’assistant utilise gpt-5.2 par défaut. Pour le changer, allez dans Super Admin › Comptes, éditez le compte et ouvrez l’onglet Captain models. Si vous utilisez un point de terminaison personnalisé, assurez-vous qu’il fournit les modèles que vous choisissez ici. - Point de terminaison API OpenAI (optionnel), pour un modèle auto-hébergé compatible. - Modèle d'embedding (optionnel). - Clé API FireCrawl (optionnel). 4. Cliquez sur Soumettre. 2. Activer Captain pour un compte Les comptes créés lorsque votre installation est en Premium ou Entreprise ont déjà Captain activé. Pour les comptes créés avant cela : 1. Dans la console Super Admin, allez dans Comptes. 2. Ouvrez le compte et cliquez sur Modifier. 3. Dans les fonctionnalités premium, activez Captain. Les garde-fous, consignes de réponse et scénarios sont inclus. Pour des outils personnalisés, activez aussi Outils Personnalisés (Configurer des outils personnalisés pour Captain). 4. Sauvegardez. Testez Connectez-vous à ce compte. Captain apparaît dans la barre latérale. Créez un assistant et envoyez un message dans le Playground. Voir Configurer un assistant Captain et connecter vos boîtes de réception. En tirer profit - OpenAI vous facture pour l’utilisation sur votre propre clé. Chatwoot ne compte pas les crédits Captain sur les installations auto-hébergées. - Vous effectuez une mise à niveau à partir d'une ancienne version où les assistants utilisaient le champ Instructions ? Celui-ci n'est plus utilisé. Déplacez les instructions dans les garde-fous et consignes de réponse avant la mise à jour (Définir les garde-fous, consignes et scénarios de Captain). - Tout le reste fonctionne comme sur Cloud. Continuez avec Ajouter des documents à la base de connaissances de Captain. Dépannage Symptôme Cause probable Que faire Pas de Captain dans la barre latérale Non activé pour le compte, ou licence Premium ou Entreprise absente Vérifiez les deux étapes ; vérifiez votre licence Aucun outil Outils personnalisés désactivés pour le compte Activez-les dans Super Admin > Comptes L’assistant ne répond pas Clé OpenAI invalide/inactive, ou nom de modèle non supporté Vérifiez la clé. Vérifiez que votre endpoint fournit le modèle de l’assistant ( gpt-5.2 par défaut, ou celui défini dans l’onglet Captain models du compte). Pages manquantes dans les documents de site web Pas de clé Firecrawl, donc le crawler simple est utilisé Ajoutez une clé API FireCrawl Synchronisation des documents de site web échouée Clé API Firecrawl invalide Vérifiez que la clé API Firecrawl est valide. Si une clé est définie, Chatwoot utilise toujours Firecrawl, donc une clé invalide fait échouer la synchronisation de documents web. Retirez la clé pour utiliser le crawler intégré. Toujours en échec Une erreur sur le serveur Vérifiez les logs web et worker

Dépanner Capitaine

Découvrir Utilisez cette page lorsque Captain reste silencieux, donne de mauvaises réponses ou n'apprend pas. La plupart des problèmes proviennent d'un réglage, pas d'une défaillance. Plan & accès : Captain nécessite les abonnements Startups, Business ou Enterprise Tarifs & Abonnements . La plupart des correctifs requièrent un administrateur. Configurer & essayer : la vérification rapide Lorsque l'assistant reste silencieux, vérifiez ces points dans l'ordre : 1. Abonnement : Captain apparaît-il dans la barre latérale ? Si vous voyez Passer à Captain AI, le compte est en mode Hacker (gratuit). Captain n'est pas disponible pendant l'essai gratuit. 2. Crédits : Réglages > Facturation > Captain. S'il n'y a plus de crédits, Captain ne fonctionne pas. 3. Boîte de réception : la boîte de réception figure-t-elle dans les Boîtes de réception de l'assistant ? 4. Audience : est-elle réglée sur Audience spécifique, et le client correspond-il ? 5. Plage horaire : est-ce Pendant les heures ouvrées ou En dehors des heures ouvrées, et l'heure correspond-elle ? 6. Déclenchement : les règles sont vérifiées lors du démarrage ou de la réouverture d'une conversation. Une conversation en cours conserve sa première décision. 7. Statut : Captain ne répond que lorsqu'une conversation est En attente. Si elle est Ouverte, Captain reste silencieux. Cela se produit lorsqu'un agent a répondu, que l’assistant a passé la main, ou qu'une règle d'automatisation a attribué la conversation à quelqu'un. Captain ne revient pas sur une conversation ouverte, sauf si elle est de nouveau attribuée à l'assistant. Tester Démarrez une toute nouvelle conversation, en tant que client correspondant à l'audience, dans la plage horaire, dans une boîte de réception connectée. Distinguer : silence ou échec - Silencieux : aucune réponse du tout signifie généralement qu'un des points de la vérification rapide a empêché Captain de démarrer. - Silencieux à certains moments de la journée : la plage horaire suit les heures ouvrées de la boîte de réception et son fuseau horaire. Vérifiez le fuseau horaire dans les paramètres de la boîte. - Passage de main : lorsque Captain ne peut pas répondre, il envoie votre Message de transfert et transmet la conversation à votre équipe. - Plus de crédits : une nouvelle conversation est directement transmise à votre équipe sans réponse. Dans une conversation déjà gérée par Captain, il envoie « Transfert vers un autre agent pour assistance supplémentaire. » et la transmet. Dépannage Réponses Symptôme Cause probable Que faire L’assistant ne répond jamais Un des points de la vérification rapide Passez en revue la vérification rapide ci-dessus Répond à des personnes exclues Leur identité a changé après le début de la conversation Attendu ; s’applique à partir de la prochaine conversation. Voir Contrôler à qui et quand Captain répond Répond hors des plages horaires Les heures ouvrées sont désactivées pour la boîte de réception Activez les heures ouvrées dans les paramètres de la boîte de réception Mauvaises réponses ou réponses inventées Savoir manquant ou obsolète Ajoutez ou mettez à jour des documents ; approuvez les suggestions FAQ. Utilisez Signaler un message Captain sur la réponse pour indiquer à Chatwoot ce qui n'a pas fonctionné L’assistant gère une conversation qui aurait dû être exclue Un agent l’a attribuée à l’assistant depuis la liste des assignés Attendu. Réattribuez-la à une personne pour la reprendre Réponses hors sujet Absence de garde-fous Ajoutez des garde-fous. Voir Configurer les garde-fous, directives et scénarios de Captain Passage de main trop fréquent Lacunes de connaissance ou outil personnalisé en panne Passez en revue les suggestions FAQ ; vérifiez Outils Résolution trop rapide des conversations Toujours résoudre est activé avec une courte attente Choisissez Laisser Captain réviser (recommandé) ou une attente plus longue Connaissances Symptôme Cause probable Que faire Un document affiche Échec de la synchronisation La page nécessite une connexion, ou votre site a bloqué la requête (erreur 401 ou 403). La page peut aussi être absente ou lente. Voir Ajouter des documents à la base de connaissances de Captain Un site ajouté mais aucune page ou réponses génériques Votre robots.txt bloque peut-être le crawler. Autorisez le crawler dans votre robots.txt, puis ajoutez à nouveau le document. Voir Ajouter des documents à la base de connaissances de Captain Pas de suggestions de FAQ Générer des FAQ à partir des conversations résolues est désactivé. Ou aucun agent n’a répondu dans ces conversations. Il faut au moins une réponse agent. Activez l'option. Voir Ajouter et examiner des FAQ dans Captain Limite de documents atteinte Le compte a 2 000 documents répartis entre tous ses assistants Supprimez les documents inutilisés ; voir Tarifs & Abonnements Outils, Copilot et crédits Symptôme Cause probable Que faire Outil personnalisé inutilisé Description trop vague, ou trop d’outils Voir Configurer les outils personnalisés pour Captain Message d’erreur Copilot Erreur temporaire ou manque de crédits Réessayez ; vérifiez les crédits Crédits consommés rapidement Boîtes de réception sollicitées, ou IA très utilisée Voir Crédits Captain AI et utilisation Quand contacter le support Contactez le support si la vérification rapide est réussie et que Captain reste silencieux lors d'une nouvelle conversation. Envoyez : - Votre identifiant de compte (Réglages > Paramètres du compte). - Le nom de l’assistant et la boîte de réception. - Un lien vers une conversation concernée, et la date/heure. - Si l’assistant a répondu dans le Playground.

Aperçu du capitaine et rapports

Retour à Commencez avec Captain AI. Découvrir Chaque assistant dispose d’un Aperçu qui montre ses performances : combien de conversations il a traitées, combien il en a résolues tout seul, pourquoi il a transféré des conversations, et comment les clients l’ont évalué. Plan & accès : Startups, Business ou Enterprise Tarification et forfaits. Toute personne pouvant ouvrir Captain voit l’Aperçu. Seuls les administrateurs peuvent cliquer sur un nombre pour voir les conversations associées. Configurer & essayer Avant de commencer - Un assistant connecté à une boîte de réception ayant traité quelques conversations. Voir Configurer un assistant Captain et connecter vos boîtes de réception. Tant qu’une boîte de réception n’est pas connectée, l’Aperçu affiche : « Cet assistant n’est pas encore connecté à une boîte de réception, il ne répondra donc pas aux conversations. » Ouvrir l’Aperçu 1. Allez dans Captain et choisissez l’assistant dans le sélecteur d’assistant. 2. Ouvrez Aperçu. 3. Sélectionnez la période en haut : un nombre de jours, Cette semaine, Semaine dernière, Ce mois-ci ou Mois dernier. Par défaut, c’est Ce mois-ci. Que signifie chaque nombre Nombre Ce que cela signifie Conversations traitées Conversations où Captain a répondu au client ou a transmis la conversation à votre équipe Taux d’auto-résolution La part des conversations traitées que Captain a résolues sans l’aide de votre équipe. Plus c’est élevé, mieux c’est Taux de transfert La part des conversations traitées que Captain a transférées à votre équipe Taux de réouverture Part des conversations résolues par Captain que les clients sont revenus rouvrir plus tard. Plus c’est bas, mieux c’est Résolutions Captain restées fermées Part des conversations résolues par Captain restées fermées sept jours plus tard. Seules les résolutions d’au moins sept jours sont comptées Temps médian de résolution Temps typique entre le moment où une conversation arrive à Captain et sa résolution Messages par conversation Nombre moyen de réponses envoyées par Captain dans chaque conversation traitée Effort agent et temps économisés Estimation, basée sur deux minutes économisées pour chaque réponse publique de Captain Les autres cartes - Résumé Captain : un court résumé écrit des performances de l’assistant. Il apparaît lorsqu’il y a suffisamment d’activité. - Le diagramme de flux : montre comment les conversations traitées se répartissent entre Résolu par Captain, Transféré et Fermé avec l’équipe, et combien de résolutions Captain ont été Rouvertes en 7j ou Restées fermées. - Raisons de transfert : pourquoi Captain a transmis les conversations à votre équipe : Demande du client, Connaissances manquantes, Demande non prise en charge, Restriction de politique, Échec d’outil, Précision client en attente, Limite d’utilisation ou Non classé. - Tendance des résolutions : conversations traitées et résolues par Captain sur la période, comparées à la période précédente sur les mêmes jours. - CSAT Captain : note client moyenne pour les conversations résolues par Captain et les conversations assistées par Captain, comparée aux conversations traitées uniquement par votre équipe. - Couverture des connaissances : FAQ validées par rapport aux FAQ suggérées en attente de révision. Cliquez sur Réviser les FAQ pour accéder à la file d’attente. - Utilisation : Crédits et Documents utilisés pour le compte. Cliquez sur Actualiser l’utilisation pour mettre à jour, ou Acheter plus de crédits. Voir les conversations derrière un nombre Les administrateurs peuvent cliquer sur un nombre, ou une raison de transfert, pour voir les conversations associées. Cliquez sur Charger plus pour en voir davantage. La liste compte les « épisodes ». Une conversation peut apparaître plusieurs fois si Captain l’a traitée à des moments différents, par exemple après une réouverture. Tester Sélectionnez Ce mois-ci, cliquez sur Taux de transfert, et ouvrez quelques conversations. Vérifiez que les raisons de transfert correspondent bien à ce qui s’est passé. Obtenir de la valeur Utilisez les raisons de transfert pour décider quoi corriger en priorité : Si ce taux est élevé Essayez ceci Connaissances manquantes Ajoutez des documents et validez les suggestions de FAQ. Voir Ajouter des documents à la base de connaissances de Captain et Ajouter des FAQ et revoir les suggestions de FAQ dans Captain Échec d’outil Vérifiez vos outils. Voir Configurer des outils personnalisés pour Captain Restriction de politique ou Demande non prise en charge Vérifiez que vos garde-fous et scénarios ne sont pas trop stricts. Voir Définir les garde-fous, directives et scénarios de Captain Limite d’utilisation Le compte n’a plus de crédits. Voir Crédits Captain AI et utilisation Demande du client Souvent attendu. Si c’est très élevé, vérifiez les réponses de l’assistant dans le Playground - Si le taux de réouverture augmente, les réponses semblent correctes mais ne résolvent pas le problème. Lisez quelques conversations rouvertes. - Effort agent et temps économisés est une estimation, et non une mesure. - Pour les rapports couvrant tous les bots du compte. Dépanner Symptôme Cause probable Que faire « Aucune donnée disponible pour cette période. » Aucune boîte de réception connectée, ou Captain n’a traité aucune conversation sur cette période Connectez une boîte de réception, ou choisissez une autre période Une période affiche « Pas encore assez d’historique » L’assistant n’a pas de données aussi anciennes Choisissez une période plus courte Résolutions Captain restées fermées sans valeur Aucune résolution de la période n’a encore sept jours Attendu. Réessayez plus tard Cliquer sur un nombre ne fait rien Vous n’êtes pas administrateur Demandez à un administrateur Une conversation apparaît deux fois dans une liste Captain l’a traitée lors de deux épisodes distincts Attendu Les chiffres d’utilisation ont l’air anciens La carte n’est pas actualisée Cliquez sur Actualiser l’utilisation Autres causes : Dépanner Captain.

Mise à jour du fichier robots.txt pour autoriser l'assistant Chatwoot à explorer votre site web

Chatwoot utilise Firecrawl en interne pour récupérer et indexer le contenu de votre site web. Cela permet à l’Assistant Chatwoot de répondre aux questions en utilisant les informations de votre site. Cependant, si le fichier robots.txt de votre site comporte des règles Disallow, Firecrawl les respectera et évitera de parcourir ces pages. Lorsque cela se produit : - Aucun document provenant de votre site ne sera ajouté à Chatwoot - L’Assistant ne recevra aucun contexte supplémentaire - Les réponses pourront être incomplètes ou génériques Pour garantir le bon fonctionnement de l’Assistant, vous devez autoriser Firecrawl à explorer votre site internet. Étape 1 : Vérifiez votre robots.txt Visitez : https://yourdomain.com/robots.txt Recherchez toute entrée Disallow: susceptible de bloquer des agents utilisateurs. Étape 2 : Ajoutez une règle Allow pour Firecrawl Demandez à l’administrateur ou au développeur de votre site d’ajouter les lignes suivantes dans le fichier robots.txt : User-agent: FirecrawlAgent Allow: / Cela indique à Firecrawl qu'il est autorisé à explorer l'ensemble de votre site, même si d'autres robots sont restreints. Étape 3 : Enregistrez et publiez Après la mise à jour de robots.txt, assurez-vous que le fichier est déployé et accessible publiquement. Vous pouvez vérifier en visitant : https://yourdomain.com/robots.txt et en vérifiant que les nouvelles règles apparaissent.

Le capitaine décide de résoudre automatiquement ou de confier les conversations.

Lorsque Captain gère une conversation client, celle-ci ne reste pas indéfiniment à l’état « en attente ». Après une période d’inactivité, Captain évalue la conversation et décide l’une des deux issues suivantes : la résoudre (si les besoins du client ont été satisfaits) ou la transférer à un agent humain (si quelque chose reste non résolu). Cet article explique comment fonctionne cette décision et à quoi vous pouvez vous attendre. Le processus de résolution automatique Voici ce qui se passe après que Captain ait répondu à un client : 1. La conversation reste au statut En attente tant que Captain la gère. 2. S’il n’y a pas de nouvelle activité pendant 1 heure, Captain évalue la conversation. 3. En fonction de l’évaluation, Captain : - Résout la conversation — envoie un message de résolution et la clôture. - Transfère à un agent humain — rouvre la conversation pour que votre équipe puisse la reprendre. Dans les deux cas, Captain ajoute une note privée expliquant la raison de sa décision. Comment Captain évalue une conversation Captain lit l’ensemble de la conversation et vérifie si les besoins du client ont été pris en compte. L’évaluation est volontairement prudente — en cas de doute, Captain garde la conversation ouverte et transfère à un humain. Il vaut mieux qu’un agent trouve une conversation finalement résolue que de risquer de fermer une demande alors que le client a encore besoin d’aide. Quand Captain résout Captain résout une conversation lorsqu’il est certain que la question du client a reçu une réponse complète et qu’il n’y a rien à ajouter. Le client n’a pas besoin de dire explicitement « merci » ou de confirmer — si Captain a donné une réponse complète et qu’il n’y a pas eu de relance, cela suffit. Par exemple, si un client demande « Quels sont vos horaires d’ouverture ? » et que Captain répond en indiquant les horaires, puis que le client ne répond pas pendant une heure — Captain résoudra la conversation. La réponse était autonome et complète. Captain résout également lorsqu’un client envoie des propos incompréhensibles ou des mots isolés sans réelle question, et que Captain a demandé des précisions sans recevoir de réponse. Quand Captain transfère Captain transfère à un humain dès qu’il y a un doute sur le fait que le client ait encore besoin d’aide. Voici quelques exemples courants : - Captain a suggéré au client d’essayer quelque chose (comme vider son cache ou changer un paramètre) — le client est peut-être encore en train d’essayer. - Captain a orienté le client vers un lien ou une ressource externe — le client est peut-être encore en train de lire. - Le client a demandé quelque chose que Captain ne pouvait pas faire — même si Captain a expliqué pourquoi, le besoin n’est pas comblé. - Le client a soulevé plusieurs points et ils n’ont pas tous été traités. Le principe directeur : en cas d’ambiguïté sur le fait que le client ait terminé, Captain préfère garder la conversation ouverte pour votre équipe. Ce que voit le client Lorsque Captain résout : Le client reçoit un message de résolution. Vous pouvez personnaliser ce message dans les paramètres de votre assistant Captain — si vous n’en définissez pas, un message par défaut sera utilisé. Lorsque Captain transfère : Si vous avez configuré un message de transfert dans les paramètres de votre assistant Captain, le client verra ce message. Le statut de la conversation passe à Ouvert, et votre équipe la voit dans sa file d’attente. Si votre équipe est en dehors des horaires d’ouverture, le client reçoit également automatiquement votre message d’absence. Foire aux questions La résolution automatique fonctionne-t-elle dans toutes les langues ? Oui. Captain évalue les conversations en fonction du sens et de l’intention, quel que soit la langue utilisée. Où puis-je voir pourquoi Captain a résolu ou transféré une conversation ? Consultez la conversation pour une note privée laissée par Captain. Il en ajoute une avec son explication avant chaque décision de résolution ou de transfert. Je ne souhaite pas que Captain résolve automatiquement les conversations sur mon compte. Contactez notre équipe de support et nous pourrons désactiver la résolution automatique sur votre compte.

Comment configurer des outils personnalisés pour Captain

Les outils personnalisés permettent à Captain de solliciter vos API externes pendant les conversations — il peut ainsi vérifier l’état du système, consulter des horaires ou récupérer des données provenant de vos services sans intervention humaine. Lorsqu’un client pose une question, Captain extrait les valeurs pertinentes de la conversation, les insère dans votre requête API, puis utilise la réponse pour formuler sa propre réponse. Les outils personnalisés sont disponibles avec le forfait Business et supérieurs. Création d’un outil Rendez-vous dans Captain -> Outils et cliquez sur Créer un nouvel outil. Remplissez les champs suivants : Nom de l’outil — Un nom court comme « État du système » ou « Recherche d’horaires » (max 55 caractères). Description — Indiquez à Captain quand utiliser cet outil. C’est le champ le plus important. Rédigez-le comme une consigne destinée à un agent de support : « Vérifie l’état actuel du système, incluant les incidents en cours ou la maintenance programmée. » Des descriptions vagues comme « API Statut » feront manquer des occasions d’utiliser l’outil à Captain. Méthode — Choisissez GET (pour récupérer des données) ou POST (pour envoyer des données). URL de l’endpoint — L’URL de votre API. Utilisez {{ parameter_name }} pour insérer les valeurs extraites de la conversation : https://api.yourcompany.com/v1/showtimes?q={{ query }} L’URL doit utiliser HTTPS, doit être un nom d’hôte (pas une adresse IP) et ne peut pas pointer vers localhost ou des réseaux privés. Authentification — Choisissez la méthode d’authentification de votre API : | Type | Ce que vous fournissez | |------|----------------------| | Aucune | Pas d’authentification | | Bearer Token | Une chaîne de jeton | | Basic Auth | Nom d’utilisateur et mot de passe | | API Key | Un nom et une valeur d’en-tête personnalisés | Les identifiants d’authentification ne sont visibles que par les administrateurs du compte. Paramètres — Définissez ce que Captain doit extraire du message du client. Chaque paramètre nécessite un nom, un type et une description. Par exemple : query (Chaîne) — « Le titre du film ou la date demandée par le client. » Modèle de requête (POST seulement) — Un modèle de corps JSON utilisant la syntaxe Liquid : { "query": "{{ query }}", "source": "captain" } Modèle de réponse — Contrôle ce que Captain voit de la réponse de votre API. Si ce champ est vide, Captain reçoit le JSON brut. Utilisez Liquid pour extraire les champs pertinents : État du système : {{ response.status }}. {{ response.message }} Utilisez response pour accéder au corps JSON analysé. Les modèles de réponse aident Captain à se concentrer sur les données pertinentes et à éviter les champs internes comme les ID de base de données ou informations de débogage. Tester votre outil Cliquez sur Tester la connexion avant de sauvegarder pour vérifier que votre endpoint est accessible. Le test indique le code de statut HTTP. Un résultat vert (HTTP 200–299) signifie que la connexion et l’authentification fonctionnent. Notez que le test envoie l’URL sans renseigner les valeurs de paramètre, il vérifie donc uniquement que votre endpoint est accessible et que vos identifiants sont valides. En cas d’échec du test, vérifiez les points suivants : - 401 Non autorisé — Vos identifiants d’authentification sont incorrects. Vérifiez à nouveau votre token, clé API ou identifiant/mot de passe. - 403 Interdit — Votre API rejette la requête. Si une vérification d’identité est exigée, sachez que les requêtes de test n’incluent pas d’en-têtes de contact. - 404 Introuvable — L’URL de l’endpoint est incorrecte. Vérifiez le chemin et assurez-vous que votre API fonctionne. - Timeout — Votre API met trop de temps à répondre. Les outils personnalisés ont un délai maximum de 30 secondes ; assurez-vous que votre endpoint répond dans ce laps de temps. Contexte envoyé avec chaque appel d’outil Lorsque Captain appelle votre API, il incline des en-têtes de métadonnées pour informer votre backend du contexte : | En-tête | Description | |--------|-------------| | X-Chatwoot-Account-Id | ID de votre compte | | X-Chatwoot-Conversation-Id | Identifiant de la conversation | | X-Chatwoot-Contact-Email | Adresse email du client (si disponible) | | X-Chatwoot-Contact-Inbox-Verified | Si l’identité du client est vérifiée HMAC | Des en-têtes additionnels incluent X-Chatwoot-Assistant-Id, X-Chatwoot-Tool-Slug, X-Chatwoot-Contact-Id, X-Chatwoot-Contact-Phone, et X-Chatwoot-Conversation-Display-Id. Vous pouvez utiliser ces en-têtes pour rechercher le client dans votre propre système, enregistrer les conversations qui ont déclenché des appels API, et vérifier l’authenticité des requêtes. Sécurité Protections intégrées : - Tous les endpoints doivent utiliser HTTPS - Les requêtes vers des plages d’adresses IP privées, localhost et domaines .local sont bloquées - Les redirections HTTP ne sont pas suivies - Les réponses sont limitées à 1 Mo - Les identifiants d’authentication ne sont visibles que par les administrateurs Vérification d’identité : Si votre outil retourne des données spécifiques au client (commandes, facturation, détails de compte), votre API devrait vérifier l’en-tête X-Chatwoot-Contact-Inbox-Verified. Sans la vérification HMAC activée sur votre boîte de réception, un visiteur pourrait fournir n’importe quelle adresse email dans le widget de discussion. Ne retournez des données sensibles que si cet en-tête a la valeur true. Pour les outils qui retournent des données publiques (horaires, état du système), cette vérification n’est pas nécessaire. Injection de prompt : Si votre API renvoie du contenu généré par les utilisateurs (avis, posts de forum), du texte malveillant pourrait influencer le comportement de Captain. Utilisez les modèles de réponses pour extraire uniquement les champs structurés, et assainissez le contenu côté API. Limites | Limite | Valeur | |-------|--------| | Nombre maximal d’outils par compte | 15 | | Recommandé | 10 ou moins (un avertissement apparaît au-dessus de 10) | | Longueur du nom d’outil | 55 caractères | | Taille de la réponse | 1 Mo max | | Délai d’attente | 30 secondes | Quand utiliser les outils personnalisés Les outils personnalisés sont particulièrement adaptés aux recherches structurées avec des entrées prévisibles — vérification de l’état du système, récupération d’horaires ou recherche de fiches par ID. Si une intégration dédiée à votre cas d’usage existe déjà dans Chatwoot (par exemple, Shopify pour l’e-commerce), privilégiez cette intégration — elle gérera la recherche, la correspondance approximative, et la synchronisation de données bien plus efficacement qu’un simple appel API. Exemples Vérification de l’état du système Un outil simple, sans paramètre — Captain l’utilise lorsqu’un client demande si quelque chose est en panne. | Champ | Valeur | |-------|--------| | Nom de l’outil | État du système | | Description | Vérifie l’état opérationnel actuel du système, y compris les incidents en cours ou la maintenance programmée. À utiliser lorsqu’un client signale un problème ou demande si le système est hors service. | | Méthode | GET | | URL de l’endpoint | https://status.yourcompany.com/api/v1/status | | Auth | Aucune | | Paramètres | (aucun) | | Modèle de réponse | État du système : {{ response.status }}. {{ response.message }} | Recherche d’horaires / de séances Pour les entreprises avec des horaires, des plannings ou des listes d’événements — les clients demandent ce qui est disponible et Captain récupère le planning en cours. | Champ | Valeur | |-------|--------| | Nom de l’outil | Recherche d’horaires | | Description | Recherche les horaires de projection de films et les séances. À utiliser lorsqu’un client demande quels films sont à l’affiche ou quand un film spécifique est programmé. | | Méthode | GET | | URL de l’endpoint | https://api.yourcinema.com/v1/showtimes?q={{ query }} | | Auth | Bearer Token | | Paramètres | query (Chaîne, requis) — « Le titre du film ou la date de séance demandée par le client » | | Modèle de réponse | {% for show in response.showtimes %}{{ show.title }} — {{ show.date }} à {{ show.time }}{% endfor %} | Les outils personnalisés fonctionnent au mieux lorsque les entrées sont simples et la réponse de l’API prévisible — vérifications d’état, recherches et autres requêtes structurées sont des cas d’usage idéaux.

Traduire automatiquement les messages dans les conversations

La traduction automatique permet à votre équipe de prendre en charge les clients dans n'importe quelle langue. Les messages des clients apparaissent dans votre langue et vos réponses parviennent automatiquement au client dans la sienne. Cet article vous montre comment l'activer et comment travailler avec des conversations traduites. Avant de commencer - La traduction automatique est disponible sur toutes les offres payantes, que ce soit en auto-hébergement ou sur Chatwoot Cloud. - Vous devez être administrateur pour l'activer. - Les messages sont traduits dans la langue définie sur votre tableau de bord Chatwoot. Chaque agent peut modifier cela sous Paramètres du profil → Langue préférée. Si un agent n'en a pas choisi, la langue par défaut du compte est utilisée. Étape 1 : Activer la traduction automatique 1. Allez dans Paramètres → Flux de travail des conversations. 2. Dans la section Traduction, choisissez un service de traduction : - Captain : des traductions IA qui sonnent de façon naturelle et conservent votre ton. - Google Translate : des traductions rapides et fiables de Google. Si Non connecté s'affiche, cliquez sur Connecter et suivez les étapes d'abord. 3. Activez le bouton Traduire automatiquement les conversations. Paramètres → Flux de travail des conversations → Traduction Voilà. La traduction automatique fonctionne désormais dans chaque conversation de votre compte. Les agents n'ont rien à configurer. Étape 2 : Lire les messages des clients dans votre langue Ouvrez une conversation. Lorsqu'un client écrit dans une autre langue, son message apparaît déjà traduit, avec un lien Voir l’original en dessous mentionnant la langue dans laquelle il a écrit. Dans l'exemple ci-dessous, Sophie écrit en français et l’agent lit ses messages en anglais. Les messages de Sophie en français apparaissent en anglais. La réponse de l’agent en anglais lui est envoyée en français. Étape 3 : Répondre dans votre propre langue Rédigez votre réponse dans votre langue habituelle et envoyez-la comme d'habitude. Chatwoot la traduit dans la langue du client avant qu'il ne la reçoive. Un lien Voir la traduction apparaît sous votre réponse. Étape 4 : Vérifier le texte original ou traduit Vous pouvez toujours voir exactement ce qui a été écrit ou envoyé : - Sur un message client, cliquez sur Voir l’original pour voir ses mots exacts. - Sur votre réponse, cliquez sur Voir la traduction pour voir la version reçue par le client. - Cliquez à nouveau sur le lien pour revenir en arrière. Le message original de Sophie en français, et la version française de la réponse de l’agent. Ce que vous verrez sur les messages Ce que vous voyez Ce que cela signifie Texte violet animé avec Traduction en cours… Un message client est en cours de traduction dans votre langue. Cela prend généralement une seconde. Texte violet animé avec Traduction vers le français… Votre réponse est en cours de traduction dans la langue du client avant d’être envoyée. Voir l’original (français) Le message du client a été traduit. Cliquez pour voir ce qu’il a écrit. Voir la traduction (français) Votre réponse a été traduite. Cliquez pour voir ce que le client a reçu. Impossible de traduire Un message client n’a pas pu être traduit et est affiché tel que le client l’a écrit. Impossible de traduire, envoyé tel que saisi Votre réponse n’a pas pu être traduite, donc le client a reçu votre texte original. Un nouveau message client est en cours de traduction en anglais Le message de Sophie en anglais n’affiche pas de ligne de traduction. La dernière réponse de l’agent est en cours de traduction en français. Foire aux questions Comment Chatwoot sait-il dans quelle langue répondre ? Chatwoot détecte la langue dans laquelle le client écrit et traduit vos réponses dans cette langue. Que se passe-t-il si le client passe à ma langue ? Ses messages apparaîtront exactement comme ils sont tapés, sans rien en dessous. Vos réponses suivent la langue utilisée par le client dans la conversation. Les notes privées sont-elles traduites ? Non. Seuls les messages que le client peut voir sont traduits. Les notes privées restent telles que vous les avez écrites. Ai-je encore besoin de l’option Traduire dans le menu du message ? Non. Avec la traduction automatique activée, les messages sont traduits pour vous. L’option Traduire manuelle est donc masquée pour ces messages. Puis-je basculer entre Captain et Google Translate ? Oui. Revenez dans Paramètres → Flux de travail des conversations et choisissez l’autre service. Les nouveaux messages utiliseront le service que vous aurez sélectionné.