Как работает вебхук: простое объяснение для владельца бизнеса и разработчика
Команда Sado AI · · 3 мин чтения
Коротко
Вебхук — это когда одна система при событии сама отправляет сообщение другой. Например, звонок закончился, и Sado отправляет итог — с кратким резюме и следующим шагом — на адрес вашего сайта или программы. Вам не нужно каждую минуту спрашивать «есть что-то новое?». Для вебхука нужен открытый из интернета HTTPS-адрес; входящий запрос нужно проверить по подписи, быстро ответить и не записывать дважды, если одно сообщение пришло два раза. В Sado есть вебхук и REST API.
Вебхук простыми словами
Допустим, вы ждёте курьера. Можно каждые пять минут звонить и спрашивать: «Вы уже приехали?» А можно, чтобы курьер сам написал, когда приедет. Первый способ похож на запросы через API, второй — это вебхук.
| Запрос через API | Вебхук | |
|---|---|---|
| Кто начинает | Ваша система | Система, которая отправляет сообщение |
| Когда вы узнаёте | При следующем запросе | Сразу, как случилось событие |
| Что нужно у вас | Программа, которая периодически спрашивает | Открытый из интернета адрес (URL) |
| Когда удобно | Сервер внутри офиса, снаружи недоступен | Итог нужен сразу |
Зачем вебхук в звонках
Когда итог звонка приходит вебхуком, вы используете его в своей системе как угодно. Например:
- Звонок закончился — итог попадает в вашу собственную CRM или внутреннюю программу.
- Клиент записался — время добавляется в ваш календарь.
- Клиент заинтересовался — менеджеру создаётся задача.
- Клиент сказал «не звоните мне» — в вашей базе этот номер помечается.
Как работает вебхук: по шагам
- Разработчик открывает адрес, который принимает сообщения, например https://vash-sayt.uz/sado-webhook.
- Этот адрес передаётся в Sado. Как это сделать, описано на странице для разработчиков.
- Происходит событие: например, звонок закончился и итог готов. Sado отправляет на адрес сообщение в формате JSON.
- Ваш сервер проверяет подпись и сразу отвечает «принято» (HTTP 200).
- После этого обрабатывает сообщение: пишет в CRM, создаёт задачу или отправляет уведомление.
Пять правил для разработчика
- Используйте только HTTPS-адрес.
- Проверяйте подпись каждого запроса: так вы знаете, что сообщение действительно от Sado. Запросы без подписи или старые отклоняйте.
- Сначала быстро ответьте, тяжёлую работу делайте потом. Если ответ задерживается, отправитель может решить, что сообщение не дошло.
- Будьте готовы, что одно сообщение придёт дважды: отправитель, не получив ответа, обычно повторяет. Храните ID события и пропускайте повторы.
- Не вписывайте ключи и пароли в адрес, а ошибки записывайте в журнал.
Если вебхук не работает: что проверить
- Открыт ли адрес из интернета: откройте его из другой сети, например с мобильного интернета.
- Не истёк ли HTTPS-сертификат.
- Отвечает ли сервер 200 или выдаёт ошибку (4xx, 5xx): посмотрите журнал.
- Правильно ли проверяется подпись: секретный ключ скопирован целиком, тело запроса проверяется без изменений.
- Верно ли время на сервере: отклонение старых запросов зависит от часов.
Нужен ли вебхук или хватит готового подключения
Многим компаниям вебхук вообще не нужен. С Битрикс24 у Sado есть готовое подключение: карточка звонка с записью и текстом попадает в CRM, создаётся лид или сделка. amoCRM, Google Таблицы, 1С, BILLZ и МойСклад подключает наша команда вместе с вами. Вебхук и REST API нужны для вашей собственной программы или другой системы.
Подробнее: ИИ-звонки с Битрикс24, ИИ-звонки с amoCRM и CRM и звонки. Если нужен звонок сразу на заявку с сайта: автообзвон. Попробуйте вживую.
Вопросы
Чем вебхук отличается от API?
В API ваша система сама спрашивает: «есть что-то новое?». В вебхуке другая система сама присылает сообщение, когда появилось новое. Часто их используют вместе.
Нужен ли разработчик для вебхука?
Да, адрес для приёма открывает разработчик. Но если у вас Битрикс24, amoCRM, Google Таблицы, 1С, BILLZ или МойСклад, их подключает команда Sado, и вебхук не нужен.
Что приходит в сообщении вебхука?
Итог звонка: например, краткое резюме и следующий шаг. Полный список полей — в документации на странице для разработчиков.
Вебхук — это безопасно?
Да, если адрес на HTTPS и вы проверяете подпись каждого запроса. Не вписывайте ключи и пароли в адрес и не отправляйте их никому в чатах.