Dépannage de ReplyRabbit
La plupart des problèmes ReplyRabbit se résument à l'une de trois choses : une clé API manquante ou erronée, l'utilisation d'un fournisseur non autorisé par votre niveau de forfait, ou un cache FreeScout obsolète. Parcourez la section correspondante ci-dessous, où chaque problème présente d'abord le symptôme puis la solution.
Aucun brouillon n'est généré
Symptôme : vous ouvrez une conversation, mais aucun brouillon IA n'apparaît et rien ne semble se produire.
Correction : ouvrez les paramètres ReplyRabbit de la boîte aux lettres (Boîte aux lettres > Paramètres > ReplyRabbit) et confirmez qu'un fournisseur est sélectionné et que sa clé API est définie. Sur l'offre gratuite, le seul fournisseur disponible est OpenAI, donc si vous en avez choisi un autre, revenez à OpenAI ou passez à une offre supérieure. Vérifiez ensuite que ReplyRabbit est activé pour la boîte aux lettres dans laquelle vous travaillez, car les brouillons ne sont générés que pour les boîtes aux lettres activées.
Clé API invalide ou erreur du fournisseur
Symptôme : vous voyez une erreur mentionnant une clé invalide, un échec d'authentification ou un fournisseur injoignable.
Correction : revérifiez la clé pour les fautes de frappe et les espaces superflus, confirmez qu'il s'agit bien de la clé du fournisseur que vous avez réellement sélectionné (une clé OpenAI ne fonctionnera pas avec Anthropic), et assurez-vous que la clé dispose encore de crédit et d'accès sur le tableau de bord du fournisseur. Une clé sans solde restant ou dont l'accès a été révoqué produit la même erreur.
Erreurs après la mise à niveau de PHP
Symptôme : après une mise à niveau du serveur (par exemple, vers Ubuntu 26.04 avec PHP 8.5), Tester la connexion échoue ou les tâches en arrière-plan s'arrêtent, et le journal FreeScout affiche des messages se terminant par is deprecated since 8.5.
Correction : gardez ReplyRabbit et vos autres modules à jour depuis Gérer > Modules, puis exécutez php artisan freescout:clear-cache et php artisan queue:restart. ReplyRabbit prend en charge PHP 8.0 à 8.5. Voir Corriger les erreurs « deprecated since 8.5 » dans FreeScout pour trouver de quel module provient un message.
Le menu ReplyRabbit est absent
Symptôme : ReplyRabbit n'apparaît pas dans les menus ou paramètres de FreeScout après son installation.
Correction : vérifiez d'abord que le module est activé sous Gérer > Modules. Videz ensuite le cache depuis la racine de votre FreeScout :
php artisan freescout:clear-cacheS'il manque toujours, vérifiez les permissions de l'utilisateur : un utilisateur sans accès à la boîte aux lettres concernée ou aux paramètres d'administration ne verra pas les options ReplyRabbit.
Les brouillons se sont arrêtés après un moment
Symptôme : les brouillons ont fonctionné au début, puis ont cessé de se générer plus tard dans le mois.
Correction : le forfait Free autorise 10 brouillons par mois. Une fois cette limite atteinte, les brouillons sont suspendus jusqu'au mois suivant. Pro et Team n'ont aucune limite de brouillons. Quel que soit le forfait, les brouillons sont aussi suspendus si le Budget mensuel de jetons est épuisé, donc vérifiez aussi ce paramètre (0 signifie aucun budget).
La mise en cache des prompts ne change pas le décompte mensuel de tokens
Symptôme : les brouillons répétés semblent éligibles à la mise en cache des prompts du fournisseur, mais l'utilisation de jetons de ReplyRabbit affiche toujours le total complet des entrées et des sorties.
Correction : c'est attendu. ReplyRabbit garde des budgets mensuels prudents et compte le total des jetons, même lorsqu'un fournisseur facture différemment les entrées mises en cache. Les économies de cache du fournisseur dépendent du fournisseur, du modèle, des préfixes de prompt répétés et du reporting du fournisseur. Le contrôle de cache Anthropic n'est utilisé que pour les travaux de brouillon répétés éligibles et revient à la génération normale lorsqu'il n'est pas pris en charge.
Les tickets Linear ne sont pas créés
Symptôme : les prochaines actions sont détectées, mais aucun ticket Linear n'est créé.
Correction : dans les paramètres ReplyRabbit, vérifiez la clé API Linear, l'équipe sélectionnée et si les tickets sont en attente de confirmation. Confirmez également que votre niveau inclut Linear : la création manuelle de tickets Linear est une fonctionnalité Pro, et la création automatique de tickets est une fonctionnalité Team.
Les tickets Jira ne sont pas créés
Symptôme : une conversation nécessite du travail d'ingénierie, mais aucun ticket Jira n'est créé.
Correction : dans les paramètres ReplyRabbit, confirmez que Jira est sélectionné comme outil de suivi des tickets de la boîte aux lettres. Vérifiez l'URL du site Jira Cloud, l'e-mail du compte, le token API, le projet par défaut et le type de ticket par défaut. Confirmez également que votre niveau inclut la création de tickets : la création manuelle de tickets Jira est une fonctionnalité Pro, et la création automatique de tickets est une fonctionnalité Team. Pour le chemin de configuration complet, voir Intégration Jira.
Les étiquettes de workflow ne sont pas appliquées
Symptôme : vous attendiez des étiquettes telles que rr_priority_critical, rr_no_reply_needed, ou rr_linear_issue_created, mais la conversation n'a aucune étiquette ReplyRabbit.
Correction : ouvrez les paramètres ReplyRabbit de la boîte aux lettres et confirmez Activer la synchronisation des workflows et Appliquer les tags FreeScout sont activés dans le Étiquettes de workflow section. Si les étiquettes de signal sont absentes, confirmez Signaux IA est activé et la conversation a été analysée. Si les tags Linear manquent, confirmez que la conversation a un ticket Linear créé par ReplyRabbit.
Si les recettes FreeScout Workflows ne se déclenchent pas, vérifiez d'abord que ReplyRabbit ajoute bien l'étiquette FreeScout attendue. Testez ensuite si votre module Workflows installé réagit aux changements d'étiquettes programmatiques. ReplyRabbit peut appliquer les étiquettes, mais le module Workflows contrôle si une recette s'exécute à partir de ce changement d'étiquette.
Sources de connaissances : un brouillon n'a pas utilisé mes pages d'aide, la base de connaissances, les produits ou les réponses précédentes
Symptôme : un brouillon a ignoré des informations que vous savez présentes dans vos pages d'aide, votre base de connaissances, votre liste de produits ou des réponses antérieures.
Correction : commencez par la ligne sous le brouillon dans l'éditeur de réponse. Elle liste ce que le brouillon a utilisé, par exemple « Inclus : 2 pages d'aide, 1 article de base de connaissances, 3 réponses antérieures à ce client ». Cliquez dessus pour voir les liens, ainsi qu'une note pour chaque source activée qui n'a rien ajouté :
- Activé mais rien d'indexé pour l'instant : l'indexation n'est pas terminée. Vérifiez le worker de file d'attente (voir ci-dessous), puis attendez que l'indexation soit terminée.
- Aucune correspondance pertinente pour ce message : la source est correcte, mais rien en elle ne correspondait suffisamment au message de ce client. Ajoutez ou améliorez du contenu qui répond à ce type de question.
- Index au-dessus de la limite de recherche : une fois que l'index dépasse 6 000 sections indexées, seule la correspondance par mots-clés s'exécute, pas la correspondance par le sens. Supprimez les sources dont vous n'avez pas besoin pour revenir sous la limite.
- Votre offre ne l'inclut pas : cette source n'est pas disponible avec votre forfait actuel.
- Le module Base de connaissances n'est pas installé ou actif : installez-le ou activez-le sous Gérer > Modules.
Avertissements d'état de configuration
La bannière d'état de configuration dans les paramètres de boîte aux lettres avertit désormais lorsque :
- Le worker de file d'attente ne semble pas s'exécuter. L'indexation et les brouillons automatiques ne se terminent jamais sans cela. FreeScout exécute la file d'attente via la tâche cron
php artisan schedule:runou unqueue:workprocessus, donc assurez-vous que l'un d'eux est configuré. - Aucune source de connaissances n'est activée. Activez au moins une source dans Mailbox settings, Knowledge sources.
- Une source est activée mais pas encore indexée. Laissez l'indexation se terminer.
Sources du site web
- L'exploration s'arrête à 200 pages par défaut, et la source l'indique désormais, avec un bouton pour augmenter la limite. Enregistrez vos paramètres ensuite, puis relancez l'exploration.
- Les pages qui ne peuvent pas être lues sont comptées avec une raison, par exemple bloquées par le site (403), introuvables (404), trop de requêtes (429), une erreur serveur, trop volumineuses, ou aucun texte lisible (souvent une page construite avec JavaScript). Demandez à votre hébergeur de laisser passer le crawler, ou pointez la source vers des pages qui ne nécessitent pas JavaScript.
- Les pages très longues sont raccourcies à environ 24 000 caractères. Lorsque la correspondance sémantique est activée, la source indique combien de pages ont été raccourcies. Divisez les pages longues si la partie dont vous avez besoin se trouve vers la fin.
Outline et correspondance par le sens
- La synchronisation Outline s'arrête à 1 000 documents. Les documents au-delà ne sont pas synchronisés.
- La correspondance basée sur le sens (sémantique) nécessite un fournisseur d'embeddings. Certains modèles d'embedding ne sont pas encore calibrés pour les correspondances uniquement sémantiques et affichent un avertissement, changez donc de modèle d'embedding si vous le voyez.
Toujours bloqué ?