Покриває 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 перевіряє підпис, зберігає ідентифікатор події та запускає ваші робочі процеси CRM, підтримки, сповіщень або автоматизації.
15 ТОЧНИХ ТИПІВ ПОДІЙ
Підписуйтесь лише на ті мобільні події, які потрібні вашому робочому процесу.
Один пункт призначення може отримувати все, або ви можете розділити виробничі системи, аналітику та операційні сповіщення. Кожна подія має точну назву, щоб ваш додаток міг обробляти її передбачувано.
SMS
5sms.api.submittedSMS подано через API
Запит API створив завдання відправлення SMS. Корисно для підтвердження, що запит надійшов у платформу.
sms.sentSMS надіслано
Підключений мобільний пристрій підтвердив операцію відправлення SMS.
sms.failedSMS не вдалося
Підключений мобільний пристрій повернув помилку під час надсилання SMS.
sms.receivedОтримано SMS
Підключений мобільний пристрій синхронізував вхідний SMS.
sms.mobile.sentSMS надіслано з мобільного
Повідомлення SMS було надіслано вручну з підключеного мобільного.
Дзвінки
3call.missedПропущений виклик
Пропущений виклик було синхронізовано з підключеного мобільного.
call.incomingВхідний виклик
Вхідний виклик було синхронізовано з підключеного мобільного.
call.outgoingВихідний виклик
Вихідний виклик було синхронізовано з підключеного мобільного.
whatsapp.submittedWhatsApp надіслано
Створено завдання надсилання WhatsApp.
whatsapp.sentWhatsApp надіслано
Підключене середовище WhatsApp підтвердило, що повідомлення надіслано.
whatsapp.failedWhatsApp не вдалося
Операція надсилання WhatsApp не вдалася.
whatsapp.receivedОтримано WhatsApp
Повідомлення 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
Надійність за дизайном
Створено для надійної, незалежної доставки.
Доставка вебхуків асинхронна. Ваш мобільний робочий процес не чекає відповіді стороннього URL, і відмова одного пункту призначення не блокує іншого клієнта чи пункту призначення.
Надійна черга
Події, що підлягають доставці, зберігаються перед відправленням, тому тимчасове простоювання отримувача не призведе до втрати події.
Доставка щонайменше один раз
Доставку може бути повторено. Зберігайте ідентифікатор події й обробляйте її у вашому додатку лише один раз.
Поступові повторні спроби
Тимчасові помилки повторюються з поступовим збільшенням затримок, до досягнення ліміту повторних спроб платформи.
Ізоляція збоїв
Повільний або недоступний кінцевий пункт не може зупинити доставку до інших, незв'язаних пунктів призначення.
Автоматичний захист
Пункт призначення з тривалими збоями можна призупинити, щоб захистити чергу та вашу інфраструктуру.
Оперативна видимість
Панель керування та моніторинг вебмайстра відображають стан черги, результати та останні помилки доставки.
Підписано та перевіряється
Перевіряйте запит перед тим, як довіряти події.
Кожна доставка містить часову мітку, ідентифікатор доставки, тип події, стабільний ключ ідемпотентності та підпис 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 надсилає підписані події на ваш публічний HTTPS ендпоінт. Ви все ще можете використовувати API, коли потрібно запитати історію або деталі.
Чи можна налаштувати кілька URL-адрес вебхуків?+
Так. Ви можете створити кілька адрес призначення й вибирати різний набір подій для кожної, у межах обмежень облікового запису, вказаних на панелі.
Як я можу бути впевнений, що SMS справді було надіслано?+
Використовуйте sms.api.submitted, щоб дізнатися, що завдання створено, та sms.sent для підтвердження від підключеного мобільного. Розглядайте їх як два різні етапи операцій.
Чи може вебхук доставлятися більше одного разу?+
Так. Webhook V2 використовує доставку принаймні один раз. Збережіть стійкий ідентифікатор події або Idempotency-Key і ігноруйте доставку, яку вже опрацювали.
Що має повертати мій ендпоінт?+
Поверніть HTTP 2xx-відповідь після безпечного прийняття події. Обробка може продовжуватися асинхронно у вашому додатку.
Чи збираються отримані WhatsApp події безперервно?+
Ні. Отримання повідомлень WhatsApp відбувається за власним процесом синхронізації на основі згоди. Подія whatsapp.received доступна після отримання відповідного повідомлення.
Ваші мобільні події. Ваше програмне забезпечення. Ваші дії.
Підключіть ваше програмне забезпечення до активності вашого реального мобільного пристрою зараз.
Створіть обліковий запис або увійдіть, відкрийте Webhook V2, додайте публічну HTTPS адресу призначення і виберіть події, важливі для вашого робочого процесу. Надішліть тестову подію, перевірте її підпис і активуйте інтеграцію.
