Intégration Workflows FreeScout
Fonctionne avec Workflows FreeScout
Utilisez ce guide pour configurer les tags de workflow ReplyRabbit. ReplyRabbit peut transformer les signaux IA, l'état des brouillons, les décisions de non-réponse et l'état des tickets Linear en tags FreeScout. Ces tags peuvent ensuite être utilisés par les agents, les rapports et les recettes de workflow FreeScout où votre installation Workflows réagit aux changements de tags.
Vous cherchez la vue d'ensemble ?
Aperçu
Les étiquettes de workflow sont un pont entre ReplyRabbit et les étiquettes FreeScout. ReplyRabbit ne remplace pas le moteur de règles Workflows. Il applique des étiquettes prévisibles telles que rr_priority_critical, rr_intent_billing, rr_no_reply_needed, rr_ai_draft_ready, et rr_linear_issue_created.
Si le module FreeScout Workflows est installé et réagit aux changements d'étiquettes programmatiques, les administrateurs peuvent créer des recettes qui surveillent ces étiquettes. Si Workflows n'est pas installé, ou s'il ne réévalue pas lorsqu'un module ajoute des étiquettes, les étiquettes apparaissent tout de même sur les conversations et dans la barre latérale ReplyRabbit pour la visibilité.
Prérequis
Avant de commencer, assurez-vous de disposer de :
- Une installation FreeScout fonctionnelle.
- ReplyRabbit installé et activé.
- Accès aux paramètres de la boîte aux lettres dans FreeScout.
- Signaux IA activés si vous voulez des étiquettes pour la priorité, le sentiment, l'intention, la confiance, le besoin de révision humaine ou l'opportunité commerciale.
- Linear configuré si vous souhaitez le
rr_linear_issue_createdétiquette. - Le module FreeScout Workflows installé si vous voulez que les recettes agissent sur les tags.
Si ReplyRabbit n'est pas encore installé, commencez par Comment installer le module ReplyRabbit, puis terminez Comment configurer ReplyRabbit.
Ce que ReplyRabbit peut taguer
| Source | Étiquettes d'exemple | Notes |
|---|---|---|
| Signaux IA | rr_priority_critical, rr_sentiment_negative, rr_intent_billing, rr_confidence_low, rr_needs_human, rr_sales_opportunity | Nécessite AI Signals sur Pro ou Team. |
| État du brouillon | rr_no_reply_needed, rr_ai_draft_ready | Basé sur la génération de brouillons ReplyRabbit et les décisions de non-réponse. |
| État Linear | rr_linear_issue_created | Nécessite un ticket Linear lié créé via ReplyRabbit. |
Le préfixe par défaut est rr_. Vous pouvez le modifier dans les paramètres de la boîte aux lettres avant d'enregistrer les Étiquettes de workflow.
Configurer Workflow Tags
Ouvrez les paramètres de la boîte aux lettres
Dans FreeScout, ouvrez la boîte aux lettres qui doit recevoir les étiquettes ReplyRabbit, puis ouvrez Paramètres et choisissez ReplyRabbit.Trouver les étiquettes de workflow
Faites défiler jusqu'à la Étiquettes de workflow section.Activer la synchronisation des workflows
Activer Activer la synchronisation des workflows.Appliquer les tags FreeScout
Activer Appliquer les tags FreeScout afin que ReplyRabbit puisse écrire les étiquettes mappées.Révision de la création et du nettoyage
Quitter Créer les étiquettes si elles sont absentes activé si ReplyRabbit doit créer automatiquement les tags FreeScout mappés. Laissez Supprimer les anciens tags ReplyRabbit activé si les tags obsolètes appartenant à ReplyRabbit doivent être supprimés lorsque l'état source change.Examiner la table des libellés
Confirmez le Préfixe de tag, Conversations récentes à synchroniser, et Table de correspondance des tags d'automatisation paramètres, puis enregistrez.
La modification des paramètres Workflow Tags démarre une synchronisation limitée pour les conversations récentes. La limite provient de Conversations récentes à synchroniser, afin que les boîtes aux lettres très sollicitées n'aient pas besoin de retraiter chaque conversation historique.
Personnaliser la table des tags
Le Table de correspondance des tags d'automatisation le champ est JSON. Chaque clé de signal prise en charge peut être activée ou désactivée, et chaque valeur correspond à une étiquette de tag.
Utilisez le mappage par défaut sauf si votre équipe a une raison de renommer les tags. Si vous le personnalisez, gardez les libellés courts et prévisibles afin que les recettes de workflow FreeScout soient faciles à lire.
{
"priority": {
"enabled": true,
"values": {
"critical": "rr_priority_critical",
"high": "rr_priority_high"
}
},
"no_reply_needed": {
"enabled": true,
"values": {
"true": "rr_no_reply_needed"
}
}
}ReplyRabbit normalise les libellés de tags en lettres minuscules, chiffres et traits de soulignement. Si un libellé personnalisé ne commence pas par le préfixe configuré, ReplyRabbit ajoute le préfixe.
Utilisez les tags dans les workflows FreeScout
Une fois les étiquettes appliquées, créez une petite recette de test dans FreeScout Workflows avant d'utiliser la configuration sur le routage en direct. Par exemple :
- Lorsqu'une conversation comporte
rr_priority_critical, attribuez-la au responsable du support urgent. - Lorsqu'une conversation comporte
rr_needs_human, ajoutez une note pour une vérification manuelle. - Lorsqu'une conversation comporte
rr_no_reply_needed, ignorez les recettes de suivi de réponse automatique. - Lorsqu'une conversation comporte
rr_linear_issue_created, informez l'équipe qu'un travail d'ingénierie existe.
Les noms exacts des déclencheurs et des conditions proviennent de votre module FreeScout Workflows installé. Utilisez les noms de balises de vos paramètres de boîte aux lettres ReplyRabbit, et non les exemples ci-dessus, si vous avez modifié le préfixe ou la correspondance.
Comportement de nettoyage
ReplyRabbit tient un registre des tags appliqués. Lorsque Supprimer les anciens tags ReplyRabbit est activé, il supprime les tags obsolètes uniquement lorsque ces deux conditions sont vraies :
- ReplyRabbit a précédemment appliqué le tag.
- L'état de source qui possède cette étiquette ne lui correspond plus.
Les étiquettes manuelles ne sont pas traitées comme des étiquettes ReplyRabbit obsolètes. Une étiquette créée par un agent ou un autre module est laissée intacte, sauf si ReplyRabbit a également appliqué et enregistré cette étiquette exacte pour la conversation.
Dépannage
| Symptôme | Ce qu'il faut vérifier |
|---|---|
| Les tags ne sont pas ajoutés | Confirmer Activer la synchronisation des workflows et Appliquer les tags FreeScout sont activés, puis enregistrez les paramètres de la boîte aux lettres. |
| Les étiquettes de signal sont manquantes | Confirmez que les AI Signals sont activés et que la conversation a été analysée. |
| Le tag Linear est manquant | Confirmez que la conversation a un ticket Linear créé par ReplyRabbit. |
| La recette Workflows ne s'exécute pas | Confirmez que la recette surveille le libellé de tag exact, puis testez si votre module Workflows réagit aux modifications de tags programmatiques. |
| Les anciennes étiquettes restent | Confirmer Supprimer les anciens tags ReplyRabbit est activé. ReplyRabbit ne supprime pas les tags qu'il n'a pas appliqués. |
| La table de tags ne s'enregistre pas | Vérifiez le formatage JSON et assurez-vous que les libellés de tags sont uniques. |
Pour des corrections plus larges, voir Dépannage de ReplyRabbit.
Confidentialité et traitement des données
Les étiquettes de workflow sont stockées comme étiquettes FreeScout sur la conversation. Elles peuvent révéler l'état du support, comme la priorité, l'intention, le sentiment, le statut sans réponse, la disponibilité du brouillon ou l'état du ticket Linear, à toute personne pouvant voir les étiquettes de la conversation.
L'étape d'étiquetage elle-même n'envoie pas de nouvelles données à un fournisseur d'IA. Les étiquettes dérivées des AI Signals dépendent de l'analyse AI Signals qui a déjà été exécutée pour la boîte aux lettres.
FAQ
ReplyRabbit nécessite-t-il le module FreeScout Workflows ?
Non. Workflow Tags étiquette toujours les conversations même lorsque le module Workflows n'est pas installé.
Les Workflows s'exécuteront-ils lorsque ReplyRabbit ajoute une étiquette ?
Cela dépend de votre module Workflows installé et du déclencheur de la recette. Testez une recette avant de vous y fier en production.
Puis-je modifier les noms des tags ?
Oui. Utilisez les paramètres Tag prefix et Automation tag map dans les paramètres de la boîte aux lettres ReplyRabbit.
ReplyRabbit supprimera-t-il les étiquettes ajoutées manuellement ?
Non. ReplyRabbit ne supprime que les étiquettes obsolètes qu'il a précédemment appliquées et enregistrées dans son propre registre.