Для: Администраторы
Настройте веб-хук для отслеживания активности в ленте новостей.
Отправляйте вашей системе сообщение всякий раз, когда добавляется, изменяется или удаляется запись в ленте, комментарий или вложение.
В этой статье8 разделов
WebhookВебхук Адрес, который вы указываете центру управления, чтобы он мог отправлять сообщения вашим системам всякий раз, когда изменяется сообщение в ленте или комментарий. отправляет вашему системе сообщения каждый раз, когда происходит что-то в FeedКорм Хронология публикаций по делу, где фирма делится новостями, и все участники дела могут оставлять комментарии. случая – например, появляется новое сообщение или комментарий. Каждое сообщение зашифровано, поэтому система, получающая эти сообщения, должна использовать специальный код разработчика для их расшифровки.
Открытые веб-хуки
Перейдите на страницу Интеграция › Вебхокы и выберите пункт НОВЫЙ.
Введите адрес
Под URL введите адрес сервера, на который отправляются сообщения. Это может быть, например, https://crm.example.com/hooks/caseactive. Адрес должен начинаться с https:// или http://, и он должен быть доступным из Интернета. Префиксы должны сохраняться в полном виде при вводе адреса.
Описание является опциональным параметром. Это может быть сообщение для вашего команды, например, информация о случаях, которые необходимо отобразить в нашем CRM-системе.
Выберите события
Под Мероприятия выберите те элементы, которые должны отправлять сообщения – например, пост создан и комментарий к записи создан. Их всего десять: это сообщения, комментарии к постам, а также файлы, добавленные или удаленные из системы. Подробности о событиях, связанных с webhook-сервисом, и содержимом отправляемых данных можно найти здесь.
Включите и сохраните
Активный – начинается отсчет времени. Оставьте это значение так: неактивный вебхук не получает ничего, а то, что он пропускает, не будет отправлен позже. Выберите СОХРАНЯТЬ. Появится сообщение “Вебхук добавлен”.
Храните секрет
В окне Секретный веб-перехватчик отображается секретный ключ для использования в webhook-сервисе – это частный ключ, который необходимо использовать для расшифровки каждого сообщения, отправляемого через этот сервис. Этот ключ отображается лишь один раз. Вы можете выбрать Скачать как файл .pem для сохранения ключа в файле, или Скопировать в буфер обмена для копирования всего текста, включая символы новой строки. Передайте этот ключ своему разработчику, используя, например, хранилище паролей. Затем выберите Готово.
Проверьте это
Необходимо добавить короткую запись в один из случаев, для которых нет никаких реальных клиентов. Это можно сделать с одним из двух примеров случаев, которые были предоставлены вашим хабом. Разработчик должен проверить, что сообщение было получено, и что секретное слово действительно находится в этом сообщении.
Что произойдет дальше?
Каждый раз, когда в каком-либо случае в вашем центре происходит определенное событие, webhook отправляет сообщение в вашу систему. Это сообщение может принадлежать тем, кто произвел изменения: вашему команде, клиенту, Виртуальному помощникуВиртуальный помощник Автоматизированный член команды, который публикует приветственные сообщения, проводит проверки и организует публикации для компании; его публикации отмечены значком виртуального помощника., либо ключу API. Никому другому не сообщается об этом событии.
Если два попытки отправки происходят неудачно, веб-хук прекращает свою работу, и каждый администратор получает электронное письмо. Смотрите раздел “Устранение проблем с веб-хуком, который перестал отправлять сообщения”. Чтобы изменить адрес веб-хука или типы событий, выберите значок стиля ручки Редактировать веб-перехватчик в строке, где указан веб-хук. Секретный ключ остается неизменным.
Если что-то пойдёт не так
- Превышен лимит использования Webhook-сервиса. У вашего хаба может быть пять вебхоуков. Удалите один из них, который вы больше не используете. Выберите значок ящика для удаления вебхоука. Удалить веб-перехватчик, На своем ряду, тогда. Удалить. Он сразу же останавливается и больше не может быть возвращен в работу.
- В указанном URL-адресе есть сообщение: “URL неверный. Пример правильного адреса: https://example.com/hook”. Необходимо ввести полный URL-адрес, начинающийся с https:// или http://. Адреса, которые работают только на вашем собственном компьютере, не принимаются.
- Вы потеряли этот секрет. Его больше нельзя показывать. Нужно добавить новый веб-хук с теми же адресами и событиями. Секрет этого веб-хука следует передать своему разработчику. Затем нужно удалить старый веб-хук.