# Включение двусторонней синхронизации с Zendesk

**URL:** https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412
**Category:** Integrations
**Tags:** zendesk, how-to, platforms
**Created:** [27.Январь.2021 09:37:02 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412 "2021-01-27T09:37:02Z")
**Posts on this page:** 11
**Page:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [27.Январь.2021 09:37:02 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/1 "2021-01-27T09:37:02Z")

</div>

## Краткое описание

В этой документации мы рассмотрим:

- Включение настроек синхронизации Zendesk в Discourse
- Настройку вебхука Zendesk
- Создание триггера Zendesk

## Включение настроек синхронизации Zendesk

Для начала вам нужно включить плагин Zendesk, активировать настройку синхронизации и предоставить безопасный токен.

1. **Переход к настройкам плагина** : Зайдите на ваш сайт Discourse и перейдите на страницу настроек плагина Zendesk по адресу `/admin/plugins/discourse-zendesk-plugin`. Альтернативно, вы можете найти настройки, выполнив поиск на странице `/admin/site_settings`.
2. **Включение плагина** : Найдите и включите настройку `zendesk enabled`, если она ещё не активна.
3. **Включение настройки синхронизации** : Найдите и включите настройку `sync comments from zendesk`.
4. **Указание токена вебхука** : В поле `zendesk incoming webhook token` сгенерируйте и добавьте случайную безопасную строку. Этот токен будет использоваться позже при настройке вебхука Zendesk.
5. **Настройка категорий для автогенерации** : Двусторонняя синхронизация работает только для тем в категориях, настроенных для автоматической генерации тикетов Zendesk. Либо включите `zendesk autogenerate all categories`, либо добавьте конкретные категории в настройку `zendesk autogenerate categories`. Без этого вебхук будет молча игнорировать входящие комментарии.

## Настройка вебхука Zendesk

Следуйте этим шагам для настройки вебхука в Zendesk:

1. **Переход к странице вебхуков** : Перейдите в раздел Webhooks в Zendesk в меню **Apps and integrations** → **Webhooks**.
  - Пример URL: `https://<instance_name>.zendesk.com/admin/apps-integrations/webhooks/webhooks`

