Bulk SMS API

Geliştiricilerin bir öğleden sonra entegre edebileceği Bulk SMS API

BulkSMSAPI, geliştiriciler için bir toplu SMS API'sidir: REST üzerinden 227 ülkeye tek bir metin veya istek başına 10.000 numaraya kadar bir grup gönderin, her mesajı imzalı webhook'larla takip edin ve ön ödemeli bakiyeden mesaj başına ödeme yapın.

  • Mesaj başına ödeme
  • Aylık ücret yok
  • İmzalı webhook'lar

Amerika Birleşik Devletleri için bir SMS, segment başına $0.00507 maliyetindedir.

BulkSMSAPI'ye genel bakış

Nedir
Toplu SMS göndermek için bir REST API ve web konsolu: tek bir mesaj, binlerce alıcılı bir grup veya yapıştırılan bir listeden kampanya.
Kapsam
227 ülke ve bölge, her biri segment başına kendi fiyatıyla.
Fiyat
Segment başına $0.00247 (Brezilya), Amerika Birleşik Devletleri için $0.00507. Aylık ücret yok, kurulum ücreti yok.
İstekler
HTTPS üzerinden JSON, Bearer API anahtarları, grup isteği başına 10,000 alıcı ve anahtar başına dakikada 600 istek.
Teslimat raporları
Her teslim edilen veya başarısız mesaj için imzalı webhook'lar, etkinlik başına 10 deneme ve polling için GET endpoint'leri.
Planlama
2 dakikadan 45 güne kadar send_at; planlanan gruplar tam iade ile iptal edilir.
Metin
GSM-7 ve Unicode (UCS-2), 10 segmente kadar uzun mesajlar, alıcı başına birleştirme alanları ve kişisel metin.
Ödeme
$40 tutarından ön ödemeli bakiye, barındırılan bir ödeme sayfasıyla yüklenir. Başarısız mesajlar bakiyeye iade edilir.

Yapı taşları

Bir toplu SMS entegrasyonunun ihtiyaç duyduğu her şey

Bir API'nin altı parçası, tümü mesaj başına fiyatlandırılır ve aynı konsolda görülebilir. Birini kullanın veya tam bir bildirim hattı oluşturmak için birbirine bağlayın.

Tekil mesajlar

POST /v1/messages tek bir numaraya bir mesaj gönderir ve anında bir mesaj kimliği ile yanıt verir. Giriş kodları, şifre sıfırlamaları ve ödeme bildirimleri, kodunuz çağırdığı anda gönderilir.

Mesaj gönder

Toplu gönderimler

POST /v1/batches tek bir istekte 10.000 numaraya kadar kabul eder, herkese aynı metni veya her numaraya özel bir metin gönderebilirsiniz. Tekrarlar ve geçersiz numaralar ayrılır ve yanıtta listelenir.

Toplu gönderim yap

İmzalı webhook'lar

Teslim edilen veya başarısız olan her mesaj, imzalı bir JSON etkinliği ile endpoint'inizi çağırır. Her etkinlik yaklaşık 24 saat içinde 10 kez denenir, böylece bir dağıtım size asla bir durum kaybettirmez.

Webhook'ları ayarla

Fiyatlandırma API'si

GET /v1/pricing her ülke için segment başına fiyatı bir anahtar olmadan döndürür. Kendi ürününüzde maliyetleri gösterin veya büyük bir gönderimden önce bir rotayı kontrol edin.

Fiyatları API ile oku

Planlama

Herhangi bir isteğe send_at ekleyin ve toplu gönderim, 2 dakikadan 45 güne kadar olan sürede belirtilen zamana kadar bekler. Başlamadan önce iptal ederseniz, tam maliyet bakiyenize iade edilir.

Toplu gönderimi planla

Tüm ekip için konsol

Bir listeyi yapıştırın veya yükleyin, metni yazın, alıcı başına önizleyin ve kod yazmadan gönderin. API'den gelen her toplu gönderim, canlı sayılarla aynı konsolda görünür.

Konsolu görüntüle

Kodlar, uyarılar ve kampanyalar için tek bir toplu SMS API'si

İşlemsel metinler ve pazarlama kampanyaları aynı endpoint'leri, aynı fiyat listesini ve aynı teslimat etkinliklerini kullanır. Fark, yalnızca bir isteğe kaç numara eklediğinizdir.

İşlemsel mesajlar

