Интеграция с рабочими процессами FreeScout
Работает с Рабочие процессы FreeScout
Используйте это руководство, чтобы настроить теги рабочих процессов ReplyRabbit. ReplyRabbit может превращать AI Signals, состояние черновика, решения об отсутствии ответа и состояние задачи Linear в теги FreeScout. Затем эти теги могут использоваться агентами, отчётами и рецептами рабочих процессов FreeScout, где ваша установка Workflows реагирует на изменения тегов.
Ищете обзор?
Обзор
Теги Workflow это мост между ReplyRabbit и тегами FreeScout. ReplyRabbit не заменяет движок правил Workflows. Он применяет предсказуемые теги, такие как rr_priority_critical, rr_intent_billing, rr_no_reply_needed, rr_ai_draft_ready, и rr_linear_issue_created.
Если модуль FreeScout Workflows установлен и реагирует на программные изменения тегов, администраторы могут создавать рецепты, которые отслеживают эти теги. Если Workflows не установлен или не переоценивает ситуацию, когда модуль добавляет теги, теги всё равно отображаются в переписках и на боковой панели ReplyRabbit для наглядности.
Предварительные требования
Перед началом убедитесь, что у вас есть:
- Работающая установка FreeScout.
- ReplyRabbit установлен и активирован.
- Доступ к настройкам почтового ящика в FreeScout.
- AI Signals включён, если вам нужны теги для приоритета, тональности, намерения, уверенности, необходимости проверки человеком или возможности продажи.
- Linear настроен, если вы хотите
rr_linear_issue_createdтег. - Модуль FreeScout Workflows установлен, если вы хотите, чтобы рецепты действовали на теги.
Если ReplyRabbit ещё не установлен, начните с Как установить модуль ReplyRabbit, затем завершите Как настроить ReplyRabbit.
Что ReplyRabbit может помечать тегами
| Источник | Примеры тегов | Заметки |
|---|---|---|
| AI Signals | rr_priority_critical, rr_sentiment_negative, rr_intent_billing, rr_confidence_low, rr_needs_human, rr_sales_opportunity | Требуется AI Signals на Pro или Team. |
| Состояние черновика | rr_no_reply_needed, rr_ai_draft_ready | На основе генерации черновиков ReplyRabbit и решений об отсутствии ответа. |
| Состояние Linear | rr_linear_issue_created | Требуется связанный issue Linear, созданный через ReplyRabbit. |
Префикс по умолчанию: rr_. Вы можете изменить его в настройках почтового ящика перед сохранением Workflow Tags.
Настроить Workflow Tags
Откройте настройки почтового ящика
В FreeScout откройте почтовый ящик, который должен получать теги ReplyRabbit, затем откройте Настройки и выберите ReplyRabbit.Найдите Workflow Tags
Прокрутите до Теги Workflow раздел.Включить синхронизацию workflow
Включить Включить синхронизацию workflow.Применить теги FreeScout
Включить Применить теги FreeScout чтобы ReplyRabbit мог записывать сопоставленные теги.Проверка создания и очистки
Покинуть Создавать теги при отсутствии включите, если ReplyRabbit должен автоматически создавать сопоставленные теги FreeScout. Оставьте Удалить старые метки ReplyRabbit включите, если устаревшие теги, принадлежащие ReplyRabbit, должны удаляться при изменении состояния источника.Проверить карту тегов
Подтвердите Префикс тега, Недавние разговоры для синхронизации, и Карта тегов автоматизации настройки, затем сохраните.
Изменение настроек Workflow Tags запускает ограниченную синхронизацию недавних разговоров. Лимит берётся из Недавние разговоры для синхронизации, поэтому загруженным почтовым ящикам не нужно повторно обрабатывать каждую историческую беседу.
Настроить карту тегов
The Карта тегов автоматизации поле имеет формат JSON. Каждый поддерживаемый ключ сигнала можно включить или отключить, и каждое значение сопоставляется с меткой тега.
Используйте сопоставление по умолчанию, если у вашей команды нет причины переименовывать теги. Если вы его настраиваете, делайте метки короткими и предсказуемыми, чтобы рецепты рабочих процессов FreeScout было легко читать.
{
"priority": {
"enabled": true,
"values": {
"critical": "rr_priority_critical",
"high": "rr_priority_high"
}
},
"no_reply_needed": {
"enabled": true,
"values": {
"true": "rr_no_reply_needed"
}
}
}ReplyRabbit приводит метки тегов к строчным буквам, цифрам и подчёркиваниям. Если пользовательская метка не начинается с настроенного префикса, ReplyRabbit добавляет префикс.
Используйте теги в рабочих процессах FreeScout
После того как теги начали применяться, создайте небольшой тестовый рецепт в FreeScout Workflows, прежде чем использовать настройку в рабочей маршрутизации. Например:
- Когда в переписке есть
rr_priority_critical, назначьте его ответственному за срочную поддержку. - Когда в переписке есть
rr_needs_human, добавьте заметку для ручной проверки. - Когда в переписке есть
rr_no_reply_needed, пропустите рецепты последующих действий с автоответом. - Когда в переписке есть
rr_linear_issue_created, уведомите команду о наличии инженерной работы.
Точные названия триггеров и условий берутся из установленного у вас модуля FreeScout Workflows. Используйте названия тегов из настроек вашего почтового ящика ReplyRabbit, а не примеры выше, если вы изменили префикс или карту.
Поведение очистки
ReplyRabbit ведёт журнал применённых тегов. Когда Удалить старые метки ReplyRabbit включена, он удаляет устаревшие теги только когда оба условия верны:
- ReplyRabbit ранее применил тег.
- Состояние источника, которому принадлежит этот тег, больше не сопоставляется с ним.
Ручные метки не считаются устаревшими метками ReplyRabbit. Метка, созданная агентом или другим модулем, остаётся нетронутой, если только ReplyRabbit также не применил и не записал именно эту метку для переписки.
Устранение неполадок
| Симптом | Что проверить |
|---|---|
| Теги не добавляются | Подтвердить Включить синхронизацию workflow и Применить теги FreeScout включены, затем сохраните настройки почтового ящика. |
| Теги сигналов отсутствуют | Убедитесь, что AI Signals включён и разговор проанализирован. |
| Отсутствует тег Linear | Убедитесь, что у разговора есть задача Linear, созданная ReplyRabbit. |
| Рецепт Workflows не выполняется | Убедитесь, что рецепт отслеживает точную метку тега, затем проверьте, реагирует ли ваш модуль Workflows на программные изменения тегов. |
| Старые метки остаются | Подтвердить Удалить старые метки ReplyRabbit включена. ReplyRabbit не удаляет теги, которые он не применял. |
| Карта тегов не сохраняется | Проверьте форматирование JSON и убедитесь, что метки тегов уникальны. |
Для более широких исправлений см. Устранение неполадок ReplyRabbit.
Конфиденциальность и обработка данных
Теги Workflow хранятся как теги FreeScout в переписке. Они могут раскрывать состояние поддержки, такое как приоритет, намерение, тональность, статус без ответа, готовность черновика или состояние задачи Linear, любому, кто может видеть теги переписки.
Сам шаг тегирования не отправляет новые данные AI-провайдеру. Теги, полученные из AI Signals, зависят от анализа AI Signals, который уже выполнялся для почтового ящика.
FAQ
Требует ли ReplyRabbit модуль FreeScout Workflows?
Нет. Workflow Tags по-прежнему помечают разговоры, даже если модуль Workflows не установлен.
Будут ли выполняться Workflows, когда ReplyRabbit добавляет тег?
Это зависит от установленного у вас модуля Workflows и триггера рецепта. Протестируйте один рецепт, прежде чем полагаться на него в продакшене.
Можно ли изменить названия тегов?
Да. Используйте настройки Tag prefix и Automation tag map в настройках почтового ящика ReplyRabbit.
Удалит ли ReplyRabbit теги, добавленные вручную?
Нет. ReplyRabbit удаляет только устаревшие метки, которые он ранее применил и записал в свой собственный журнал.