 |
Сводка | Создание тикетов Zendesk из тем Discourse. |
 |
Руководство по установке | Этот плагин поставляется в составе ядра Discourse. Отдельная установка плагина не требуется. |
Поскольку Zendesk постоянно отключит аутентификацию по токенам API 30 апреля 2027 года, существующим установкам необходимо перейти на аутентификацию через OAuth.
Функции
Создание тикетов Zendesk
Этот плагин позволяет создавать тикеты Zendesk из тем Discourse. Это можно сделать, настроив плагин так, чтобы все темы в категории автоматически генерировали тикеты Zendesk, или отправив отдельные темы в Zendesk, нажав кнопку «Создать тикет Zendesk», которая отображается для персонала сайта под каждой темой:
При создании тикета автор первого сообщения в теме будет указан в качестве Запросителя (Requester) в Zendesk. Он также будет добавлен в ваш список клиентов Zendesk.
После создания тикета кнопка «Создать тикет Zendesk» будет обновлена на «Просмотреть в Zendesk». Нажатие этой кнопки перенаправит вас на соответствующий тикет Zendesk:
Отправка ответов, созданных в Discourse, в Zendesk
Плагин позволяет по желанию отправлять все ответы на тему Discourse в тикет Zendesk или отправлять только ответы, созданные автором темы. Обе эти функции настраиваются в параметрах плагина.
Синхронизация комментариев Zendesk с Discourse
Комментарии Zendesk могут быть синхронизированы с темой Discourse, из которой был создан тикет.
Конфигурация
Настройки Discourse Zendesk доступны на странице Плагинов в административной части вашего сайта Discourse. Нажмите кнопку «Настройки» для записи «discourse-zendesk-plugin» на этой странице.
Настройка OAuth
Сначала создайте OAuth-клиент в Zendesk:
- В Zendesk Admin Center перейдите в Приложения и интеграции > API > OAuth-клиенты.
- Нажмите Добавить OAuth-клиент.
- Введите имя, описание и выберите Confidential (Конфиденциальный) как тип клиента. URL перенаправления не требуется.
- Настройте Области действия (Scopes) на
tickets:read,tickets:write,users:readиusers:write, чтобы ограничить OAuth-клиент только теми областями действия, которые требуются плагину. - Сохраните клиента.
- Скопируйте Идентификатор и Секрет клиента. Zendesk отображает полный секрет только один раз.
Настройте эти параметры Discourse:
zendesk oauth client id: введите Идентификатор OAuth-клиента.zendesk oauth client secret: введите Секрет OAuth-клиента.
Другие настройки
-
zendesk url: введите URL вашего аккаунта Zendesk, за которым следует/api/v2. Например,https://example.zendesk.com/api/v2. -
zendesk enabled: включить или отключить плагин. -
zendesk jobs api token: Устарело. Существующим установкам следует перейти на OAuth. -
zendesk jobs email: Устарело. Существующим установкам следует перейти на OAuth. -
zendesk autogenerate all categories(ранееzendesk enable all categories): автоматически создавать тикеты Zendesk для тем в каждой категории. По умолчанию эта настройка отключена. -
zendesk autogenerate categories(ранееzendesk enabled categories): выберите категории Discourse, для новых тем в которых должны автоматически создаваться тикеты Zendesk. -
zendesk job push all posts: отправлять ответы в Zendesk в качестве комментариев к тикету. По умолчанию эта настройка включена. -
zendesk job push only author posts: отправлять только ответы, написанные первоначальным автором темы. Эта настройка применяется, когда включенаzendesk job push all posts, и по умолчанию отключена. -
sync comments from zendeskиzendesk incoming webhook token: синхронизировать комментарии из Zendesk с Discourse. См. Как включить двустороннюю синхронизацию с Zendesk. -
zendesk tags: необязательный список тегов для добавления к тикетам Zendesk, созданным из Discourse.