Вебхуки: события звонков в вашу систему

Вебхук — это HTTP-запрос, который sipbox отправляет на ваш адрес, когда со звонком что-то происходит. Так телефонию связывают с системой, для которой готового коннектора нет: самописной CRM, ERP, внутренним сервисом. Настраивается в кабинете, входит во все тарифы.

Что на этом строят

Свою карточку клиента

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

Учёт звонков в своей базе

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

Уведомления куда угодно

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

Свою логику по недозвонам

Например, автоматически ставить задачу перезвонить, если клиент из важного сегмента не дозвонился. Правило живёт в вашей системе, sipbox только сообщает факт.

Как подключить

Подготовьте адрес приёма

Нужен обработчик, доступный из интернета по HTTPS, который принимает POST-запрос и отвечает быстро. Долгий ответ приводит к повторным попыткам доставки, поэтому тяжёлую обработку выносят в фон.

Укажите адрес в кабинете

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

Проверьте на реальном звонке

Сделайте тестовый вызов и убедитесь, что запрос дошёл и разобрался. Если что-то не приходит — напишите нам, посмотрим по логам с нашей стороны.

О чём стоит знать заранее

Вебхук — это односторонняя отправка событий из sipbox. Управлять настройками АТС снаружи через них нельзя: публичного REST API пока нет.
Ваш обработчик должен быть доступен из интернета. Систему в закрытом контуре без внешнего адреса вебхуком не подключить.
Доставка требует работающего приёмника: если ваша сторона недоступна, события за время простоя восстанавливать вручную неоткуда.
Разбирать запрос и связывать его с вашими данными придётся вашему разработчику — это интеграционная работа, а не настройка галочкой.

Вопросы про вебхуки

Чем вебхуки отличаются от готового коннектора?

Коннектор — это готовая связка, которую достаточно включить: с Битрикс24 карточка и записи попадают в сделку без программирования. Вебхук — это сырое событие, с которым ваша сторона делает что хочет. Он гибче, но требует разработчика.

Нужен ли программист?

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

Какие события отправляются?

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

Это безопасно?

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

Входят ли вебхуки в тариф?

Да, отдельной платы за них нет — мы берём за рабочие места. Ограничения по количеству запросов в разумных пределах не выставляем.

Подключите свой транк

Расскажите о задаче — посчитаем экономию на ваших объёмах и поможем с настройкой транка вашего оператора.

Оставить заявку Напишите нам