İlk test SMS'inizi kimlik bilgilerini aldıktan beş dakika sonra gönderin.
Test erişimi talep edin; bir iş günü içinde test kimlik bilgilerinizle yanıt verelim. Ardından token'ı alın, TypeScript SDK'yı kurun ve şunu çağırın: smsSendsmsPost. İlk test mesajınız, kimlik bilgilerini aldıktan yaklaşık beş dakika sonra kendi doğruladığınız numaraya ulaşır. Aşağıdaki tüm örnekler kopyalanmaya hazırdır ve 5. adım, canlıya geçişten önce nelerin kontrol edilmesi gerektiğini kapsar.
İlk mesajınıza giden tek yol, her adımın süresiyle birlikte.
- 01
Test erişimi talep edin
1 iş günü içinde yanıt verilirBir mesajlaşma mühendisi, test kimlik bilgilerinizle birlikte size yanıt verir ve ülkeleriniz, hacimleriniz ve kullanım durumunuz üzerine 30 dakikalık bir görüşme planlar.
- 02
İlk test mesajı
Kimlik bilgilerinden yaklaşık 5 dakika sonraHızlı başlangıç koduyla kendi doğruladığınız numaranıza bir test mesajı gönderin. İletim raporu webhook adresinize iletilir.
- 03
Entegrasyon
2–5 iş günüKod örnekleriyle aynı uç noktaya karşı kendi test kimlik bilgilerinizle kurulum yapın ve test edin. REST veya SMPP üzerinde bir BroadNet mühendisi size eşlik eder.
- 04
Onay
3–10 iş günüGönderici kimliği, trafik amacı ve hedef kuralları incelenir ve entegrasyonunuzla eş zamanlı olarak gönderici adları her bir düzenleyici kurum nezdinde kaydedilir.
- 05
Canlı ortam
Geçiş günüHesabınız için üretim erişimi ve rotalar etkinleştirildi. Entegrasyonunuz halihazırda https://api.broadnet.me ortamını çağırıyor.
Genel olarak: Çoğu pazar için talepten canlıya geçiş süreci 5–15 iş günüdür; bir düzenleyicinin gönderici adı için gereken ön hazırlık süresi daha uzun olan pazarlarda bu süre uzayabilir.
- UygulamanızREST API veya SMPP üzerinden gönderilir
- BroadNet platformuHer mesajı doğrular, yönlendirir ve faturalandırır
- Operatör SMSC’siDoğrudan operatör bağlantısı
- Abone cihazıMesaj iletilir
Erişim token'ınızı alın.
Erişim token'ınız test kimlik bilgilerinizle birlikte gelir: test erişimi talep edin, bir iş günü içinde yanıt verelim. Token'ı BROADNET_TOKEN ortam değişkeninde saklayın ve her çağrıda Authorization: Bearer başlığıyla gönderin. Bu sayfadaki tüm örnekler üretim temel URL'si olan https://api.broadnet.me adresini kullanır.
POST /sms/sendSms ile kendi doğrulanmış numaranıza test SMS gönderin. Gövdesi bir mesaj kimliği (message ID) olan 200 OK yanıtı, başka bir kod yazmadan önce token'ın çalıştığını onaylar.
SDK kurulumunu yapın.
BroadNet'in TypeScript ve Node.js için tek bir resmi SDK'ı vardır: npm install @broadnet/cpaas-sdk axios. Bu, BroadNet OpenAPI spesifikasyonundan oluşturulmuştur. Diğer tüm dillerde, alışılagelmiş HTTP kütüphanenizle REST API'yi çağırabilir veya OpenAPI spesifikasyonundan bir istemci oluşturabilirsiniz.
npm install @broadnet/cpaas-sdk axios
export BROADNET_TOKEN=your_access_token@broadnet/cpaas-sdk üzerinden Configuration ve SMSSMSApi bileşenlerini içe aktarın. İçe aktarma işlemi tamamlanır ve tip kontrolünden geçerse, gönderime hazırsınız demektir.
İlk mesajınızı gönderin.
Temel URL'niz ve token'ınız ile bir SMSSMSApi oluşturun, senderId, destinationNumber, message ve messageType parametreleriyle smsSendsmsPost fonksiyonunu çağırın ve sonucu günlüğe kaydedin. Yanıt gövdesi mesaj ID'sidir; iletim durumunu daha sonra eşleştirmek için bu ID'yi saklayın.
// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";
const sms = new SMSSMSApi(
new Configuration({
basePath: "https://api.broadnet.me",
accessToken: process.env.BROADNET_TOKEN!,
}),
);
const res = await sms.smsSendsmsPost({
sMSSmsRequest: {
senderId: "BroadNet",
destinationNumber: "447700900123",
message: "Your verification code is 482913",
messageType: "TEXT",
},
});
console.log(res.data); // message IDHTTP/1.1 200 OK
2603121407537573731Elinizdeki telefonu kontrol edin. Eğer SMS aldıysanız, en zor kısmı tamamladınız — aşağıdakilerin tamamı operasyonel iyileştirmedir.
İletim durumunu alın.
BroadNet, iletim durumunu hesabınızda yapılandırılan webhook URL'sine iletir: Okunma raporu sunan kanallarda SUBMITTED, SENT, DELIVERED, READ veya FAILED ve REJECTED durumları iletilir. Her güncellemeyi kaydedin, hızlıca 2xx yanıtı verin ve işlemi asenkron olarak işleyin.
import express from "express";
const app = express();
app.post("/webhooks/broadnet", express.json(), async (req, res) => {
// Store the status update first, then acknowledge with a 2xx.
// Statuses: SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED.
await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body });
res.sendStatus(200);
});Cihaz üzerinde onaylandı. Mesaj ağ üzerinden ilerlerken SUBMITTED ve SENT gibi önceki güncellemeler gelir.
Alıcı tarafından, WhatsApp gibi okundu bilgisi veren kanallar üzerinden açıldı.
İletilemedi. Tekrar göndermeden önce numara formatını ve gönderici adınızı kontrol edin.
Telefonunuza bir mesaj gönderin, ardından iletim durumunun DELIVERED olarak güncellenip güncellenmediğini kontrol etmek için sunucu günlüğünüzü inceleyin.
Canlıya geçişten önce.
Onay süreci tamamlandığında üretim ortamı açılır: gönderici kimliği, trafik amacı ve gönderici adları; entegrasyonunuzla eş zamanlı olarak 3–10 iş günü sürer. Onay alındıktan sonra aynı kod üretim trafiğini gönderir. Bu aşamaya kadar token'ı kaynak kontrolünde (source control) tutmayın, iletim durumu webhook'larını kurun ve yeniden deneme politikanızı belirleyin.
- 01Gizli bilgileri kendi ortamınıza taşıyın
BROADNET_TOKEN'ı bir ortam değişkeninde veya secrets manager'ınızda tutun; asla kaynak kontrolünde veya istemci tarafı kodunda bulundurmayın. Sızması durumunda derhal değiştirin.
- 02Güvenle tekrar deneyin ve bakiyenizi takip edin
Ağ hatalarını ve 5xx yanıtlarını üstel geri çekilme (exponential backoff) ile tekrar deneyin. Kabul edilen her gönderim bir mesaj kimliği (message ID) döndürür; bu nedenle körü körüne yeniden göndermek yerine, bu kimliği kaydedin ve iletim durumunu kontrol edin. Toplu SMS gönderimlerinde, her yanıtta kalan krediniz raporlanır.
- 03SDK sürümünü sabitleyin
package.json dosyasında API/cpaas-sdk paketini belirli bir sürüme sabitleyin ve güncellemeleri bilinçli olarak yapın. API yolları herhangi bir sürüm ön eki taşımaz, bu nedenle değişiklikleri changelog ve OpenAPI spesifikasyonundan takip edin.
- 04Hataları durum koduna göre yönetin
Hatalar bir HTTP durum kodu ve status, error, message, errorCode ve requestUri içeren bir ExceptionResponse gövdesi döndürür. 400 ve 401 hatalarını düzeltin; 5xx hatalarını ise bekleme süresi (backoff) uygulayarak tekrar deneyin.
- 05Yeniden deneme politikanızı belirleyin
Varsayılan: 5xx ve ağ hatalarında üstel geri çekilme (exponential backoff) uygulanır, 4xx hatalarında uygulanmaz. Zaman aşımından sonra, ilk istek halihazırda kabul edilmiş olabileceği için tekrar göndermeden önce iletim durumunu kontrol edin.
Aşağıdaki kontrol listesini kodunuz üzerinde uygulayın. Tüm kutucuklar işaretlendiğinde, onay süreci tamamlanır tamamlanmaz entegrasyonunuz canlıya geçmeye hazır olacaktır.
Aynı kod yapıları günde 300 milyondan fazla mesajı işliyor.
Test trafiğiniz bir simülasyon değildir. Yukarıdaki adımlarda yapılandırdığınız her istek, anahtar ve webhook; kurumsal trafiğimizi taşıyan aynı yönlendirme, faturalandırma ve uyumluluk katmanından geçer — bu süreçler aşağıda belirtilen sertifikalar kapsamında her yıl denetlenmektedir.
Hızlı başlangıç soruları
Authorization: Bearer başlığı ve senderId, destinationNumber, message ve messageType (TEXT veya UNICODE) içeren JSON gövdesine sahip bir POST https://api.broadnet.me/sms/sendSms gönderin. Yanıt, mesaj kimliğidir (message ID). /websmpp altındaki eski HTTP API, SMPP dönemi entegrasyonları için hâlâ mevcuttur.
/signup üzerinden test erişimi talep edin; BroadNet mühendisi, bir iş günü içinde test kimlik bilgilerinizle birlikte size dönüş yapacaktır: Authorization: Bearer başlığında göndermeniz gereken erişim belirteci ve test trafiğini nereye göndereceğiniz bilgisi. İlk test mesajınız, bu bilgileri aldıktan yaklaşık beş dakika sonra gönderilebilir.
Tek bir resmi SDK vardır: npm'de TypeScript ve Node.js için @broadnet/cpaas-sdk. Diğer tüm dillerde REST API'yi doğrudan HTTPS üzerinden çağırabilir veya OpenAPI spesifikasyonundan (/developers/openapi.yaml) bir istemci oluşturabilirsiniz.
Sorunuz burada yok mu? Mühendislik ekibimize sorun
Beş adım kaldı.
Gitmek için tek bir anahtar.
Kendi doğrulanmış numaralarınızla test yapın, entegrasyonu tamamlayın ve ardından aynı konsol üzerinden canlı trafiğe geçin. Günde 300 milyondan fazla mesaj taşıyan aynı SDK, aynı uç noktalar (endpoints) ve aynı SLA'lar.