SMS · SMS API

SMS API: SMS из вашего ПО одним запросом.

Отправляйте SMS из CRM, ERP, платформы электронной коммерции или собственного приложения, запрашивайте статус доставки, получайте входящие сообщения и уведомления об отказе. REST и JSON; аутентификация по Bearer-ключу, события — через webhook с подписью HMAC.

Подайте заявку сейчас Документация SMS API

# персонализированная массовая 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 шага

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

Ваша заявка

Заполните форму и выберите нужный пакет. После открытия аккаунта пароль для панели придёт на ваш e-mail.

Загрузите документы

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

Утверждение заголовка

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

Отправьте

Выполняйте массовую отправку из панели через Excel или справочник либо подключите ПО через SMS API.

Подайте заявку сейчас Цены на SMS

FAQ

О SMS API

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

Создаётся на экране «Панель > Массовая SMS > API и настройки»; адрес webhook вводится там же.

Номер, повторённый в одном запросе, отправляется один раз; при включённой защите от дублей один и тот же текст не уйдёт на тот же номер повторно в тот же день.

SMS

Вместе сильнее

Массовая SMS, код подтверждения, входящие SMS и API — с вашим утверждённым заголовком.