SMS · SMS API

SMS API: proqramınızdan tək sorğu ilə SMS.

CRM, ERP, e-ticarət infrastrukturunuz ya da öz tətbiqinizdən SMS göndərin, çatdırılma vəziyyətini sorğulayın, daxil olan mesajları və imtina bildirişlərini alın. REST və JSON; kimlik doğrulama Bearer açarla, hadisələr HMAC imzalı webhook ilə.

İş saatlarında zəng edirik. Nömrəniz yalnız bu söhbət üçün istifadə olunur · KVKK
# şəxsi toplu 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"}]}' # cavab {"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}} # çatdırılma hadisəsi (webhook, HMAC imzalı) X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}
Nələr var

Xüsusiyyətlər

Tək sorğu ilə göndəriş

send əməliyyatı: tək nömrə, siyahı ya da şəxsi fərqli mətnlər; yer tutucular alıcı sahələrindən doldurulur.

Çatdırılma hesabatı

status ilə göndəriş nömrəsi ya da öz referansınız (custom_ref) üzərindən hər mesajın vəziyyətini sorğulayın.

İmzalı webhook

Çatdırılma, daxil olan SMS və imtina hadisələri X-Buluthat-Signature (HMAC-SHA256) ilə imzalanıb ünvanınıza gəlir; uğursuz olarsa geri çəkilərək yenidən sınanır.

Kontor və başlıq sorğusu

balance ilə qalan SMS / OTP kontoru və son istifadə tarixləri, headers ilə təsdiqli başlıqlarınız.

Planlı göndəriş və ləğv

send_at ilə 90 günə qədər gələcək tarix; cancel ilə göndərilməmiş mesajlar ləğv edilir, kontor qaytarılır.

Qara siyahı

blacklist_add / blacklist_remove ilə öz imtina siyahınızı sinxronlaşdırın.

OTP nöqtələri

otp_send, otp_verify və otp_status ilə doğrulama kodunu ayrı cədvəl saxlamadan idarə edin.

İYS və sürət ayarı

is_commercial ilə kommersiya mesajı İYS yoxlamasından keçir; rate_per_minute ilə dəqiqədə göndərişi məhdudlaşdırırsınız.

Müraciət

SMS göndərməyə 4 addımda başlayın

Sənədlərinizi paneldən yükləyirsiniz; başlıq təsdiqini biz izləyirik.

01
Müraciət edin

Formu doldurun, istədiyiniz paketi seçin. Hesabınız açılanda panel şifrəniz e-poçtunuza gəlir.

02
Sənədləri yükləyin

Firma məlumatlarını, vergi vərəqəsini, səlahiyyətli şəxsin şəxsiyyətini, imza sirkulyarını və öhdəliyi paneldən göndərin.

03
Başlıq təsdiqi

SMS başlığınız (3-11 simvol) sənədlər tamdırsa 1-3 iş günü ərzində təsdiqlənir.

04
Göndərin

Paneldən Excel ya da kataloqla toplu göndəriş edin və ya SMS API ilə proqramınıza bağlayın.

TVS

SMS API haqqında

Developerlər bölməsindəki SMS API səhifəsində; nümunə sorğu, cavab və xəta kodları ilə.

Paneldə Toplu SMS > API və Ayarlar ekranından yaradırsınız; webhook ünvanınızı da eyni ekrandan daxil edirsiniz.

Eyni sorğuda təkrarlanan nömrə bir dəfə göndərilir; təkrar qoruması açıqdırsa eyni gün eyni mətn eyni nömrəyə ikinci dəfə getmir.