Телефония-CRM.Ру Вопросы перед выбором

Интеграция телефонии через вебхуки: события звонков

Вебхук простыми словами: телефония сама сообщает системе о каждом событии звонка — начале вызова, ответе, завершении, недозвоне. Какие события бывают, чем вебхук лучше опроса журнала и что учётная система делает с этой фактурой.

Интеграция телефонии через вебхуки: события звонков

Журнал вызовов станции знает всё о каждом звонке — но умеет только ждать, когда его спросят. Учётной системе такой подход не подходит: ей нужна фактура звонка сразу, в момент события, без ручных выгрузок и опросов. Эту роль выполняет вебхук — механизм, на котором стоит любая связка телефонии с учётной системой, готовая или собранная собственными руками.

Что такое вебхук на телефонном примере

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

Сравнение показывает разницу сразу:

  • Опрос журнала. Система раз в несколько минут выгружает список вызовов и выискивает новое. Между звонком и карточкой — пауза, часть событий размазывается по выгрузкам, а на пик нагрузки опрос приходится гонять чаще.
  • Вебхук. Уведомление уходит в момент события. Карточка открывается вместе с гудком, недозвон попадает в список потерь в ту же секунду, когда звонящий положил трубку.

Для CRM-телефонии выбор очевиден: события нужны живьём, а не архивом.

Какие события звонка передаются

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

  • Входящий вызов начался. Система успевает показать карточку клиента до ответа — менеджер снимает трубку с контекстом.
  • На вызов ответили. Разговор состоялся — в учётной записи появляется факт звонка, его можно привязать к сделке или обращению.
  • Разговор завершился. Фиксируются длительность и результат: разговор оседает в истории карточки со временем и направлением.
  • Дозвон не состоялся. Недозвон — тоже событие, и по ценности оно не уступает состоявшемуся разговору: без него список пропущенных в учётной системе не собрать.
  • Запись разговора готова. Если запись включена на станции, система узнаёт, что по разговору появился файл, — и может поставить ссылку или задачу «прослушать».

Событийный поток доходит до учётной системы независимо от того, какая именно платформа у вас стоит: вебхук — это способ доставки, а не свойство конкретной CRM.

Что система делает с событиями

Само по себе уведомление — только факт. Ценность появляется, когда учётная система реагирует:

  • Открывает карточку по входящему — сотрудник встречает звонок с историей клиента, а не с незнакомым номером.
  • Создаёт обращение на незнакомый номер — звонок с улицы не исчезает, а становится заявкой с ответственным.
  • Ставит задачу на перезвон по недозвону — пропущенный превращается в пункт списка, а не в строку журнала, которую никто не откроет.
  • Ведёт историю сделки — каждое телефонное касание остаётся в карточке, и передача клиента происходит чтением, а не опросом.

Эту логику в готовых интеграциях уже написали за вас; в собственной связке её описывает ваш разработчик — на тех же событиях.

Чем это обеспечено на стороне оператора

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

С чего начать

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

Читать также