Что такое вебхук и как он работает: как итог звонка сам попадает в вашу систему
Команда Sado AI · · 3 мин чтения
Коротко
Вебхук (webhook) — автоматическое сообщение, которое одна программа сама отправляет на заданный адрес (URL) другой программы, как только произошло событие. Например, звонок закончился — система сразу шлёт: «Бекзод, суббота 10:00, диагностика». Вашей программе не нужно каждую минуту спрашивать «есть что-то новое?» — сообщение приходит само. В голосовом ИИ-операторе вебхук доставляет итог звонка — ответы клиента, резюме и следующий шаг — в вашу CRM, программу заказов или таблицу без ручного переноса.
Вебхук простыми словами
Вместо того чтобы каждый час проверять почтовый ящик, почтальон звонит в дверь, когда пришло письмо. Вебхук — это такой звонок в дверь. У него четыре части:
- событие — когда уходит сообщение: звонок закончился, пришла новая заявка;
- адрес — куда оно идёт: URL в вашей системе;
- текст сообщения — обычно в формате JSON: имя, телефон, ответы;
- ответ — ваша система говорит «получил»; если ответа нет, многие системы отправляют сообщение повторно.
Чем вебхук отличается от API
| API | Вебхук | |
|---|---|---|
| Кто начинает | Ваша программа спрашивает | Система сама присылает |
| Когда | Когда вы запросили | Сразу после события |
| Пример | «Дай звонки за сегодня» | «Звонок закончился, вот итог» |
| Когда удобен | Отправить список, получить данные | Сразу узнавать о каждом событии |
Чаще всего их используют вместе: через API отправляете список для обзвона, через вебхук получаете итог каждого звонка. Подробнее: что такое API.
Пример: автосервис в Ташкенте
«Motor Servis» (название придумано) принимает машины по записи, записи хранятся в его небольшой программе:
- Клиент звонит в десять вечера: хочет записаться на диагностику в субботу.
- ИИ-оператор по графику сервиса предлагает субботу 10:00, спрашивает имя, марку машины и в чём проблема.
- Как только звонок закончился, Sado отправляет вебхук на адрес программы сервиса: имя, телефон, машина, день, время и короткое резюме («на холодную стучит двигатель»).
- Программа сервиса добавляет запись в график. Утром мастер видит готовый список.
Никто не слушал запись и не переносил данные вручную. Клиент, позвонивший ночью, тоже не потерялся.
Зачем вебхук голосовому ИИ-оператору
В Sado каждый звонок попадает в кабинет: запись, текст, ответы клиента, резюме и следующий шаг. С Bitrix24 есть готовая интеграция; amoCRM, Google Sheets и 1С подключает наша команда (звонки в CRM). Для любой другой системы есть вебхук и REST API (для разработчиков). Что делают с вебхуком:
- заводят заявку в своей CRM или программе заказов;
- после звонка отправляют из своей системы СМС или ссылку на оплату;
- добавляют строку в таблицу отчёта;
- ставят задачу нужному сотруднику.
А карточка звонка в Telegram-группу приходит и без вебхука: это Sado делает сам. Вебхук одинаково работает и для входящих звонков, и для исходящих звонков.
Чек-лист перед подключением вебхука
- Адрес-приёмник доступен из интернета и работает по https.
- Ваша система сразу отвечает «получил» (200), а тяжёлую работу делает потом.
- Если одно сообщение пришло дважды, оно не записывается дважды: проверяйте по номеру события.
- Проверяйте подпись: Sado подписывает каждый запрос вебхука, поэтому поддельное сообщение легко отсеять.
- Если сервер не виден снаружи (например, 1С в офисе), вместо вебхука опрашивайте ленту событий — подробности на странице /developers.
Для настройки вебхука нужен ваш разработчик, а оператора настраивает команда Sado. Попробуйте вживую или позвоните 78 778 01 23. Другие ответы: вопросы о Sado.
Вопросы
Нужен ли программист, чтобы подключить вебхук?
Да, на стороне, которая принимает сообщение, его кто-то должен настроить. Если у вас Bitrix24, вебхук не нужен: в Sado есть готовая интеграция. amoCRM, Google Sheets и 1С подключает наша команда.
Безопасен ли вебхук?
Да, если адрес работает по https, а принимающая сторона проверяет подпись. Sado подписывает каждый запрос вебхука.
Вебхук и API — одно и то же?
Нет. В API ваша программа отправляет запрос и получает ответ. Вебхук система присылает сама, когда произошло событие. Чаще всего их используют вместе.