Уведомления о событиях

Уведомления о событиях позволяют мгновенно получать оповещения о различных событиях, связанных с работой сервиса: например, о заявке с сайта, потерянном звонке, потере регистрации SIP-линии и т.п. Способы получения уведомлений:

• SMS-сообщение
• письмо на e-mail
• сообщение в сервис ВКонтакте
• вебхук (http-уведомление) — для интеграции с CRM или другим сторонним сервисом

Принцип работы уведомлений един: при наступлении заданного события UIS отправляет набор данных об этом событии на указанный в настройках адрес. Количество событий не ограничивается тарифным планом, поэтому вы можете настроить столько уведомлений, сколько требуется для решения вашей задачи.

На некоторых тарифных планах сервис Уведомлений о событиях включен в абонентскую плату, на некоторых – это дополнительная опция, поэтому актуальную стоимость и название опции нужно уточнить у персонального менеджера UIS.

После подключения нужной опции откройте Личный кабинет UIS → раздел Уведомления и нажмите «Добавить уведомление».

В открывшейся форме заполните поля: название, тип события, условия уведомлений:

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

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

Условия уведомлений — условия, при выполнении которых уведомление будет отправлено. Например, если вы хотите получать уведомления только о входящих потерянных звонках, необходимо настроить условие «Направление звонка — Точно соответствует — Входящий звонок».

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

После настройки условий выберите способ получения уведомлений: SMS, e-mail, VK, HTTP или сразу несколько, если это нужно для решения вашей задачи.

Введите один или несколько номеров в международном формате (без плюса перед кодом страны). Если не хотите получать SMS в нерабочее время, выберите расписание рабочего времени в поле График:

Тело уведомления — содержание SMS — генерируется автоматически в зависимости от выбранного события, но его можно редактировать под свои задачи: изменить текст и добавить дополнительные данные об обращении. Кликните «Добавить параметр»:

В открывшемся списке кликните на нужный параметр, чтобы добавить его в текст сообщения:

Список доступных параметров зависит от выбранного типа события: например, в событии «Входящий звонок на виртуальный номер» не будет параметра, передающего ссылку на запись звонка, потому что разговор еще даже не начал записываться.

Чтобы посмотреть, как будет выглядеть SMS, нажмите на «Предпросмотр уведомления»:

Чтобы отправить себе тестовое уведомление, нажмите «Протестировать уведомление», и на указанный номер телефона будет отправлено сообщение со случайными данными:

Тестовые уведомления тарифицируются так же, как и настоящие.

Введите один или несколько адресов электронной почты. Если не хотите получать письма в нерабочее время, выберите расписание рабочего времени в поле График:

Тема письма и содержание письма — тело уведомления — генерируется автоматически в зависимости от выбранного события, но их можно редактировать под свои задачи: изменить текст и добавить дополнительные данные об обращении. Кликните «Добавить параметр»:

В открывшемся списке кликните на нужный параметр, чтобы добавить его в тему или текст письма:

Список доступных параметров зависит от выбранного типа события: например, в событии «Входящий звонок на виртуальный номер» не будет параметра, передающего ссылку на запись звонка, потому что разговор еще даже не начал записываться.

Чтобы посмотреть, как будет выглядеть письмо, нажмите на «Предпросмотр уведомления», а чтобы отправить себе тестовое уведомление, нажмите «Протестировать уведомление», и на указанный e-mail будет отправлено письмо со случайными данными:

Чтобы получать уведомления в личные сообщения в сервисе ВКонтакте, у вас должен быть аккаунт ВКонтакте и разрешено получение сообщений.

В настройках уведомлений следуйте инструкции:

Перейдите в сообщество UIS по указанной ссылке и откройте чат с сообществом:

Нажмите кнопку «Начать» и скопируйте ID из полученного в ответ сообщения:

Вернитесь в настройки уведомлений и вставьте скопированный ID в соответствующее поле:

Тело уведомления — содержание сообщения — генерируется автоматически в зависимости от выбранного события, но его можно редактировать под свои задачи: изменить текст и добавить дополнительные данные об обращении. Кликните «Добавить параметр»:

В открывшемся списке кликните на нужный параметр, чтобы добавить его в текст сообщения:

Список доступных параметров зависит от выбранного типа события: например, в событии «Входящий звонок на виртуальный номер» не будет параметра, передающего ссылку на запись звонка, потому что разговор еще даже не начал записываться.

Чтобы посмотреть, как будет выглядеть сообщение, нажмите на «Предпросмотр уведомления», а чтобы отправить себе тестовое уведомление в ВК, нажмите «Протестировать уведомление»: вам будет отправлено сообщение со случайными данными:

В поле URL укажите адрес сервиса, на который должны приходить уведомления. Выберите метод — GET или POST — в зависимости от возможностей принимающей стороны:

Метод GET

Шаблон может представлять собой как JSON (при этом JSON структура может начинаться только с символа «{»),

так и классический query string:

В предпросмотре GET отображен декодированным, но важно понимать, что отправляться он будет в кодировке согласно RFC 3986.

Метод POST

Шаблон может быть только в формате JSON согласно стандарту RFC 7159. Т.е. JSON структура может начинаться как с символа ‘{‘, так и с символа ‘[‘

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

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

и как строка:

Кликните Добавить параметр, чтобы добавить в тело уведомления нужные данные:

Список доступных параметров зависит от выбранного типа события: например, в событии «входящий звонок на виртуальный номер» не будет параметра, передающего ссылку на запись звонка, потому что разговор еще даже не начал записываться.

Нужный параметр также можно добавить, набрав в теле уведомления символы {{ или %. После ввода этих символов вы можете вводить название нужного параметра прямо на русском языке, и вам будет выводиться наилучшее совпадение.

Если на принимающей стороне выполняется проверка по IP-адресу, скопируйте IP нашего сервера из соответствующей строки:

На случай сбоя во время отправки уведомления предусмотрено четыре дополнительных попытки отправки:

• через 2 часа
• через 4 часа
• через 8 часов
• через 16 часов

В уведомлениях для событий, связанных с телефонией, существует идеология, разделяющая звонок на вызов и на «плечи». Плечо — это часть вызова, соединяющая участника звонка и платформу UIS. Таким образом, плечо может быть входящим (часть соединения между вызывающей стороной и платформой) и исходящим (часть соединения между вызываемой стороной и платформой). Звонок, в свою очередь, может также иметь два направления: входящий вызов — вызов на виртуальный номер из внешнего мира, и исходящий вызов — вызов от сотрудников компании.