2. **Создание вебхука** :
  - Нажмите кнопку **Actions** в правом верхнем углу.
  - Выберите **Create Webhook**.
  - Заполните данные вебхука:
    - **Request method** : `PUT`
    - **Endpoint URL** : `https://<discourse.example.com>/zendesk-plugin/sync`
    - **Request format** : JSON

 ![Create a Webhook](https://global.discourse-cdn.com/meta/original/4X/2/a/2/2a2e0d03d021cb8937e4b4f21239919a395550f6.png)  
 ![Webhook Details](https://global.discourse-cdn.com/meta/original/4X/0/7/6/076f149e1de36f34b13fefa2443e19acea5907f6.jpeg)

1. **Тестирование вебхука** :
  - Нажмите кнопку **Test Webhook**.
  - В выпадающем списке выберите ‘Custom Test’.
  - Замените JSON следующим содержимым, вставив ваш токен:

```plaintext
     {
         "ticket_id": "{{ticket.id}}",
         "topic_id": "{{ticket.external_id}}",
         "email": "{{current_user.email}}",
         "token": "INSERT TOKEN HERE"
     }

```

- Нажмите **Send Test**. Ожидайте ответ `400 Bad Request` как положительный сигнал: на экране должна отобразиться HTML-страница, указывающая на успех.

## Настройка триггера Zendesk

Настройте триггер в Zendesk для автоматизации действий:

1. **Переход к странице триггеров** : Перейдите в раздел Triggers в Zendesk в меню **Admin** → **Objects and Rules** → **Business Rules** → **Triggers**.
  - Пример URL: `https://<instance_name>.zendesk.com/admin/objects-rules/rules/triggers`

2. **Создание триггера** :
  - Нажмите **Add trigger**.
  - Назовите его “Discourse Sync” и установите категорию “Notifications”.
  - Настройте условия и действия, как показано ниже.

 ![Add a Trigger](https://global.discourse-cdn.com/meta/original/4X/e/1/9/e192f9d1a81e24fd7710bfa45921e9bb4d6b512b.png)  
 ![Trigger Conditions](https://global.discourse-cdn.com/meta/original/4X/c/d/8/cd8b59868b7bf08d101a3a60f8a8c23e6f7ea938.jpeg)  
 ![Trigger Actions](https://global.discourse-cdn.com/meta/original/4X/3/2/8/328a00cfc8e4f2f8b14e3ad1c121b35607204543.png)

- Используйте то же тело JSON, что и на шаге тестирования вебхука, снова заменив “INSERT TOKEN HERE” на ваш токен.

1. **Сохранение триггера** : После настройки обязательно сохраните триггер.

---

<div class="post-metadata">

### Author: ![Becca](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/becca/32/210785_2.png) [@Becca](https://meta.discourse.org/u/Becca)
#### Post date: [23.Февраль.2021 08:23:53 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/2 "2021-02-23T08:23:53Z")

</div>

Привет @techAPJ, это действительно здорово! Есть ли возможность настроить триггерную синхронизацию вместо синхронизации в реальном времени? То есть, чтобы агент добавлял тег в ZD или нажимал кнопку, и только после этого тикет синхронизировался с сообществом?  
Мы пытаемся найти лучший способ делиться общими тикетами с FAQ, которые мы получаем в ZD, с сообществом в разделе «Вопросы и ответы», чтобы пользователи могли находить ответы там, а не создавать новые тикеты.  
Спасибо!

---

<div class="post-metadata">

### Author: ![techAPJ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/techapj/32/342990_2.png) [@techAPJ](https://meta.discourse.org/u/techAPJ)
#### Post date: [23.Февраль.2021 11:29:38 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/3 "2021-02-23T11:29:38Z")

</div>

На данный момент у нас есть только одна триггерная синхронизация — из Discourse в Zendesk.

Запуск ручной синхронизации из Zendesk в Discourse сложен, поскольку у нас нет полного контроля над Zendesk. Тем не менее, я изучу возможность запуска вебхука из Zendesk, например, путём добавления тега.

---

<div class="post-metadata">

### Author: ![juliafagelman](https://avatars.discourse-cdn.com/v4/letter/j/b9bd4f/32.png) [@juliafagelman](https://meta.discourse.org/u/juliafagelman)
#### Post date: [25.Март.2021 16:26:27 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/4 "2021-03-25T16:26:27Z")

</div>

@techAPJ вы когда-нибудь рассматривали синхронизацию между ZD и Discourse? Мы ищем способы переноса FAQ из тикетов Zendesk в Discourse!

---

<div class="post-metadata">

### Author: ![marladalmau](https://avatars.discourse-cdn.com/v4/letter/m/f08c70/32.png) [@marladalmau](https://meta.discourse.org/u/marladalmau)
#### Post date: [23.Июль.2024 23:47:58 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/6 "2024-07-23T23:47:58Z")

</div>

Привет! Я всё настроил, но работает только в направлении от Discourse к Zendesk. Не понимаю, чего мне не хватает, чтобы мои ответы в Zendesk публиковались в Discourse.

---

<div class="post-metadata">

### Author: ![mc.elias](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/mc.elias/32/449006_2.png) [@mc.elias](https://meta.discourse.org/u/mc.elias)
#### Post date: [25.Июль.2024 19:48:26 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/7 "2024-07-25T19:48:26Z")

</div>

Привет, я здесь с Марлой ^^^. Нам удалось заставить плагин работать! 🎉

Но у нас возник вопрос: **можно ли как-то продолжить двустороннюю синхронизацию, если тема будет перемещена в личные сообщения?** Иногда наши участники запрашивают сброс пароля, и мы хотели бы продолжать общение внутри сообщества.

---

<div class="post-metadata">

### Author: ![abinash889](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/abinash889/32/444102_2.png) [@abinash889](https://meta.discourse.org/u/abinash889)
#### Post date: [27.Август.2024 03:22:38 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/9 "2024-08-27T03:22:38Z")

</div>

Я попробовал описанный выше процесс, и он работает отлично! 🥳 Однако возникла проблема: когда в комментарии в Zendesk есть вложение, само сообщение приходит, но вложение отсутствует. Не уверен, нужно ли передавать дополнительный параметр в вебхуке для обработки вложений. Не могли бы вы прояснить, требуются ли для этого какие-то специфические параметры?

Спасибо!

---

<div class="post-metadata">

### Author: ![Zandr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/zandr/32/445472_2.png) [@Zandr](https://meta.discourse.org/u/Zandr)
#### Post date: [30.Август.2024 22:00:13 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/10 "2024-08-30T22:00:13Z")

</div>

Я только что настроил плагин Zendesk, и он отлично работает. Я хотел бы включить двустороннюю синхронизацию комментариев, но при этом не хочу автоматически создавать заявки в Zendesk… никогда, если честно.

Кажется, что синхронизация комментариев из ZD → Discourse требует включения автоматического создания заявок. Так ли это, или есть какое-то обходное решение?

---

<div class="post-metadata">

### Author: ![Oliver\_Breidenbach](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/oliver_breidenbach/32/256392_2.png) [@Oliver\_Breidenbach](https://meta.discourse.org/u/Oliver_Breidenbach)
#### Post date: [05.Октябрь.2024 21:31:48 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/11 "2024-10-05T21:31:48Z")

</div>

Я включил плагин Zendesk, и создание тикетов в Zendesk работает. Однако вебхук, указанный в документации выше (https:///zendesk-plugin/sync), возвращает ошибку 404 при тестировании со страницы настройки вебхука в Zendesk. В результате я не могу обновлять сообщения на форуме из Zendesk. Что я делаю не так?

---

<div class="post-metadata">

### Author: ![Oliver\_Breidenbach](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/oliver_breidenbach/32/256392_2.png) [@Oliver\_Breidenbach](https://meta.discourse.org/u/Oliver_Breidenbach)
#### Post date: [05.Октябрь.2024 21:32:58 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/12 "2024-10-05T21:32:58Z")

</div>

Ещё один вопрос: если я закрываю тикет в Zendesk, а кто-то отвечает на пост в Discourse, закрытый тикет не открывается заново, и я пропускаю новый пост. Есть какие-то советы?

---

<div class="post-metadata">

### Author: ![MarkDoerr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/markdoerr/32/549630_2.png) [@MarkDoerr](https://meta.discourse.org/u/MarkDoerr)
#### Post date: [26.Декабрь.2024 22:24:33 UTC](https://meta.discourse.org/t/enabling-zendesk-two-way-synchronization/177412/13 "2024-12-26T22:24:33Z")

</div>

Привет, Оливер,

> [@Оливер Брайденбах](#):
>
> Вебхук в документации выше (https:///zendesk-plugin/sync) возвращает ошибку 404, когда я тестирую его со страницы настройки вебхуков в Zendesk.

Я уверен, что вы уже это поняли, но URL синхронизации должен включать ваш домен. То есть вместо просто `https:///zendesk-plugin/sync` это может выглядеть примерно так: `https://forum.yoursite.com/zendesk-plugin/sync`.

> [@Оливер Брайденбах](#):
>
> Если я закрываю тикет в Zendesk, а кто-то отвечает на пост в Discourse, закрытый тикет не открывается заново, и я пропускаю новый пост.

Даже после установки статуса тикета на «Решено» вы всё равно должны видеть любые ответы из Discourse в тикете ZD. Вам просто нужно будет найти этот тикет. 🙂

Например, на моём тестовом сайте я создал пост, из которого был автоматически создан тикет в ZD. Я пометил тикет как «Решено», а затем ответил на тему в Discourse. В результате я получил комментарий в тикете ZD:

 ![Screenshot 2024-12-26 at 2.22.17 PM](https://global.discourse-cdn.com/meta/original/4X/f/1/a/f1a03b686087ad0f8cab1077c1c05cdb5c011fff.jpeg)