Історія змін

Зміни в API та в цій документації, свіжі згори.

2026-09-09

Документація

У JSON API з'явився машиночитаний контракт: openapi.yaml та openapi.json, посилання — на сторінці Структура запиту. Файл імпортується в Postman, Insomnia або генератор клієнта. Він описує конверт запиту, усі двадцять задокументованих операцій за data[].type, формат відповіді та вебхук зі статусом доставки. Адреса сервера у файлі — та, що діє для цього сайту.

API

Вебхуки про статус повторюються: до трьох спроб із паузами 10 і 60 секунд. Повтор буває лише при обриві зв'язку, таймауті, 5xx або 429; успіхом вважається строго 200. Обробник має бути ідемпотентним. Див. Вебхук, Verify (OTP) і Callback-сповіщення.

MCP-конектор: інструмент send_whatsapp надсилає запит типом pipeline. Поле signature стало обов'язковим, необов'язкова пара sms_signature + sms_message додає досилку SMS. Виклик зі старим набором аргументів (phone, message, confirm) більше не проходить схему інструмента — див. Інструменти конектора.

Документація

Callback-сповіщення — новий розділ Звіт про доставку на URL. Звіт був описаний лише у варіанті на e-mail, хоча шлюз надсилає його на адресу сповіщень по кожному повідомленню акаунта, яким би API воно не було надіслане. Твердження, що JSON вебхук приходить замість цих сповіщень, було хибним: надсилаються обидва.
Відправка OTP коду (WhatsApp) — сторінку переписано. type: whatsapp не є типом повідомлення і відхиляється з помилкою Invalid message type; WhatsApp — етап запиту pipeline.
У звіті про доставку на URL і на e-mail зсув часового поясу йде без двокрапки (+0300), формат був описаний неправильно.

API

У payload вебхука з’явилося поле success: true лише якщо повідомлення доставлено (DELIVERED, READ, REPLIED, PARTIALLY DELIVERED), інакше false. Див. Вебхук.
Якщо в асинхронному пакеті немає id жодного повідомлення, надсилається один вебхук з request_id, а не пропускається сповіщення.

API

Сповіщення про відхилене повідомлення тепер має ту саму форму, що й статус доставки: плоский об'єкт зі status: REJECTED і причиною в error. Поле success і вкладений масив data прибрані — один payload, один парсер. Див. Вебхук.
Відхилений запит тепер породжує по одному сповіщенню на кожне повідомлення з hook, кожне зі своїм id. Раніше надсилалося одне сповіщення на адресу, і про решту повідомлень пачки клієнт не дізнавався.
Сповіщення Verify (OTP) приведено до тієї ж форми і тепер теж містить status і updated.

Документація

Нова сторінка Callback-сповіщення — вхідне SMS на виділений номер, відповіді Viber 2 Way і звіт про доставку на e-mail. Жодне з цих сповіщень раніше не було описане.
Вебхук — додані поля request_id, reply і duration; id та msg_id — рядки, а не числа; додані правила доставки (одна спроба, без повторів, таймаути 5 секунд) і приклад відхиленого повідомлення.
Verify (OTP) — описано вебхук, який повідомляє про відхилений запит.
У прикладах запитів на сторінках JSON API з'явилися готові до запуску сніпети на cURL, PHP, Python і Node.js.
Команди receive, delete і price у HTTP API помилково були описані як send.
Wap-Push більше не описаний у документації.