Sisteminizdeki bir olay, bir kişiye bir metin, saniyeler içinde gönderilir.

  • POST /v1/messages, metin kuyruğumuzdan çıkmadan önce mesaj kimliği, fiyat ve durum ile 202 yanıtı verir.
  • Kendi sipariş veya kullanıcı kimliğinizi referans olarak ekleyin ve bu mesaj için her webhook'da geri döner.
  • Güvenle yeniden deneyin: aynı Idempotency-Key, 24 saat boyunca iki kez göndermek yerine ilk yanıtı döndürür.
Mesaj gönder

Toplu kampanyalar

Tek bir metin veya kişi başına bir metin, tek bir istekle binlerce kişiye gönderilir.

  • POST /v1/batches her istekte 10,000 numara alır; konsol, bir yapıştırma veya CSV dosyasından her kampanya için 50,000 alır.
  • Numaralar sizin için temizlenir: boşluklar, tireler ve 00 önekleri düzeltilir, kopyalar ve geçersiz numaralar listelenir ve atlanır.
  • Önce POST /v1/estimates ile tahmin edin: toplam maliyet, segmentler ve ülkeye göre bölünme, hiçbir şey göndermeden.
Toplu gönderim yap

Ekipler SMS API'si ile ne gönderiyor

Gerçek sistemlerden gerçek mesajlar: her biri tek bir API çağrısı veya planlanmış bir toplu gönderimdir, numaranın ülkesine göre segment başına fiyatlandırılır.

Giriş ve kayıt kodları

Kimlik doğrulama servisinizden POST /v1/messages ile tek kullanımlık bir kod gönderin ve kullanıcı yenisini talep etmeden önce teslimat olayını okuyun.

Sipariş ve teslimat güncellemeleri

Sipariş sisteminiz, bir kargo depodan ayrıldığında API'yi çağırır ve zaman aralığı ile takip kodunu tek bir kısa mesajda gönderir.

Randevu hatırlatıcıları

Gece çalışan bir iş, yarının listesini oluşturur ve her hasta veya müşteri için kişiselleştirilmiş bir metin içeren bir toplu gönderimi bir önceki akşam planlar.

Ödeme ve hesap uyarıları

Kart ödemeleri, transferler ve yeni cihaz girişleri aynı saniyede bir metin tetikler, segment başına fiyatlandırılır ve durumuyla birlikte kaydedilir.

Satış ve lansman kampanyaları

Konsoldan 50.000 numara veya CRM'inizden 10.000'lik gruplar halinde gönderim yapın, her mesaja abonelikten çıkma satırı ekleyin.

Servis ve kesinti duyuruları

Bir servis, uçuş veya teslimat rotası değiştiğinde tüm etkilenen müşterilere anında haber verin ve sorun çözüldüğünde takip edin.

Tek bir istekle toplu gönderim yapın

Konsolda bir API anahtarı oluşturun, BULKSMSAPI_KEY olarak dışa aktarın ve bunlardan herhangi birini çalıştırın. Her örnek yalnızca standart kütüphaneyi kullanan eksiksiz bir programdır ve yanıt, kimliği, maliyeti ve canlı sayımları ile birlikte toplu gönderimdir.
Toplu gönderim oluştur
curl https://bulksmsapi.cc/v1/batches \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: spring-sale-0412" \
  -d '{
    "name": "Spring sale",
    "text": "Spring sale at Northwind: 20% off until Sunday. Opt out: northwind.example/sms",
    "to": [
      "+14155550123",
      "+447400123456",
      "+4915123456789"
    ]
  }'

Fiyatlandırma

Ülkeye göre toplu SMS fiyatları

Her ülkenin mesaj segmenti başına bir fiyatı vardır, ABD doları cinsinden, API ve konsol üzerinden aynıdır. 160 karaktere kadar düz metin bir segmenttir; daha uzun veya Unicode metinler daha fazla kullanır ve fiyat listesi göndermeden önce maliyeti gösterir.
Ülke
Segment başına
$0.00507
10,000 mesaj
$50.70
Amerika Birleşik Devletleri için SMS API

Gönderim fiyatı nasıl hesaplanır

  • Numaranın ülkesinin segment başına fiyatı, metnin segment sayısı ile çarpılır, alıcı sayısı ile çarpılır. Başka bir şey eklenmez.
  • Maliyet, istek kabul edildiğinde bakiyenizden alınır, bu nedenle bir toplu gönderim yetersiz bakiye nedeniyle yarıda kalmaz.
  • Başarısız olan mesajlar otomatik olarak bakiyeye iade edilir ve iptal ettiğiniz planlanmış bir toplu gönderim tamamen iade edilir.
  • Fiyatlar GET /v1/pricing üzerinden canlı olarak okunur, böylece kendi ürününüz aynı sayıları gösterebilir.
