Охватывает SMS, звонки, WhatsApp и электронную почту с точными именами событий.
WEBHOOK V2 · Каждое мобильное событие доставляется в ваше приложение
Преобразуйте каждое событие с подключённого мобильного устройства в моментальное действие.
SMSMobileAPI Webhook V2 отправляет структурированные HTTPS события в ваши приложения, когда SMS отправлен, доставлен, не отправлен или получен, когда мобильный звонок пропущен, входящий или исходящий, и при поддерживаемой активности WhatsApp или электронной почты. Настройте всё визуально из панели управления — без цикла опроса.
Ознакомьтесь с документацией APIВыберите события, которые получает каждая конечная точка. Тестируйте, приостанавливайте, отслеживайте и обновляйте секрет подписи из одной рабочей области.
Отправляйте разные группы событий на разные конечные точки HTTPS.
Проверяйте каждый запрос, используя подпись HMAC-SHA256 и метку времени.
Временные сбои в работе конечной точки повторяются без блокировки других аккаунтов.
Как работает WEBHOOK V2
От реального мобильного события до вашего приложения в три понятных шага.
Ваше подключённое мобильное устройство и сервисы SMSMobileAPI генерируют операционные события. Webhook V2 помещает каждое подходящее событие в надёжную очередь доставки и отправляет подписанную полезную нагрузку JSON на выбранный вами HTTPS URL.
- 1
Происходит событие
Сообщение отправлено, мобильное устройство отправляет или получает SMS, состояние звонка изменилось, либо зарегистрирована поддерживаемая активность WhatsApp и электронной почты.
- 2
Webhook V2 маршрутизирует событие
SMSMobileAPI создаёт один стабильный идентификатор события и ставит в очередь доставку только для конечных точек, подписанных на этот тип события.
- 3
Ваше приложение реагирует
Ваша публичная конечная точка HTTPS проверяет подпись, сохраняет ID события и запускает рабочие процессы CRM, поддержки, оповещений или автоматизации.
15 точных типов событий
Подписывайтесь только на мобильные события, которые нужны вашему рабочему процессу.
Одна конечная точка может принимать всё, либо вы можете разделить продакшн‑системы, аналитику и операционные оповещения. Каждое событие имеет точное имя, чтобы ваше приложение обрабатывало его предсказуемо.
SMS
5sms.api.submittedSMS отправлен через API
Запрос API создал задачу отправки SMS. Полезно для подтверждения, что запрос попал на платформу.
sms.sentSMS отправлено
Подключённое мобильное устройство подтвердило операцию отправки SMS.
sms.failedSMS не отправлено
Подключённый мобильный телефон вернул ошибку отправки SMS.
sms.receivedSMS получено
Подключённый мобильный синхронизировал входящий SMS.
sms.mobile.sentSMS отправлено с мобильного
SMS было отправлено вручную с подключённого мобильного.
Звонки
3call.missedПропущенный вызов
Пропущенный вызов был синхронизирован с подключённого мобильного.
call.incomingВходящий вызов
Входящий вызов был синхронизирован с подключённого мобильного.
call.outgoingИсходящий вызов
Исходящий вызов был синхронизирован с подключённого мобильного.
whatsapp.submittedWhatsApp отправлено
Была создана задача на отправку WhatsApp.
whatsapp.sentWhatsApp отправлено
Подключённая среда WhatsApp подтвердила отправку сообщения.
whatsapp.failedWhatsApp не удалось
Отправка WhatsApp не удалась.
whatsapp.receivedWhatsApp получено
Сообщение WhatsApp было извлечено после того, как аккаунт запросил синхронизацию.
whatsapp.voice.transcribedГолосовое сообщение транскрибировано
Подходящее полученное голосовое сообщение WhatsApp было преобразовано в пригодный для использования текст.
Электронная почта
2email.sentЭлектронное письмо отправлено
Запрос на отправку электронного письма был создан SMSMobileAPI.
email.receivedЭлектронное письмо получено
Подключённый почтовый ящик получил электронное письмо.
Настройте всё визуально
Профессиональное управление вебхуками без редактирования конфигурационных файлов.
Откройте Webhook V2 в панели управления SMSMobileAPI, добавьте имя назначения и публичные HTTPS URL, выберите события и сохраните. Панель управления предоставляет инструменты, необходимые для ежедневной работы и устранения неполадок.
Несколько назначений
Создавайте выделенные назначения для вашей CRM, мониторинга, аналитики или клиентских приложений.
Фильтры событий
Точно укажите, какие события SMS, вызовов, WhatsApp и электронной почты будет получать каждое URL.
Проверка доставки
Отправьте контролируемое тестовое событие, прежде чем полагаться на назначение в рабочем окружении.
Приостановить и возобновить
Остановите назначение мгновенно, не удаляя его конфигурацию.
Ротация секретов
Сгенерируйте новый секрет подписи, когда этого требует ваш процесс безопасности.
Активность доставки
Просмотрите доставки в очереди, доставленные, находящиеся в повторе и неудачные, с информацией о попытках и статусе HTTP.
https://crm.example.com/hooks/mobileАктивноsms.receivedcall.missedwhatsapp.received
https://ops.example.com/eventsАктивноsms.failedwhatsapp.failed
Надёжность заложена в основе
Создано для надёжной и независимой доставки.
Доставка через webhook асинхронна. Ваш мобильный рабочий процесс не ждёт ответа от стороннего URL, а сбой одной точки назначения не блокирует других клиентов или адресатов.
Надёжная очередь
Подходящие события сохраняются перед доставкой, поэтому временный простой получателя не приводит к потере события.
Доставка как минимум один раз
Доставка может повторяться. Сохраняйте идентификатор события и обрабатывайте его в вашем приложении только один раз.
Постепенные повторные попытки
При временных сбоях выполняются повторные попытки с увеличивающимися задержками до предела повторов платформы.
Изоляция сбоев
Медленная или недоступная конечная точка не может остановить доставку к другим, не связанным адресатам.
Автоматическая защита
Точку назначения с длительными сбоями можно приостановить, чтобы защитить очередь и вашу инфраструктуру.
Операционная прозрачность
Панель управления и мониторинг веб-мастера отображают состояние очереди, результаты и последние ошибки доставки.
Подписано и проверяемо
Проверяйте запрос перед тем, как доверять событию.
Каждая доставка включает метку времени, идентификатор доставки, тип события, стабильный ключ идемпотентности и подпись HMAC-SHA256. Храните секрет подписи на своём сервере, вычисляйте подпись из необработанного тела запроса и отклоняйте недействительные или устаревшие запросы.
X-SMSMobileAPI-EventТип события, например sms.received.X-SMSMobileAPI-DeliveryУникальный идентификатор доставки для этой точки назначения.X-SMSMobileAPI-TimestampUnix-метка времени, используемая при проверке подписи.X-SMSMobileAPI-SignatureПодпись HMAC-SHA256 для безопасного сравнения.Idempotency-KeyСтабильный UUID события, используемый для предотвращения повторной обработки.Единый конверт события
Один единообразный конверт JSON для каждого канала.
Формат конверта остаётся предсказуемым в SMS, звонках, WhatsApp и электронной почте. Объект data содержит поля, релевантные типу события, а верхнеуровневые идентификаторы позволяют маршрутизировать и устранять дубликаты каждой доставки.
id— стабильный идентификатор событияtype— точный тип событияoccurred_at— когда произошло событиеdata— данные, специфичные для канала
{
"id": "whv2_01J...",
"type": "sms.received",
"api_version": "2026-09-22",
"created_at": "2026-09-22T12:00:00Z",
"occurred_at": "2026-09-22T11:59:58Z",
"data": {
"guid": "...",
"from": "+32...",
"message": "Can you call me back?"
}
}От события к бизнес-результату
Пусть мобильная коммуникация запускает следующее бизнес‑действие.
Диалоги в CRM
Добавьте полученное сообщение SMS или WhatsApp к соответствующему контакту и оповестите ответственного.
Обработка пропущенных звонков
Создайте задачу для обратного звонка, отправьте последующее SMS или уведомьте дежурную команду после пропущенного звонка.
Поддержка клиентов
Открывайте или обновляйте заявку в службу поддержки, когда клиент отвечает со своего мобильного устройства.
Операции электронной коммерции
Обновляйте сценарии коммуникации по заказу после отправки мобильного сообщения, его подтверждения или сбоя.
Мониторинг и оповещения
Отправляйте ошибки доставки или нехарактерную активность звонков в инструменты наблюдаемости и управления инцидентами.
Рабочие процессы ИИ и обработки данных
Передавайте авторизованные события в процессы классификации, отчётности или поддержки без постоянного опроса API.
Перестаньте опрашивать изменения
Опрос делает повторные запросы. Вебхуки уведомляют ваше ПО, когда что‑то меняется.
Опрос расходует запросы даже при отсутствии изменений и добавляет задержки между проверками. Webhook V2 отправляет соответствующее событие на ваш эндпоинт, делая автоматизацию быстрее, проще и удобнее для масштабирования.
Часто задаваемые вопросы (Webhook V2)
Вопросы перед подключением вашей конечной точки.
Нужно ли мне реализовывать цикл опроса?+
Нет. Webhook V2 отправляет подписанные события на ваш публичный HTTPS-эндпоинт. Вы по‑прежнему можете использовать API, когда нужно запрашивать историю или детали.
Можно ли настроить несколько URL для вебхуков?+
Да. Вы можете создать несколько назначений и выбрать разные наборы событий для каждого, в пределах ограничений аккаунта, показанных на панели управления.
Как узнать, что SMS действительно был отправлен?+
Используйте sms.api.submitted, чтобы узнать, что задача создана, и sms.sent для подтверждения, отправленного подключённым мобильным устройством. Рассматривайте их как два разных операционных этапа.
Может ли вебхук доставляться более одного раза?+
Да. Webhook V2 использует доставку «по крайней мере один раз» (at‑least‑once). Сохраняйте стабильный идентификатор события или Idempotency-Key и игнорируйте доставку, которую уже обработали.
Что должен возвращать мой эндпоинт?+
Верните HTTP 2xx-ответ после безопасного принятия события. Обработка может продолжаться асинхронно внутри вашего приложения.
Собираются ли полученные события WhatsApp непрерывно?+
Нет. Получение сообщений WhatsApp следует собственному процессу синхронизации на основе согласия. Событие whatsapp.received становится доступным после того, как подходящее сообщение было получено.
Ваши мобильные события. Ваше ПО. Ваши действия.
Подключите ваше ПО к активности вашего реального мобильного устройства прямо сейчас.
Создайте аккаунт или войдите, откройте Webhook V2, добавьте публичное назначение HTTPS и выберите события, важные для вашего рабочего процесса. Отправьте тестовое событие, проверьте его подпись и активируйте интеграцию.
