Отправляйте события Notiondesk в ваше приложение с помощью веб-хуков.

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

1 мин чтения

Веб-хук отправляет запрос на ваш сервер каждый раз, когда что-то происходит в Notiondesk, например, появляется новое сообщение от контакта или публикуется статья. Используйте его, чтобы поддерживать актуальность вашей CRM-системы, хранилища данных или внутренних инструментов, не проверяя Notiondesk самостоятельно.

Быстрый способ: перейдите в Настройки > Разработчики > Веб-перехватчики , нажмите Добавить конечную точку , введите свой URL-адрес и выберите события.

Прежде чем начать

  • Вы являетесь владельцем рабочего пространства или администратором. Пользователи с другими ролями не могут открыть страницу веб-хуков.
  • На вашем сервере есть публичный адрес, начинающийся с https://, использующий доменное имя (а не IP-адрес) и принимающий POST-запросы.

Добавить конечную точку

  1. В панели управления Notiondesk нажмите «Настройки» .
  1. В разделе «Рабочая область» откройте «Разработчики» , затем «Веб-перехватчики» .
  1. Нажмите «Добавить конечную точку» .
  1. Введите URL-адрес , на который должны поступать запросы, например, https://hooks.acme-support.com/notiondesk.
  1. Введите имя , указывающее на назначение конечной точки, например, CRM sync.
  1. В разделе «События» нажмите «Добавить событие» и выберите события, которые должна получать эта конечная точка. Введите текст в поле поиска, чтобы быстро найти нужное событие.
  1. Нажмите «Добавить конечную точку» .

Одна конечная точка получает события из вашего рабочего пространства и из каждого центра поддержки в нем, поэтому вам не нужна отдельная точка для каждого центра поддержки. Вы можете добавить до 10 конечных точек.

Скопируйте секретный ключ подписи.

Сразу после добавления конечной точки Notiondesk отображает свой секретный ключ подписи. Ваш сервер использует его для проверки того, что каждый запрос действительно поступает от Notiondesk.

  1. Нажмите «Копировать» .
  1. Сохраните секретный ключ там, где ваш сервер сможет его прочитать, например, в переменной окружения или в менеджере секретных ключей.
  1. Нажмите « Я сохранил» .
Секретный ключ для подписи отображается только один раз. Если вы его потеряете, замените его на странице конечной точки, чтобы получить новый.

Отправить тестовое событие

  1. На странице конечной точки нажмите «Отправить тестовое событие» .
  1. В разделе «Недавние доставки» убедитесь, что тестовое событие отмечено зеленой галочкой и имеет код ответа 200. Это означает, что ваш сервер получил его.

Нажмите на отправленное сообщение, чтобы увидеть ответ вашего сервера и запрос, отправленный Notiondesk. Если проверка не удалась, убедитесь, что ваш сервер в течение нескольких секунд ответит кодом 2xx.

Часто задаваемые вопросы

Для каждого центра поддержки мне нужна одна точка доступа?

Нет. Одна конечная точка получает события из вашего рабочего пространства и из всех его центров поддержки. В разделе «Последние поступления» отображается информация о том, из какого центра поддержки поступило каждое событие.

Сколько конечных точек я могу добавить?

До 10 человек на одно рабочее место.

Кто может добавлять конечные точки?

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

Какие URL-адреса я могу использовать?

Публичный адрес, начинающийся с https:// и использующий доменное имя. Адреса в вашей частной сети и обычные IP-адреса отклоняются. Notiondesk не следует перенаправлениям, поэтому введите конечный адрес.

А что, если я потеряю секретный ключ от автографа?

Откройте страницу конечной точки и нажмите «Повернуть» в разделе «Секрет подписи» . Новый секрет отобразится один раз, а старый перестанет работать сразу же, поэтому одновременно обновите свой сервер.

Могу ли я изменить события позже?

Да. Откройте страницу конечной точки, добавьте или удалите события в разделе «События» , затем нажмите «Сохранить изменения» .

Связанные статьи

Эта страница была полезной?

Still need help? Ask us