Tam fiyat listesi

227 ülkeden 227 tanesi

ÜlkeSMS başına
ABD Virjin Adaları$0.00707
Afganistan$0.03117
Almanya$0.01447
Amerika Birleşik Devletleri$0.00507
Amerikan Samoası$0.02177
Andorra$0.00987
Angola$0.00987
Anguilla$0.01297
Antigua ve Barbuda$0.01327
Arjantin$0.01417
Arnavutluk$0.01357
Aruba$0.01387

Ön ödemeli bakiyeden kullanın

$40 ile $5,000 arasında istediğiniz miktarda bakiye yükleyin ve istediğiniz ülkede istediğiniz hızda harcayın. Bakiye son kullanma tarihi olmadan aylık ücret ödemeden kalır ve ilk yüklemede bonus eklenir.
$40+10% ilk bakiye yükleme

İlk bakiye yüklemede $44 bakiye

Amerika Birleşik Devletleri için yaklaşık 8,678 tek segmentli mesaj

$100+20% ilk bakiye yükleme

İlk bakiye yüklemede $120 bakiye

Amerika Birleşik Devletleri için yaklaşık 23,668 tek segmentli mesaj

$200+25% ilk bakiye yükleme

İlk bakiye yüklemede $250 bakiye

Amerika Birleşik Devletleri için yaklaşık 49,309 tek segmentli mesaj

$300+30% ilk bakiye yükleme

İlk bakiye yüklemede $390 bakiye

Amerika Birleşik Devletleri için yaklaşık 76,923 tek segmentli mesaj

$500+35% ilk bakiye yükleme

İlk bakiye yüklemede $675 bakiye

Amerika Birleşik Devletleri için yaklaşık 133,136 tek segmentli mesaj

$1,000+40% ilk bakiye yükleme

İlk bakiye yüklemede $1,400 bakiye

Amerika Birleşik Devletleri için yaklaşık 276,134 tek segmentli mesaj

Hesap oluştur

Mesaj sayıları Amerika Birleşik Devletleri için segment başına $0.00507 fiyatıyla hesaplanır. Ödeme nasıl çalışır

Yüksek hacim için belirlenen limitler

Aşağıdaki sayılar API'yi çalıştıran koddaki limitlerdir ve dokümanlar her birini ilgili başlık veya hata mesajıyla listeler.

10,000

toplu istek başına numara sayısı

Bir çağrıda liste gönderin, ülkeye göre ayrılıp alıcı başına fiyatlandırılır.

600

anahtar başına dakikadaki istek sayısı

Her yanıttaki oran sınırı başlıkları pencerede kalanı gösterir.

1,200

hesap başına dakikadaki mesaj sayısı

Kuyruk mesajları sırayla rotaya iletir, her iki saniyede bir.

Hesaptan teslimat raporuna dört adımda

Satış çağrısı ve sözleşme yok: hesap tarayıcınızda oluşturulan bir anahtardır ve API ilk bakiye yüklemesinden sonra açılır.
  1. Adım 1

    Hesap oluştur

    Tarayıcınız bir hesap anahtarı oluşturur. Bir kez kaydedin; yönetilecek e-posta veya şifre olmadan tek giriş yöntemidir.

  2. Adım 2

    Bakiyeyi yükle

    Barındırılan ödeme sayfasından $40 ile yükleyin. Bakiye konsolda ve GET /v1/balance ile görüntülenir.

  3. Adım 3

    API anahtarı oluştur

    Uygulama veya ortam başına bir anahtar adı verin, bir kez kopyalayın ve diğerlerine dokunmadan istediğiniz zaman iptal edin.

  4. Adım 4

    Gönder ve dinle

    /v1/messages veya /v1/batches çağrısı yapın ve bir webhook URL'si ekleyin: teslim edilen ve başarısız olan olaylar imzalı olarak gelir.

İlk toplu gönderiminizi bugün yapın

Saniyeler içinde hesap oluşturun, $40 ile bakiye yükleyin ve HTTPS konuşan herhangi bir dilden API'yi çağırın. Mesaj başına fiyatlar $0.00247 ile başlar.

Geliştiriciler için Toplu SMS API'si: REST, Webhook'lar, 227 Ülke | BulkSMSAPI