Ваши SMS отправляются с вашего телефона.Узнайте, как это работает
ПЛАТФОРМАAPI первая архитектураЗащищенное устройствоВидимость доставкиМногофункциональный контрольВерсионная документация

WEBHOOK V2 · Каждое мобильное событие доставляется в ваше приложение

Преобразуйте каждое событие с подключённого мобильного устройства в моментальное действие.

SMSMobileAPI Webhook V2 отправляет структурированные HTTPS события в ваши приложения, когда SMS отправлен, доставлен, не отправлен или получен, когда мобильный звонок пропущен, входящий или исходящий, и при поддерживаемой активности WhatsApp или электронной почты. Настройте всё визуально из панели управления — без цикла опроса.

Ознакомьтесь с документацией API

Выберите события, которые получает каждая конечная точка. Тестируйте, приостанавливайте, отслеживайте и обновляйте секрет подписи из одной рабочей области.

SMSЗвонокЭлектронная почта
подписанный JSON
SMSMobileAPIВебхукV2Надёжная очередь событий
В реальном времени
HTTPS POST
CRMПоддержкаАвтоматизацияАналитика
Мобильное событие → надёжная очередь → подписанная доставка HTTPS → ваш рабочий процесс
15 типов событий

Охватывает SMS, звонки, WhatsApp и электронную почту с точными именами событий.

Выборочная маршрутизация

Отправляйте разные группы событий на разные конечные точки HTTPS.

Подписанная доставка

Проверяйте каждый запрос, используя подпись HMAC-SHA256 и метку времени.

Надёжные повторные попытки

Временные сбои в работе конечной точки повторяются без блокировки других аккаунтов.

Как работает WEBHOOK V2

От реального мобильного события до вашего приложения в три понятных шага.

Ваше подключённое мобильное устройство и сервисы SMSMobileAPI генерируют операционные события. Webhook V2 помещает каждое подходящее событие в надёжную очередь доставки и отправляет подписанную полезную нагрузку JSON на выбранный вами HTTPS URL.

  1. 1

    Происходит событие

    Сообщение отправлено, мобильное устройство отправляет или получает SMS, состояние звонка изменилось, либо зарегистрирована поддерживаемая активность WhatsApp и электронной почты.

  2. 2

    Webhook V2 маршрутизирует событие

    SMSMobileAPI создаёт один стабильный идентификатор события и ставит в очередь доставку только для конечных точек, подписанных на этот тип события.

  3. 3

    Ваше приложение реагирует

    Ваша публичная конечная точка HTTPS проверяет подпись, сохраняет ID события и запускает рабочие процессы CRM, поддержки, оповещений или автоматизации.

15 точных типов событий

Подписывайтесь только на мобильные события, которые нужны вашему рабочему процессу.

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

SMS

5
sms.api.submitted

SMS отправлен через API

Запрос API создал задачу отправки SMS. Полезно для подтверждения, что запрос попал на платформу.

sms.sent

SMS отправлено

Подключённое мобильное устройство подтвердило операцию отправки SMS.

sms.failed

SMS не отправлено

Подключённый мобильный телефон вернул ошибку отправки SMS.

sms.received

SMS получено

Подключённый мобильный синхронизировал входящий SMS.

sms.mobile.sent

SMS отправлено с мобильного

SMS было отправлено вручную с подключённого мобильного.

Звонки

3
call.missed

Пропущенный вызов

Пропущенный вызов был синхронизирован с подключённого мобильного.

call.incoming

Входящий вызов

Входящий вызов был синхронизирован с подключённого мобильного.

call.outgoing

Исходящий вызов

Исходящий вызов был синхронизирован с подключённого мобильного.

WhatsApp

5
whatsapp.submitted

WhatsApp отправлено

Была создана задача на отправку WhatsApp.

whatsapp.sent

WhatsApp отправлено

Подключённая среда WhatsApp подтвердила отправку сообщения.

whatsapp.failed

WhatsApp не удалось

Отправка WhatsApp не удалась.

whatsapp.received

WhatsApp получено

Сообщение WhatsApp было извлечено после того, как аккаунт запросил синхронизацию.

whatsapp.voice.transcribed

Голосовое сообщение транскрибировано

Подходящее полученное голосовое сообщение WhatsApp было преобразовано в пригодный для использования текст.

Настройте всё визуально

Профессиональное управление вебхуками без редактирования конфигурационных файлов.

Откройте Webhook V2 в панели управления SMSMobileAPI, добавьте имя назначения и публичные HTTPS URL, выберите события и сохраните. Панель управления предоставляет инструменты, необходимые для ежедневной работы и устранения неполадок.

Несколько назначений

Создавайте выделенные назначения для вашей CRM, мониторинга, аналитики или клиентских приложений.

Фильтры событий

Точно укажите, какие события SMS, вызовов, WhatsApp и электронной почты будет получать каждое URL.

Проверка доставки

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

Приостановить и возобновить

Остановите назначение мгновенно, не удаляя его конфигурацию.

Ротация секретов

Сгенерируйте новый секрет подписи, когда этого требует ваш процесс безопасности.

Активность доставки

Просмотрите доставки в очереди, доставленные, находящиеся в повторе и неудачные, с информацией о попытках и статусе HTTP.

Настроить Webhook V2
Webhook V23 активных
Назначения3Доставлено · 24 ч1,284Повторные попытки2
CRM — рабочая средаhttps://crm.example.com/hooks/mobileАктивно

sms.receivedcall.missedwhatsapp.received

Операционные оповещенияhttps://ops.example.com/eventsАктивно

sms.failedwhatsapp.failed

Примеры элементов управления панелью Webhook V2.

Надёжность заложена в основе

Создано для надёжной и независимой доставки.

Доставка через webhook асинхронна. Ваш мобильный рабочий процесс не ждёт ответа от стороннего URL, а сбой одной точки назначения не блокирует других клиентов или адресатов.

01

Надёжная очередь

Подходящие события сохраняются перед доставкой, поэтому временный простой получателя не приводит к потере события.

02

Доставка как минимум один раз

Доставка может повторяться. Сохраняйте идентификатор события и обрабатывайте его в вашем приложении только один раз.

03

Постепенные повторные попытки

При временных сбоях выполняются повторные попытки с увеличивающимися задержками до предела повторов платформы.

04

Изоляция сбоев

Медленная или недоступная конечная точка не может остановить доставку к другим, не связанным адресатам.

05

Автоматическая защита

Точку назначения с длительными сбоями можно приостановить, чтобы защитить очередь и вашу инфраструктуру.

06

Операционная прозрачность

Панель управления и мониторинг веб-мастера отображают состояние очереди, результаты и последние ошибки доставки.

Подписано и проверяемо

Проверяйте запрос перед тем, как доверять событию.

Каждая доставка включает метку времени, идентификатор доставки, тип события, стабильный ключ идемпотентности и подпись 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)

Вопросы перед подключением вашей конечной точки.

Нужно ли мне реализовывать цикл опроса?

Нет. 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 и выберите события, важные для вашего рабочего процесса. Отправьте тестовое событие, проверьте его подпись и активируйте интеграцию.