Интеграция GitHub Issues
Работает с GitHub
Подключите ReplyRabbit к GitHub Issues, чтобы обращения в поддержку во FreeScout становились структурированными задачами в нужном репозитории. Агенты могут создать задачу из обращения, держать связанную задачу видимой во FreeScout и позволить ReplyRabbit подготовить передачу в разработку.
Ищете обзор?
Обзор
Интеграция GitHub Issues добавляет панель GitHub в ReplyRabbit в переписке FreeScout. Когда GitHub настроен, ReplyRabbit может создать задачу с удобным для разработчика заголовком, полезной сводкой, метками, исполнителями, контекстом репозитория и ссылкой обратно на переписку поддержки.
Каждый почтовый ящик выбирает один трекер задач: нет, Linear или GitHub. GitHub и Linear это альтернативы для одного и того же рабочего процесса от поддержки к инженерии, а не два трекера, работающих вместе в одном почтовом ящике.
Ручное создание задач GitHub доступно на Pro и Team. Автоматическое создание задач GitHub из новых писем клиентов доступно на Team.
Предварительные требования
Перед началом убедитесь, что у вас есть:
- Работающая установка FreeScout.
- ReplyRabbit установлен и активирован.
- Тариф ReplyRabbit, включающий нужную вам функцию GitHub.
- Доступ к учётной записи или организации GitHub, где должны создаваться задачи.
- Репозиторий с включёнными GitHub Issues.
Если ReplyRabbit ещё не установлен, начните с Как установить модуль ReplyRabbit, затем завершите Как настроить ReplyRabbit.
Разрешения и область действия токена
ReplyRabbit подключается к GitHub с помощью personal access token, который вы указываете в настройках почтового ящика. Рекомендуется fine-grained token, ограниченный репозиториями, которые должен использовать ReplyRabbit. Вы можете создать его на Настройки детализированного токена GitHub.
Предоставьте токену достаточно доступа для чтения метаданных репозитория, чтения меток и исполнителей, создания и обновления задач и добавления комментариев к задачам. Для детализированного токена начните с Метаданные: чтение, Содержание: чтение, и Задачи: чтение и запись для выбранных репозиториев.
Для более строгих аудиторских следов создайте токен из выделенной учётной записи GitHub-бота, у которой есть доступ только к репозиториям, которые должен использовать ReplyRabbit.
Держите токен в тайне. Если токен ротирован или удалён в GitHub, обновите настройки почтового ящика перед созданием новых задач.
Подключить GitHub Issues
Откройте настройки почтового ящика
В FreeScout откройте почтовый ящик, который должен создавать задачи GitHub, затем откройте Настройки и выберите ReplyRabbit.Выберите GitHub в качестве трекера задач
В селекторе трекера задач выберите GitHub Issues. ReplyRabbit показывает настройки GitHub и скрывает настройки Linear для этого почтового ящика.Вставьте токен
Вставьте ваш Личный токен доступа GitHub. Если вы уже сохранили токен, ReplyRabbit показывает замаскированный предварительный просмотр вместо полного секрета.Загрузить репозитории
Нажмите кнопку, чтобы загрузить репозитории из GitHub, затем выберите репозиторий по умолчанию, где должны создаваться новые задачи.Сохранить настройки
Сохраните настройки почтового ящика. ReplyRabbit сохранит подключение GitHub для этого почтового ящика.
Настроить значения по умолчанию
После выбора репозитория по умолчанию настройте значения по умолчанию для задач, с которых должны начинать ваши агенты:
- Репозиторий по умолчанию: выберите, где создаются задачи, когда ни одно правило маршрутизации не совпадает.
- Автоматическая отправка задач: на тарифе Team, позвольте ReplyRabbit автоматически создавать задачи GitHub, когда результат триажа говорит, что нужна инженерная работа.
- Маршрутизация репозиториев: включите автоматический выбор репозитория, если хотите, чтобы ReplyRabbit сопоставлял диалоги с доступными репозиториями.
- Сопоставления доменов: сопоставьте домены email клиентов с конкретными репозиториями, когда нужна детерминированная маршрутизация.
- Метки: выберите метки, которые ReplyRabbit может применять для типа задачи, приоритета или других тегов рабочего процесса.
- Метки приоритета: сопоставьте уровни приоритета ReplyRabbit с метками GitHub, так как в GitHub Issues нет собственного поля приоритета.
- Исполнитель по умолчанию: выберите пользователя GitHub, который должен по умолчанию получать новые задачи.
- Уведомление о проверке: когда включено автоматическое создание задач, добавьте заметку FreeScout, которая сообщает агентам, что задача была создана автоматически и должна быть проверена.
Маршрутизация репозиториев необязательна. Если ни один репозиторий не сопоставлен уверенно, ReplyRabbit использует репозиторий по умолчанию.
Создать задачу GitHub из обращения FreeScout
Откройте разговор в почтовом ящике, где настроен GitHub. Панель ReplyRabbit может создать issue GitHub из ветки клиента, а затем показать привязанный issue в FreeScout.
Содержимое задачи генерируется для инженерной передачи, а не копируется вслепую из всей цепочки писем. При ручном создании проверьте заголовок, сводку, метки, исполнителей и репозиторий перед созданием задачи.
ReplyRabbit также может добавить контекст почтовой переписки в виде комментария к задаче GitHub, чтобы инженеры получили данные клиента без просьб к поддержке снова вставить ту же переписку.
Держите переписки и задачи синхронизированными
После привязки issue разговор в FreeScout может показывать текущий идентификатор issue GitHub, заголовок, состояние, метки и исполнителей. Агенты могут открыть issue в GitHub, когда им нужен полный инженерный обзор.
ReplyRabbit также поддерживает цикл завершения: он проверяет связанные задачи GitHub по расписанию, обычно каждые 5 минут. Когда GitHub закрывает задачу, ReplyRabbit может помочь составить черновик ответа клиенту, чтобы поддержка могла закрыть разговор с контекстом. Если ваша команда использует причины закрытия GitHub, вы можете ограничить черновики завершения задачами, закрытыми как completed.
Устранение неполадок
| Симптом | Что проверить |
|---|---|
| Репозитории не загрузятся | Подтвердите, что токен актуален и имеет доступ к выбранным репозиториям GitHub. |
| Задачи не создаются | Убедитесь, что GitHub выбран в качестве трекера задач, выбран репозиторий по умолчанию и ваш тариф ReplyRabbit включает эту функцию. |
| Автоматические задачи не создаются | Подтвердите, что вы на тарифе Team и Автоматическая отправка задач включена. |
| Репозиторий неверный или отсутствует | Убедитесь, что маршрутизация репозиториев или сопоставления доменов настроены. ReplyRabbit использует репозиторий по умолчанию, если нет уверенного совпадения. |
| Метки или исполнители не обновятся | Перезагрузите разговор, затем убедитесь, что токен по-прежнему имеет доступ к связанному репозиторию. |
| GitHub возвращает ошибки ограничения скорости | Дождитесь сброса лимита GitHub API для токена, затем рассмотрите сужение доступа к репозиториям или сокращение автоматической активности по задачам. |
| Закрытые задачи не создают черновики | Подтвердить Авточерновик при завершении включена и, если включён режим только завершённых, задача GitHub была закрыта как завершённая. |
Для более широких исправлений см. Устранение неполадок ReplyRabbit.
Конфиденциальность и обработка данных
ReplyRabbit отправляет в GitHub содержимое задачи, необходимое для инженерной передачи. Оно может включать релевантный контекст клиента, сгенерированный заголовок задачи, сгенерированную сводку, метки, исполнителей и ссылку или идентификатор переписки FreeScout.
Не помещайте конфиденциальную информацию в задачу GitHub, если репозиторию не разрешено её получать. Если данные клиентов должны полностью оставаться на вашем собственном сервере, оставьте GitHub отключённым для этого почтового ящика.
Следующие шаги
- Продолжить с Как настроить ReplyRabbit если почтовому ящику всё ещё нужны настройки провайдера, контекста или стиля.
- Чтение Интеграция со Slack если ваша команда хочет создание задач или уведомления о завершении в Slack.
- Сравнить с Интеграция с Linear если вы решаете, какой трекер задач должен использовать почтовый ящик.
FAQ
Нужен ли мне персональный токен доступа GitHub?
Да. ReplyRabbit подключается к GitHub с токеном из вашей собственной учётной записи или организации GitHub.
Может ли один почтовый ящик использовать Linear и GitHub одновременно?
Нет. Каждый почтовый ящик выбирает один трекер задач: нет, Linear или GitHub.
Может ли ReplyRabbit выбрать репозиторий GitHub?
Да, когда настроена маршрутизация репозиториев. ReplyRabbit поддерживает сопоставление по домену и подбор репозиториев ИИ для репозиториев, к которым имеет доступ ваш токен.
Какой план включает GitHub Issues?
Ручное создание задач GitHub — функция Pro. Автоматическое создание задач GitHub — функция Team.
Отправляет ли ReplyRabbit весь разговор с клиентом в GitHub?
ReplyRabbit отправляет содержимое задачи, необходимое для инженерной передачи, включая релевантный контекст клиента и сгенерированную сводку.