SMS · SMS API

SMS API: yazılımınızdan tek istekle SMS.

CRM, ERP, e-ticaret altyapınız ya da kendi uygulamanızdan SMS gönderin, teslim durumunu sorgulayın, gelen mesajları ve ret bildirimlerini alın. REST ve JSON; kimlik doğrulama Bearer anahtarla, olaylar HMAC imzalı webhook ile.

Hemen başvurun SMS API dokümanı

# kişiye özel 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"}]}' # cevap {"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}} # teslim olayı (webhook, HMAC imzalı) X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}

Neler var

Özellikler

Tek istekle gönderim

send eylemi: tek numara, liste ya da kişiye özel farklı metinler; yer tutucular alıcı alanlarından doldurulur.

Teslim raporu

status ile gönderim numarası ya da kendi referansınız (custom_ref) üzerinden her mesajın durumunu sorgulayın.

İmzalı webhook

Teslim, gelen SMS ve ret olayları X-Buluthat-Signature (HMAC-SHA256) ile imzalanıp adresinize gelir; başarısız olursa geri çekilerek tekrar denenir.

Kontör ve başlık sorgusu

balance ile kalan SMS / OTP kontörü ve son kullanma tarihleri, headers ile onaylı başlıklarınız.

Planlı gönderim ve iptal

send_at ile 90 güne kadar ileri tarih; cancel ile gönderilmemiş mesajlar iptal edilir, kontör iade edilir.

Kara liste

blacklist_add / blacklist_remove ile kendi ret listenizi eşitleyin.

OTP uçları

otp_send, otp_verify ve otp_status ile doğrulama kodunu ayrı bir tablo tutmadan yönetin.

İYS ve hız ayarı

is_commercial ile ticari ileti İYS kontrolünden geçer; rate_per_minute ile dakikadaki gönderimi sınırlarsınız.

Başvuru

SMS göndermeye 4 adımda başlayın

Evraklarınızı panelden yüklersiniz; başlık onayını biz takip ederiz.

Başvurun

Formu doldurun, istediğiniz paketi seçin. Hesabınız açılınca panel şifreniz e-postanıza gelir.

Evrakları yükleyin

Firma bilgileri, vergi levhası, yetkili kimliği, imza sirküleri ve taahhütnameyi panelden iletin.

Başlık onayı

SMS başlığınız (3-11 karakter) evraklar tamamsa 1-3 iş günü içinde onaylanır.

Gönderin

Panelden Excel ya da rehberle toplu gönderim yapın veya SMS API ile yazılımınıza bağlayın.

Hemen başvurun SMS fiyatları

SSS

SMS API hakkında

Geliştiriciler bölümündeki SMS API sayfasında; örnek istek, cevap ve hata kodlarıyla.

Panelde Toplu SMS > API ve Ayarlar ekranından oluşturursunuz; webhook adresinizi de aynı ekrandan girersiniz.

Aynı istekte tekrarlanan numara bir kez gönderilir; mükerrer koruması açıksa aynı gün aynı metin aynı numaraya ikinci kez gitmez.

SMS

Birlikte daha güçlü

Toplu SMS, doğrulama kodu, gelen SMS ve API — onaylı başlığınızla.