SMS · SMS API

SMS API: SMS з вашого ПЗ одним запитом.

Надсилайте SMS зі своєї CRM, ERP, інфраструктури e-commerce чи власного застосунку, запитуйте статус доставки, отримуйте вхідні повідомлення та сповіщення про відмову. REST і JSON; автентифікація за допомогою Bearer-ключа, події — через webhook з HMAC-підписом.

Телефонуємо в робочий час. Ваш номер використовується лише для цієї розмови · KVKK
# персоналізована масова SMS-розсилка curl -X POST https://api.buluthat.com/api/sms.php?action=send \ -H "Authorization: Bearer bt_xxx" -H "Content-Type: application/json" \ -d '{"header":"FIRMAADI","message":"Merhaba {ad}, siparişiniz kargoda.", "recipients":[{"phone":"05321234567","name":"Ayşe"}]}' # відповідь {"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}} # подія доставки (webhook, підпис HMAC) X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}
Що є

Функції

Надсилання одним запитом

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

Звіт про доставку

за допомогою status запитуйте статус кожного повідомлення за номером розсилки або вашим референсом (custom_ref).

Підписаний webhook

Події доставки, вхідних SMS та відмови підписуються X-Buluthat-Signature (HMAC-SHA256) і надходять на вашу адресу; у разі невдачі повторюються з наростаючою затримкою.

Запит кредиту та заголовка

balance — залишок кредитів SMS / OTP і терміни дії, headers — ваші підтверджені заголовки.

Запланована розсилка та скасування

send_at — майбутня дата не більш ніж на 90 днів; за допомогою cancel ненадіслані повідомлення скасовуються, кредит повертається.

Чорний список

синхронізуйте власний список відмов за допомогою blacklist_add / blacklist_remove.

Кінцеві точки OTP

керуйте кодом підтвердження через otp_send, otp_verify та otp_status без окремої таблиці.

İYS та налаштування швидкості

is_commercial пропускає комерційне повідомлення через перевірку İYS; rate_per_minute обмежує кількість надсилань за хвилину.

Заявка

Почніть надсилати SMS за 4 кроків

Документи ви завантажуєте з панелі; підтвердження заголовка відстежуємо ми.

01
Заявка

Заповніть форму, виберіть потрібний пакет. Після відкриття облікового запису пароль до панелі надійде на ваш e-mail.

02
Завантажте документи

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

03
Підтвердження заголовка

Ваш SMS-заголовок (3-11 символів) підтверджується протягом 1-3 робочих днів, якщо документи в повному обсязі.

04
Надсилайте

Масово надсилайте з Excel або довідника в панелі чи підключіть до вашого ПЗ через SMS API.

FAQ

Про SMS API

На сторінці SMS API у розділі «Розробникам»; з прикладами запитів, відповідей і кодами помилок.

Ви створюєте на екрані Панель > Масові SMS > API та налаштування; адресу webhook також вводите там.

Номер, що повторюється в одному запиті, надсилається один раз; якщо ввімкнено захист від дублів, той самий текст на той самий номер у той самий день удруге не надсилається.