SSS
Toplu SMS API soruları ve cevapları
Hesaplar, gönderme, fiyatlar, teslimat raporları ve API hakkında 39 cevap, koddaki sınırlara göre kontrol edilmiştir. Uç noktalar ve alanlar için detaylar API referansı içinde bulunur.
Hizmet
BulkSMSAPI nedir?
Geliştiriciler için bir toplu SMS API'si: REST üzerinden tek bir metin veya istek başına 10.000'e kadar numarayı 227 ülkeye gönderin, her mesajı imzalı webhook'larla takip edin ve ön ödemeli bakiyeden mesaj başına ödeme yapın. Bir web konsolu, kod yazmadan yapıştırılan bir liste veya CSV'den kampanyalar gönderir.
Toplu SMS API'sini kimler kullanır?
Kendi sistemlerinden metin gönderen ürün ve mühendislik ekipleri: giriş ve kayıt kodları, sipariş ve teslimat güncellemeleri, randevu hatırlatıcıları, ödeme uyarıları, servis bildirimleri ve pazarlama kampanyaları. HTTPS isteği yapabilen herkes kullanabilir.
Hangi ülkelere gönderebilirim?
227 ülke ve bölge, fiyatlandırma sayfasında ve ülkeler sayfalarında fiyatlarıyla listelenmiştir. Bir istek ülkeleri karıştırabilir: her numara ait olduğu ülkeye göre fiyatlandırılır.
Aylık bir ücret veya sözleşme var mı?
Hayır. Ön ödemeli bakiyeden mesaj segmenti başına ödeme yaparsınız ve aylık ücret, kurulum ücreti veya minimum hacim yoktur. Bakiyenin son kullanma tarihi yoktur.
Ücretsiz deneme var mı?
Hesaplar sıfır bakiyeyle başlar ve ilk bakiye yükleme her şeyi açar. İlk bakiye yükleme %40'a kadar bonus ekler, böylece ilk mesajlar daha ucuza mal olur. Fiyatlar herkese açıktır ve tahmin endpoint'i ve konsol, herhangi bir şey gönderilmeden önce kesin maliyeti gösterir.
Hesap ve API anahtarları
Nasıl hesap oluştururum?
API Anahtarı Al'ı açın. Tarayıcınız acct_ ile başlayan bir hesap anahtarı oluşturur; kopyalayın veya bir metin dosyası olarak kaydedin, kaydettiğinizi onaylayın ve hesap hazırdır. Hesap anahtarı tek giriş bilgisidir: yönetilecek e-posta veya şifre yoktur.
Hesap anahtarımı kaybedersem ne olur?
Yalnızca anahtarlanmış bir hash'ini saklıyoruz, bu nedenle destek ekibimiz dahil hiç kimse bunu tekrar gösteremez. Bir şifre yöneticisinde saklayın. Hala oturum açıkken konsol çalışmaya devam eder ve ondan destekle iletişim kurabilirsiniz.
API anahtarını nasıl alırım?
Konsolun API anahtarları sayfasında, ilk bakiye yüklemesi tamamlandıktan sonra. Anahtarı adlandırın, oluşturun ve bir kez kopyalayın: bsa_live_ ile başlar. Bir hesap, her biri kendi adı ve oran sınırı sayacına sahip 10 aktif anahtar tutabilir.
Üretim ve hazırlık ortamları için farklı anahtarlar kullanabilir miyim?
Evet. Uygulama veya ortam başına bir anahtar oluşturun ve ona bir ad verin. Her anahtar, en son ne zaman kullanıldığını gösterir ve birini iptal etmek diğerlerinin çalışmasını etkilemez.
Kaç hesap oluşturabilirim?
Ağ adresi başına en fazla 3 hesap. Çoğu ekip, birden fazla API anahtarına sahip bir hesaba ihtiyaç duyar.
Mesaj gönderme
Bir istek kaç numara alabilir?
POST /v1/batches, her istekte en fazla 10,000 numara alır, ya herkes için bir metin ya da her numara için kişisel bir metin. Konsol, her kampanya için 50,000 numara alır. Daha büyük listeler birkaç isteğe bölünür.
Mesajlar ne kadar hızlı gönderilir?
Kuyruk her iki saniyede bir çalışır ve hesap başına dakikada en fazla 1,200 mesajı, kabul edildikleri sırayla ağa iletir. Tek bir mesaj genellikle istekten birkaç saniye sonra gönderilir.
Telefon numaraları hangi formatta olmalı?
Uluslararası E.164: bir artı işareti, ülke kodu ve ulusal numara, örneğin +14155550123. Boşluklar, tireler, parantezler ve 00 öneki otomatik olarak temizlenir; kopyalar ve okunamayan numaralar bir kenara ayrılır ve ücretlendirilmez.
Bir mesaj ne kadar uzun olabilir?
En fazla 10 segment: GSM-7'de 1,530 karakter veya Unicode'da 670 karakter. Bir segment, GSM-7'de 160 veya Unicode'da 70 karakter tutar; daha uzun metinler 153 veya 67 karakterlik parçalara bölünür ve telefonda tekrar birleştirilir.
Mesajım neden beklediğimden daha fazla segment kullandı?
GSM-7 alfabesinin dışında bir karakter, örneğin kıvrımlı bir tırnak işareti, bir emoji veya á veya ç gibi bir harf, tüm metni Unicode'a çevirir ve her segmentte 70 karakter olur. Konsol bestecisi bu karakterleri adlandırır ve POST /v1/estimates göndermeden önce kodlamayı döndürür.
Mesajları zamanlayabilir miyim?
Evet. API isteğine send_at ekleyin veya konsolda 2 dakika ile 45 gün öncesine kadar bir zaman seçin. Zamanlanmış bir parti başlayana kadar iptal edilebilir ve tam maliyeti bakiyeye geri döner.
Her alıcı farklı bir metin alabilir mi?
Evet. API üzerinden, her alıcı için bir {to, text} içeren bir parti gönderin. Konsolda, ek sütunlar içeren bir listeyi yapıştırın veya yükleyin ve metinde {{1}} ile {{9}} arasındaki birleştirme alanlarını kullanın.
Mesajlarıma bir çıkış hattı ekleniyor mu?
Ayarlarda bir kez çıkış ifadenizi belirleyin, örneğin bir bağlantı veya e-posta adresi, ve konsol kutuyu işaretlediğinizde bunu kampanya metinlerine ekler. API üzerinden tam metni kontrol edersiniz, bu nedenle pazarlama mesajlarına bu satırı kendiniz ekleyin. Gönderme listesinde olmayan numaralar konsol ve API tarafından atlanır ve ücretlendirilmez.
Önce bir test mesajı gönderebilir miyim?
Evet. Konsol, bir kampanyadan önce bir numaraya test gönderimi yapar ve API üzerinden POST /v1/messages ile kendi telefonunuza tek bir mesaj gönderebilirsiniz.
Fiyatlar ve ödemeler
Bir SMS ne kadar tutar?
Numaranın ülkesine bağlıdır: her ülkenin segment başına bir fiyatı vardır, $0.00247'den başlar (Brezilya). Fiyatlandırma sayfası ve GET /v1/pricing her ülkeyi listeler.
Bir partinin maliyeti nasıl hesaplanır?
Her alıcı için: ülkesinin segment başına fiyatı ile metnin segment sayısı çarpılır. Toplam, istek kabul edildiğinde bakiyeden alınır ve cevap bunu maliyet olarak gösterir.
Minimum bakiye yükleme miktarı nedir?
$40. Bakiye yükleme miktarı $40 ile $5.000 arasında herhangi bir değer olabilir. İlk yüklemede, ödeme öncesinde her miktar için gösterilen %40'a kadar bonus eklenir.
Nasıl ödeme yapabilirim?
Konsolda, Faturalama sekmesi sayfa üzerinde bir ödeme penceresi açar. Miktarı seçip kripto para ile ödeme yaparsınız. Ödeme sayfasında tam miktar ve adres gösterilir. Ödemeler sayfasında her adım listelenir.
Başarısız mesajlar iade ediliyor mu?
Evet. Bir mesaj başarısız olduğunda, ücreti otomatik olarak bakiye hesabınıza iade edilir ve deftere iade satırı olarak kaydedilir. İptal edilen planlanmış bir toplu gönderimin tamamı iade edilir.
Bakiyemi çekebilir miyim?
Bakiye, mesaj ödemeleri için kullanılır ve hesabınızda süresiz olarak kalır. Başarısız veya iptal edilen mesajların iadeleri de bakiyeye geri yüklenir.
Fiyatlar değişiyor mu?
Fiyatlar, ağ maliyetleri değiştiğinde güncellenebilir. Güncel fiyat listesi tarihlidir, API her fiyatla birlikte tarihi döndürür ve kabul edilmiş mesajlar işlendikleri fiyattan ücretlendirilir.
Teslimat ve raporlar
Bir mesajın teslim edildiğini nasıl anlarım?
Her mesaj sıraya alındı, gönderildi, teslim edildi veya başarısız oldu durumlarından geçer. Son durumlar için imzalı bir etkinlik almak üzere konsolda bir webhook URL'si ekleyebilir veya GET /v1/messages/{id} ve GET /v1/batches/{id} uç noktalarını sorgulayabilirsiniz.
Webhook'lar nasıl imzalanıyor?
Standard Webhooks formatında: webhook-id, webhook-timestamp ve webhook-signature başlıkları kullanılır. İmza, whsec_ gizli anahtarınızla id, timestamp ve ham gövdenin HMAC-SHA256 karmasıdır. Dökümanlarda Node.js, Python, PHP ve Go için doğrulama kodu bulunur.
Webhook uç noktam çalışmıyorsa ne olur?
Her etkinlik için yaklaşık 24 saat içinde 10 deneme yapılır ve her deneme HTTP durumuyla konsolda listelenir. Ayrıca mesaj uç noktalarını istediğiniz zaman sorgulayabilirsiniz.
Bir mesaj neden başarısız olur?
Telefon uzun süre kapalı olabilir, numara artık hizmet dışı olabilir veya ağ mesajı reddedebilir. Başarısız durum bir hata kodu taşır ve ücret iade edilir.
Mesaj kayıtları ne kadar süre saklanır?
Toplu gönderimler, mesajlar ve bakiye defteri hesabınızda ve API'de kalır. İstek günlüğü son 500 API çağrınızı, webhook günlüğü ise son 500 teslimatınızı saklar.
Geliştiriciler için
Bir SDK var mı?
API, HTTPS üzerinden düz JSON kullanır, bu nedenle herhangi bir dilin standart kütüphanesi yeterlidir. Dökümanlarda curl, Node.js, Python, PHP ve Go için tam örnekler bulunur ve /openapi.json'daki OpenAPI spesifikasyonu çoğu dilde yazılı bir istemci oluşturur.
İstek sınırları nedir?
Her API anahtarı için dakikada 600 istek. Her yanıt X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıkları içerir ve 429 yanıtında Retry-After başlığı bulunur.
Zaman aşımından sonra güvenle nasıl yeniden deneyebilirim?
POST isteklerini bir Idempotency-Key başlığı ile gönderin ve aynı anahtarla yeniden deneyin. 24 saat boyunca aynı anahtar ve gövde, yeniden göndermek yerine ilk yanıtı döndürür.
API anahtarı olmadan fiyatları kontrol edebilir miyim?
Evet. GET /v1/pricing ve GET /v1/pricing/{country} uç noktaları herkese açıktır, bu nedenle bir ödeme sayfası veya kontrol paneli canlı fiyatları gösterebilir.
Kodumun ne gönderdiğini nerede görebilirim?
Konsol, son 500 API çağrınızın yöntemini, yolunu, durumunu ve zamanını içeren bir istek günlüğüne sahiptir; bu, toplu işler, mesajlar ve webhook günlüğünün yanında bulunur.
Konsol
Kod yazmadan gönderebilir miyim?
Evet. Konsolda, numaraları yapıştırabilir veya en fazla 50.000 satır içeren bir CSV dosyası yükleyebilir, birleştirme alanlarıyla metni yazabilir, her alıcı için önizlemeyi ve ülke başına maliyeti kontrol edebilir ve hemen veya belirli bir zamanda gönderebilirsiniz.
Konsol ne gösteriyor?
Bakiye, canlı sayılarla son toplu işler, mesajları ve durumlarıyla her toplu iş, bakiye yüklemeleri ve defter, API anahtarları, webhook ayarları ve teslimatları, istek günlüğü, fiyat listesi, destek talepleri ve ayarlar.
Destekle nasıl iletişime geçebilirim?
Konsolun Destek sayfasından. Ödeme soruları ilk günden itibaren sorulabilir; diğer konular ilk bakiye yüklemesi yapıldıktan sonra açılır.
Hala bir sorunuz mu var?
Oturum açmış hesaplar konsoldan bir destek talebi açabilir. Ödeme soruları ilk günden itibaren sorulabilir.