Центр поддержкиИнтеграции

Для: Администраторы

Настройте веб-хук для отслеживания активности в ленте новостей.

Отправляйте вашей системе сообщение всякий раз, когда добавляется, изменяется или удаляется запись в ленте, комментарий или вложение.

В этой статье8 разделов

WebhookВебхук Адрес, который вы указываете центру управления, чтобы он мог отправлять сообщения вашим системам всякий раз, когда изменяется сообщение в ленте или комментарий. отправляет вашему системе сообщения каждый раз, когда происходит что-то в FeedКорм Хронология публикаций по делу, где фирма делится новостями, и все участники дела могут оставлять комментарии. случая – например, появляется новое сообщение или комментарий. Каждое сообщение зашифровано, поэтому система, получающая эти сообщения, должна использовать специальный код разработчика для их расшифровки.

  1. Открытые веб-хуки

    Перейдите на страницу Интеграция › Вебхокы и выберите пункт НОВЫЙ.

  2. Введите адрес

    Под URL введите адрес сервера, на который отправляются сообщения. Это может быть, например, https://crm.example.com/hooks/caseactive. Адрес должен начинаться с https:// или http://, и он должен быть доступным из Интернета. Префиксы должны сохраняться в полном виде при вводе адреса.

    Описание является опциональным параметром. Это может быть сообщение для вашего команды, например, информация о случаях, которые необходимо отобразить в нашем CRM-системе.

  3. Выберите события

    Под Мероприятия выберите те элементы, которые должны отправлять сообщения – например, пост создан и комментарий к записи создан. Их всего десять: это сообщения, комментарии к постам, а также файлы, добавленные или удаленные из системы. Подробности о событиях, связанных с webhook-сервисом, и содержимом отправляемых данных можно найти здесь.

  4. Включите и сохраните

    Активный – начинается отсчет времени. Оставьте это значение так: неактивный вебхук не получает ничего, а то, что он пропускает, не будет отправлен позже. Выберите СОХРАНЯТЬ. Появится сообщение “Вебхук добавлен”.

  5. Храните секрет

    В окне Секретный веб-перехватчик отображается секретный ключ для использования в webhook-сервисе – это частный ключ, который необходимо использовать для расшифровки каждого сообщения, отправляемого через этот сервис. Этот ключ отображается лишь один раз. Вы можете выбрать Скачать как файл .pem для сохранения ключа в файле, или Скопировать в буфер обмена для копирования всего текста, включая символы новой строки. Передайте этот ключ своему разработчику, используя, например, хранилище паролей. Затем выберите Готово.

  6. Проверьте это

    Необходимо добавить короткую запись в один из случаев, для которых нет никаких реальных клиентов. Это можно сделать с одним из двух примеров случаев, которые были предоставлены вашим хабом. Разработчик должен проверить, что сообщение было получено, и что секретное слово действительно находится в этом сообщении.

Что произойдет дальше?

Каждый раз, когда в каком-либо случае в вашем центре происходит определенное событие, webhook отправляет сообщение в вашу систему. Это сообщение может принадлежать тем, кто произвел изменения: вашему команде, клиенту, Виртуальному помощникуВиртуальный помощник Автоматизированный член команды, который публикует приветственные сообщения, проводит проверки и организует публикации для компании; его публикации отмечены значком виртуального помощника., либо ключу API. Никому другому не сообщается об этом событии.

Если два попытки отправки происходят неудачно, веб-хук прекращает свою работу, и каждый администратор получает электронное письмо. Смотрите раздел “Устранение проблем с веб-хуком, который перестал отправлять сообщения”. Чтобы изменить адрес веб-хука или типы событий, выберите значок стиля ручки Редактировать веб-перехватчик в строке, где указан веб-хук. Секретный ключ остается неизменным.

Если что-то пойдёт не так

  • Превышен лимит использования Webhook-сервиса. У вашего хаба может быть пять вебхоуков. Удалите один из них, который вы больше не используете. Выберите значок ящика для удаления вебхоука. Удалить веб-перехватчик, На своем ряду, тогда. Удалить. Он сразу же останавливается и больше не может быть возвращен в работу.
  • В указанном URL-адресе есть сообщение: “URL неверный. Пример правильного адреса: https://example.com/hook”. Необходимо ввести полный URL-адрес, начинающийся с https:// или http://. Адреса, которые работают только на вашем собственном компьютере, не принимаются.
  • Вы потеряли этот секрет. Его больше нельзя показывать. Нужно добавить новый веб-хук с теми же адресами и событиями. Секрет этого веб-хука следует передать своему разработчику. Затем нужно удалить старый веб-хук.

Статьи по теме

Найдите информацию о событиях и полезных нагрузках веб-хуков.Что отправляет каждое из десяти событий ленты, как шифруется сообщение и как его расшифровать с помощью вашего секретного ключа.ИнтеграцииИсправлена ошибка в веб-хуке, из-за которой он перестал отправлять сообщения.Почему веб-хук останавливается после двух неудачных попыток доставки или когда он неактивен, и как его повторное сохранение активирует его снова.ИнтеграцииРазберитесь, что может делать API.Узнайте, к чему могут иметь доступ ключ управления и ключ концентратора, почему каждый ключ действует как виртуальный помощник и где находится полный технический паспорт.Интеграции