Ваші SMS надсилаються з вашого телефону.Дізнайтеся, як це працює
ПЛАТФОРМАAPI-перша архітектураБезпечний пристрій для парівидимість доставкиБагатопристосувальні елементиVersioned documentation

WEBHOOK V2 · Кожна мобільна подія — доставлена у ваше програмне забезпечення

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

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

Перегляньте документацію API

Виберіть події, які отримує кожний пункт призначення. Тестуйте, призупиняйте, відстежуйте та оновлюйте його секрет підпису з однієї робочої області.

SMSДзвінокЕлектронна пошта
підписаний JSON
SMSMobileAPIWebhookV2Надійна черга подій
У режимі реального часу
HTTPS POST
КОМПЛЕКСПідтримкаАвтоматизаціяАналітика
Мобільна подія → надійна черга → доставка підписаного 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 перевіряє підпис, зберігає ідентифікатор події та запускає ваші робочі процеси 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.

Надійність за дизайном

Створено для надійної, незалежної доставки.

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

01

Надійна черга

Події, що підлягають доставці, зберігаються перед відправленням, тому тимчасове простоювання отримувача не призведе до втрати події.

02

Доставка щонайменше один раз

Доставку може бути повторено. Зберігайте ідентифікатор події й обробляйте її у вашому додатку лише один раз.

03

Поступові повторні спроби

Тимчасові помилки повторюються з поступовим збільшенням затримок, до досягнення ліміту повторних спроб платформи.

04

Ізоляція збоїв

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

05

Автоматичний захист

Пункт призначення з тривалими збоями можна призупинити, щоб захистити чергу та вашу інфраструктуру.

06

Оперативна видимість

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

Підписано та перевіряється

Перевіряйте запит перед тим, як довіряти події.

Кожна доставка містить часову мітку, ідентифікатор доставки, тип події, стабільний ключ ідемпотентності та підпис HMAC-SHA256. Зберігайте секрет підпису на вашому сервері, обчислюйте підпис із сирого тіла запиту та відкидайте недійсні або застарілі запити.

X-SMSMobileAPI-EventТип події, наприклад sms.received.X-SMSMobileAPI-DeliveryУнікальний ідентифікатор доставки для цього пункту призначення.X-SMSMobileAPI-TimestampUnix-мітка часу, що використовується під час перевірки підпису.X-SMSMobileAPI-SignatureHMAC-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 використовує доставку принаймні один раз. Збережіть стійкий ідентифікатор події або Idempotency-Key і ігноруйте доставку, яку вже опрацювали.

Що має повертати мій ендпоінт?

Поверніть HTTP 2xx-відповідь після безпечного прийняття події. Обробка може продовжуватися асинхронно у вашому додатку.

Чи збираються отримані WhatsApp події безперервно?

Ні. Отримання повідомлень WhatsApp відбувається за власним процесом синхронізації на основі згоди. Подія whatsapp.received доступна після отримання відповідного повідомлення.

Ваші мобільні події. Ваше програмне забезпечення. Ваші дії.

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

Створіть обліковий запис або увійдіть, відкрийте Webhook V2, додайте публічну HTTPS адресу призначення і виберіть події, важливі для вашого робочого процесу. Надішліть тестову подію, перевірте її підпис і активуйте інтеграцію.