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

Что нужно до подключения

  • Договор с UIS, SIP-учётные записи сотрудников.
  • Опция «API Базовый» в тарифе UIS: без неё уведомления не настроить.

Шаги на стороне UIS

  1. В личном кабинете UIS открыть «Администратор» → «Аккаунт» → «Тариф и опции» и развернуть «Все опции».
  2. Подключить «API Базовый».
  3. Открыть «Сервисы и статистика» → «Уведомления» и создать новое уведомление:
    • название — «Смартомато»;
    • тип события — «Ожидание ответа»;
    • «Активно» — включено;
    • способ уведомления — HTTP, метод POST;
    • URL — http://smartomato.ru/webhooks/sip/<org_id>/call, где <org_id> — id организации в Смартомато;
    • тело — так оно дано в клиентской справке Смартомато: { "contact_phone_number": #{{contact_phone_number}}, "sip_login": #{{employee_phone_number}} }. В contact_phone_number UIS подставляет номер звонящего, в sip_login — номер (логин) сотрудника, которому идёт звонок.
    • Зачем: по sip_login Смартомато находит сотрудника — значение должно входить в SIP-логин из его карточки; без этого поля карточка звонка не всплывает. Из contact_phone_number берутся только цифры номера гостя.
    • Зачем: по этому уведомлению Смартомато узнаёт о звонке, пока тот ещё ждёт ответа, и показывает оператору карточку. Подробнее — в Телефония и карточка звонка.
  4. Сохранить.

Что передать в Смартомато

  • SIP-номер каждого сотрудника, который принимает звонки. Он есть в личном кабинете UIS, раздел «Сотрудники».
  • SIP-пароль этих сотрудников.

Типовые ошибки и вопросы клиентов

  • Карточка всплывает на каждое уведомление. Смартомато не фильтрует события UIS и не проверяет токен: на какое событие настроено уведомление, на то и всплывает карточка. Нужен тип события «Ожидание ответа».
  • Всё настроено, а уведомление о звонке не приходит. По обзорной статье, в настройках телефонии можно добавить IP-адрес Смартомато в доверенные: 95.213.242.92.

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