Integrazione Workflow FreeScout
Funziona con Workflow FreeScout
Usa questa guida per configurare i Tag di workflow di ReplyRabbit. ReplyRabbit può trasformare i Segnali AI, lo stato delle bozze, le decisioni di non risposta e lo stato delle issue Linear in tag di FreeScout. Questi tag possono poi essere usati da agenti, report e ricette dei Workflow di FreeScout dove la tua installazione di Workflows reagisce ai cambiamenti dei tag.
Cerchi la panoramica?
Panoramica
I Tag dei Workflows sono un ponte tra ReplyRabbit e i tag di FreeScout. ReplyRabbit non sostituisce il motore di regole dei Workflows. Applica tag prevedibili come rr_priority_critical, rr_intent_billing, rr_no_reply_needed, rr_ai_draft_ready, e rr_linear_issue_created.
Se il modulo FreeScout Workflows è installato e reagisce alle modifiche programmatiche dei tag, gli amministratori possono creare ricette che controllano quei tag. Se Workflows non è installato, o se non rivaluta quando un modulo aggiunge tag, i tag appaiono comunque sulle conversazioni e nella barra laterale di ReplyRabbit per visibilità.
Prerequisiti
Prima di iniziare, assicurati di avere:
- Un'installazione FreeScout funzionante.
- ReplyRabbit installato e attivato.
- Accesso alle impostazioni della casella di posta in FreeScout.
- Segnali AI attivati se vuoi tag per priorità, sentiment, intento, affidabilità, necessità di revisione umana o opportunità di vendita.
- Linear configurato se vuoi il
rr_linear_issue_createdtag. - Il modulo Workflows di FreeScout installato se vuoi che le ricette agiscano sui tag.
Se ReplyRabbit non è ancora installato, inizia con Come installare il modulo ReplyRabbit, poi completa Come configurare ReplyRabbit.
Cosa può etichettare ReplyRabbit
| Origine | Tag di esempio | Note |
|---|---|---|
| Segnali AI | rr_priority_critical, rr_sentiment_negative, rr_intent_billing, rr_confidence_low, rr_needs_human, rr_sales_opportunity | Richiede AI Signals su Pro o Team. |
| Stato della bozza | rr_no_reply_needed, rr_ai_draft_ready | Basato sulla generazione di bozze e sulle decisioni di non risposta di ReplyRabbit. |
| Stato Linear | rr_linear_issue_created | Richiede una issue Linear collegata creata tramite ReplyRabbit. |
Il prefisso predefinito è rr_. Puoi modificarlo nelle impostazioni della casella di posta prima di salvare i Tag del flusso di lavoro.
Configura i Workflow Tags
Apri le impostazioni della casella di posta
In FreeScout, apri la casella che deve ricevere i tag ReplyRabbit, poi apri Impostazioni e scegli ReplyRabbit.Trova Workflow Tags
Scorri fino al Tag dei Workflows sezione.Abilita la sincronizzazione dei workflow
Attiva Abilita la sincronizzazione dei workflow.Applica tag FreeScout
Attiva Applica tag FreeScout così ReplyRabbit può scrivere i tag mappati.Revisione di creazione e pulizia
Esci Crea i tag quando mancano attivo se ReplyRabbit deve creare automaticamente i tag FreeScout mappati. Lascia Rimuovi le vecchie etichette ReplyRabbit attivo se i tag obsoleti di proprietà di ReplyRabbit devono essere rimossi quando lo stato di origine cambia.Rivedi la mappa delle etichette
Conferma che Prefisso dei tag, Conversazioni recenti da sincronizzare, e Mappa dei tag di automazione impostazioni, poi salva.
La modifica delle impostazioni dei Workflow Tags avvia una sincronizzazione limitata per le conversazioni recenti. Il limite deriva da Conversazioni recenti da sincronizzare, così le caselle di posta molto attive non devono rielaborare ogni conversazione storica.
Personalizza la mappa dei tag
Il Mappa dei tag di automazione il campo è JSON. Ogni chiave di segnale supportata può essere abilitata o disabilitata, e ogni valore mappa su un'etichetta di tag.
Usa la mappatura predefinita a meno che il tuo team non abbia motivo di rinominare i tag. Se la personalizzi, mantieni le etichette brevi e prevedibili così le ricette dei Workflow di FreeScout sono facili da leggere.
{
"priority": {
"enabled": true,
"values": {
"critical": "rr_priority_critical",
"high": "rr_priority_high"
}
},
"no_reply_needed": {
"enabled": true,
"values": {
"true": "rr_no_reply_needed"
}
}
}ReplyRabbit normalizza le etichette dei tag in lettere minuscole, numeri e caratteri di sottolineatura. Se un'etichetta personalizzata non inizia con il prefisso configurato, ReplyRabbit aggiunge il prefisso.
Usa i tag nei Workflow di FreeScout
Dopo che i tag vengono applicati, crea una piccola ricetta di test in FreeScout Workflows prima di usare la configurazione sul routing live. Ad esempio:
- Quando una conversazione ha
rr_priority_critical, assegnala al responsabile del supporto urgente. - Quando una conversazione ha
rr_needs_human, aggiungi una nota per la revisione manuale. - Quando una conversazione ha
rr_no_reply_needed, salta le ricette di follow-up con risposta automatica. - Quando una conversazione ha
rr_linear_issue_created, avvisa il team che esiste un lavoro di ingegneria.
I nomi esatti dei trigger e delle condizioni provengono dal modulo FreeScout Workflows installato. Usa i nomi dei tag dalle impostazioni della tua casella ReplyRabbit, non gli esempi sopra, se hai cambiato il prefisso o la mappa.
Comportamento di pulizia
ReplyRabbit mantiene un registro dei tag applicati. Quando Rimuovi le vecchie etichette ReplyRabbit è attivo, rimuove i tag obsoleti solo quando entrambe queste condizioni sono vere:
- ReplyRabbit ha applicato in precedenza il tag.
- Lo stato di origine che possiede quel tag non lo mappa più.
Le etichette manuali non sono trattate come etichette ReplyRabbit obsolete. Un'etichetta creata da un agente o da un altro modulo viene lasciata stare a meno che ReplyRabbit abbia anche applicato e registrato quella esatta etichetta per la conversazione.
Risoluzione dei problemi
| Sintomo | Cosa controllare |
|---|---|
| I tag non vengono aggiunti | Conferma Abilita la sincronizzazione dei workflow e Applica tag FreeScout sono attivi, poi salva le impostazioni della casella. |
| Mancano i tag dei segnali | Conferma che AI Signals sia abilitato e che la conversazione sia stata analizzata. |
| Manca il tag Linear | Conferma che la conversazione abbia un ticket Linear creato da ReplyRabbit. |
| La ricetta dei Workflows non viene eseguita | Conferma che la ricetta controlli l'etichetta esatta del tag, poi verifica se il tuo modulo Workflows reagisce alle modifiche programmatiche dei tag. |
| I vecchi tag restano | Conferma Rimuovi le vecchie etichette ReplyRabbit è attivo. ReplyRabbit non rimuove i tag che non ha applicato. |
| La mappa dei tag non verrà salvata | Controlla la formattazione JSON e assicurati che le etichette dei tag siano univoche. |
Per correzioni più ampie, vedi Risoluzione dei problemi di ReplyRabbit.
Privacy e gestione dei dati
I Tag dei Workflows sono archiviati come tag FreeScout sulla conversazione. Possono rivelare lo stato del supporto, come priorità, intento, sentiment, stato senza risposta, prontezza della bozza o stato del ticket Linear, a chiunque possa vedere i tag della conversazione.
Il passaggio di tagging stesso non invia nuovi dati a un provider AI. I tag derivati da AI Signals dipendono dall'analisi AI Signals già eseguita per la casella.
FAQ
ReplyRabbit richiede il modulo FreeScout Workflows?
No. I Workflow Tags etichettano comunque le conversazioni anche quando il modulo Workflows non è installato.
I Workflows verranno eseguiti quando ReplyRabbit aggiunge un tag?
Dipende dal modulo Workflows installato e dal trigger della recipe. Prova una recipe prima di affidartici in produzione.
Posso cambiare i nomi dei tag?
Sì. Usa le impostazioni Tag prefix e Automation tag map nelle impostazioni della casella ReplyRabbit.
ReplyRabbit rimuoverà i tag aggiunti manualmente?
No. ReplyRabbit rimuove solo i tag obsoleti che ha applicato in precedenza e registrato nel proprio registro.