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
-
Allez dans Captain > Documents.

-
Cliquez sur Créer un nouveau document.

-
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/helpinclut toutes les pages qui commencent par cette adresse.
- Fichier PDF : cliquez sur Choisir un fichier PDF et sélectionnez le fichier.

-
-
Facultatif : ajoutez un Nom de document (facultatif).

-
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
-
Ouvrez le menu du document et choisissez Voir les détails.
-
Vérifiez que Contenu exploré (ou Détails du PDF) affiche votre texte et que FAQs associées liste des questions pertinentes.

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