HTTP-уведомления

HTTP-уведомления — это передача данных о событиях из UIS в сторонний сервис (CRM, сервис аналитики и т.д.) с помощью протокола HTTP (вебхуков). При наступлении заданного события, будь то потерянный звонок или новое входящее сообщение в чате, уведомление с информацией о нем автоматически отправляется на указанный URL-адрес.

Например, вы хотите, чтобы при поступлении звонка в вашей CRM-системе всплывало окно с уведомлением, по клику на которое можно сразу открыть карточку звонящего клиента. Для этого вам нужно настроить HTTP-уведомление в Личном кабинете UIS по типу события «Входящий звонок».

НТТР-уведомления работают с подключенным webhook.

Настройка передачи событий из сервиса в сервис является принципами работы интеграции, поэтому в Личном кабинете НТТР-уведомления находятся в разделе «Интеграции»:

Таблица настроенных HTTP-уведомлений представляет собой список всех созданных вами уведомлений и подготовленные шаблоны уведомлений для быстрой настройки.

Если необходимо найти какое-то уведомление, можно воспользоваться поиском и быстрыми фильтрами.

Найти HTTP-уведомление — поиск осуществляется по названию уведомления.

Быстрые фильтры:

• События — поиск по типу события.
• Метод — по методу отправки HTTP-уведомления.

Быстрые фильтры по состоянию:

• Активные — при включенном флаге выводятся только включенные уведомления.
• Неактивные — при включенном флаге выводятся только выключенные уведомления.

По умолчанию уведомления расположены в хронологическом порядке по факту их создания: новые сверху. Есть возможность сортировки по алфавиту непосредственно в столбцах.

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

Название уведомления: выводится так, как настроил пользователь. Можно сортировать по алфавиту нажатием на название столбца.

Событие: отображает событий, на которое приходит уведомление, — потерянный звонок, новый чат, проставление тега, голосовое сообщение и прочие, что настраивает пользователь. Можно сортировать данные по А-Я из столбца или выбрать нужное событие в поле быстрых фильтров. Можно сортировать по алфавиту нажатием на название столбца.

Метод: показывает метод, которым приходят HTTP-уведомления.

URL: адрес отправки уведомления.

Свитч для включения и выключения работы уведомления:

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

Иконки для управления:

• «Шестеренка» — редактирование уже настроенного уведомления/шаблона.
• «Копировать» — для формирования нового уведомления на основе скопированного. При нажатии на иконку откроется форма создания уведомления с дублированными настройками старого уведомления, только в скобках после названия будет слово «Копия».

Вам достаточно сделать минимальное изменение и сохранить. При сохранении копии без изменения настроек, отправка уведомлений происходит по настройке обоих уведомлений.

• «Корзина» — удалить с подтверждением.

Чтобы создать уведомление, вам нужно совершить несколько важных шагов:

1. Нажать на кнопку «Добавить HTTP-уведомление» на главном экране с таблицей:

2. Прописать «Название HTTP-уведомления»: это обязательное открытое поле ввода на странице создания HTTP-уведомления (ограничение текста — до 100 символов).

3. Указать «Тип события», по которому будет приходит уведомление в ваш сервис из UIS. События в выпадающем списке представляют собой:

• группы в соответствии с продуктовым модулем,
• общие события.

Группировка позволяет пользователю быстрее ориентироваться в списке и соотнести свою задачу с нужным типом: Звонки, ОМНИ, Аналитика Рекламы.

Общие события в выпадающем списке идут после сгруппированных:

• Проставление тега
• Снятие тега
• Событие
• Смена статуса сотрудника
• Авторизация в системе
• Управление записью разговора
• Выгрузка отчета
• Результаты AI готовы

4. Добавить «Условия» (при необходимости) для более тонкой настройки через «и» и «или»:

5. Заполнить блок «Настройка НТТР»:

Настройка производится на единственный канал отправки HTTP.

• Выбрать метод отправки: GET или POST.
• Указать URL, на который будут отправляться уведомления.
• Добавить в шаблон дополнительные параметры при необходимости:

1. «Сохранить» настроенное HTTP-уведомление, после чего оно отобразится в таблице уведомлений.

Для просмотра отчета по отправленным уведомлениям есть возможность быстрого перехода из раздела с таблицей HTTP-уведомлений в «Журнал уведомлений»: