İçeriğe geç
OmniChannels.ai
Menü

Sekiz kanal için tek mesajlaşma API'si

SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-posta ve push mesajlarını kendi kodunuzdan, tek bir temel URL ve tek bir Bearer token ile gönderin. Her mesajı webhook'larla izleyin, SMS hacminizi SMPP ile ölçekleyin ve yapay zeka ajanlarının aynı API'yi MCP üzerinden kullanmasını sağlayın.

Bir API uzmanıyla görüşünCanlı demo planlayın
POST /sms/sendSmscURL
curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "OmniDemo",
    "destinationNumber": "447700900123",
    "message": "Your code is 482913",
    "messageType": "TEXT"
  }'

# 200 OK
2603121407537573731

Gerçek bir istek: POST /sms/sendSms, mesaj kimliğini düz metin olarak döndürür. Token'ı, gönderici adını ve numarayı kendi değerlerinizle değiştirin.

Kısa yanıt

Güncelleme

OmniChannels.ai, geliştiricilere SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-posta ve push için tek bir REST API sunar. OpenAPI 3.1 şemasında yaklaşık 225 dokümante edilmiş yol, TypeScript SDK, iletim durumu webhook'ları, TLS üzerinden SMPP v3.4 ve yapay zeka ajanları için MCP sunucusu bulunur. Test erişimi yalnızca doğrulanmış numaralarınıza gider; mühendisler entegrasyonunuzu destekler, bayiler aynı API'yi kendi markalarıyla kullanabilir.

Güvenilir altyapıResmî Meta Business Solution ProviderGoogle RBM iş ortağıGSMA üyesiISO/IEC 27001:2022ISO/IEC 27018ISO 9001:2015ISO 22301SOC 2 Type IIGDPR uyumlu

Geliştirici olarak neler elde edersiniz

Tek bir entegrasyon, müşterilerinizin kullandığı her kanalı kapsar; üretim ekibinin beklediği araçlarla birlikte.

REST API, webhook'lar, TLS üzerinden SMPP ve yapay zekâ ajanları için MCP etiketli çizimli bir mesajlaşma çekirdeği, trafiği WhatsApp, SMS, RCS, Messenger, Instagram, Telegram, e-posta ve anlık bildirime yönlendiriyor.

Geliştirici yüzeyi bir bakışta

Bugün nelerin hazır olduğu ve nelerin ekibimizle birlikte kurulduğu.

ÖğeDurumAyrıntılar
REST API (SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-posta, push)KullanılabilirTemel URL: https://api.broadnet.me, Bearer token kimlik doğrulaması. Test erişimi kısa bir talepten sonra verilir.
İletim durumu webhook'larıKullanılabilirHesap veya alt hesap bazında yapılandırılır. Durumlar kanallar arasında normalleştirilir.
TypeScript SDKKullanılabilirnpm install @broadnet/cpaas-sdk axios. Diğer diller REST API'yi doğrudan çağırır veya bir istemci üretir.
OpenAPI 3.1 şemasıKullanılabilirhttps://omnichannels.ai/developers/openapi.json adresinde herkese açık (YAML: /developers/openapi.yaml): bir müşteri token'ının çağırabileceği tüm işlemler; Postman, Insomnia, istemci üretimi ve yapay zeka kodlama araçları için.
MCP sunucusuKullanılabilirStreamable HTTP üzerinden https://mcp.broadnet.me/mcp, token'ınızla kimlik doğrulaması.
TLS üzerinden SMPP v3.4Talep üzerineBağlantılar, aktarım hızı ve IP izin listesi, ekibimiz tarafından hesabınız için tahsis edilir.
Sesli kanal (OTP, IVR, giden aramalar, yapay zeka sesli asistanları)Talep üzerineHesap ekibiyle birlikte tahsis edilir; REST API'de herkese açık sesli uç noktası yoktur.

İlk istekten canlı ortama

Anında self servis kayıt yoktur. Erişim, hesabın kanallarınıza ve ülkelerinize göre kurulabilmesi için kısa bir talepla başlar.

  1. 1

    Test erişimi talep edin

    Bize kanallarınızı, hedef ülkelerinizi, hacimlerinizi ve kullanım senaryonuzu söyleyin. Bir mühendis talebi inceler ve test kimlik bilgilerini verir.

  2. 2

    İlk test mesajınızı gönderin

    Hızlı başlangıç rehberini izleyerek doğrulanmış kendi numaranıza bir SMS gönderin ve iletim durumunu webhook'unuzda alın.

  3. 3

    Entegrasyonu geliştirin

    İhtiyaç duyduğunuz kanalları ekleyin, hataları ve yeniden denemeleri yönetin, mesaj kimliklerini kaydedin. Mühendislerimiz REST veya SMPP tasarımınızı gözden geçirebilir.

  4. 4

    Göndericileri onaylatın

    SMS başlıkları, WhatsApp Business hesapları ve RCS ajanları, geliştirmenizle paralel olarak, her ülkenin ve platformun kurallarına uygun biçimde kaydedilir.

  5. 5

    Canlıya geçin

    Üretim rotaları hesabınız için açılır. Kodunuz aynı temel URL'yi çağırmaya devam eder, bu yüzden geçişte hiçbir şey değişmez.

Bu API ekibiniz için uygun mu?

Şu durumlarda iyi bir seçim

  • Birden fazla tedarikçi yerine SMS, WhatsApp, RCS, sosyal mesajlaşma, e-posta ve push için tek bir entegrasyon istiyorsunuz.
  • Mesaj bazında iletim durumlarına yalnızca bir panelde değil, kendi sistemlerinizde de ihtiyacınız var.
  • Yüksek hacimde SMS gönderiyorsunuz ve REST ile birlikte SMPP de istiyorsunuz.
  • Mesajlaşma hizmetini yeniden satıyorsunuz ve aynı API'ye kendi markanızla, alt hesaplarla birlikte ihtiyacınız var.
  • Mesaj gönderip izlemesi gereken yapay zeka ajanları geliştiriyorsunuz (MCP).

Başlamadan önce bilmeniz gerekenler

  • Anında self servis kayıt yoktur; test erişimi kısa bir talepten sonra verilir.
  • Resmi SDK yalnızca TypeScript içindir; diğer diller düz HTTP veya şemadan üretilmiş bir istemci kullanır.
  • API idempotency anahtarı kabul etmez; bu yüzden entegrasyonunuz yeniden denemeden önce her gönderimi kaydetmelidir.
  • Sesli kanal ve SMPP, herkese açık uç noktalar yerine ekibimizle birlikte tahsis edilir.
  • WhatsApp, Messenger ve Instagram gönderimleri, onaylı şablonlar ve mesajlaşma pencereleri dahil Meta'nın kurallarına tabidir.

Belgeler

API'yi entegre etmek için gereken her şey; ilk çağrıdan SMPP bağlantılarına ve yapay zekâ ajanlarına kadar. Teknik belgeler İngilizce yazılmıştır.

API, yazılım yığınınıza nasıl uyuyor?

Sistemleriniz tek bir bearer token ile tek bir REST API'yi çağırır. BroadNet her mesajı doğru kanal ve operatör üzerinden yönlendirir, iletim durumlarını webhook'unuza geri gönderir.

Uygulamanız, CRM'iniz veya yapay zekâ ajanınız

  • Bearer token, tek temel URL
  • Yüksek hacim için TLS üzerinden SMPP 3.4
  • Yapay zekâ ajanları için MCP sunucusu

BroadNet mesajlaşma API'si

https://api.broadnet.me
Yönlendirme ve yedeklemeDoğrudan operatör rotaları

Müşterinizin telefonu

İletim durumları webhook'unuza

SENTDELIVEREDREADFAILED

Geliştirici soruları

Kimlik doğrulamayı nasıl yaparım?

Hesabınızın erişim token'ını her istekte Authorization: Bearer başlığıyla gönderin. Token'lar hesap bazında verilir; kullanıcı adı ve parolayı token ile değiştiren bir uç nokta yoktur. Eksik veya geçersiz token 401 döndürür. Token'ı sunucularınızda tutun, tarayıcı veya mobil kodda asla bulundurmayın.

Temel URL nedir, ayrı bir sandbox var mı?

Her çağrı, sürüm öneki olmadan https://api.broadnet.me adresine gider. Test ve üretim aynı temel URL'yi kullanır: test kimlik bilgileri yalnızca doğrulanmış numaralarınıza gönderir, üretim ise gönderici onayından sonra hesabınız için açılır; yani kodunuz değişmez.

İletim bildirimlerini nasıl alırım?

Durumlar, hesabınızda yapılandırılan webhook URL'sine iletilir: SUBMITTED, SENT, DELIVERED, okuma bilgisi veren kanallarda READ, FAILED ve REJECTED. Ayrıca sorgulama da yapabilirsiniz; örneğin toplu SMS işleri için GET /sms/list, WhatsApp toplu gönderimleri için GET /whatsapp/message/bulk-insights.

Yeniden denemeleri ve mükerrer gönderimleri nasıl yönetmeliyim?

Yalnızca ağ hatalarını, 429 ve 5xx yanıtlarını üstel geri çekilme (exponential backoff) ve jitter ile yeniden deneyin; 4xx hatalarını asla değiştirmeden yeniden denemeyin. API idempotency anahtarı kabul etmediği için her gönderimi yapmadan önce kaydedin, dönen mesaj kimliğini saklayın ve zaman aşımından sonra yeniden göndermeden önce durumu kontrol edin.

Hız sınırları nelerdir?

Dokümante edilen varsayılanlar: REST için saniyede 200 istek (60 saniyeye kadar 500'e varan ani artışlarla), SMPP bağlantısı başına saniyede 1.000 mesaj ve numara sorgulamaları için saniyede 50 istek. Hesabınızın sınırları kimlik bilgilerinizle birlikte netleştirilir. Sınırı aşan istekler Retry-After başlığıyla 429 döndürür.

Hangi diller destekleniyor?

HTTPS isteği yapabilen her dil. Resmi bir TypeScript SDK'sı (@broadnet/cpaas-sdk) vardır; dokümanlarda cURL, Node.js, Python, PHP, Java, .NET, Go ve Ruby için düz HTTP örnekleri yer alır. Ayrıca /developers/openapi.json adresindeki herkese açık OpenAPI 3.1 şemasından bir istemci üretebilirsiniz.

SMS için REST mi SMPP mi kullanmalıyım?

REST çoğu uygulama için uygundur ve tüm kanalları tek API üzerinden verir. TLS üzerinden SMPP v3.4, özellikle zaten bir SMPP istemcisi çalıştırıyorsanız, sürekli yüksek hacimli SMS için uygundur. Bağlantılar, aktarım hızı ve IP izin listeleri hesabınız için tahsis edilir; aynı hesapta ikisini birlikte kullanabilirsiniz.

API üzerinden mesajlaşma hizmetini yeniden satabilir miyim?

Evet. Bayiler aynı API'yi kendi markalarıyla kullanır. Her alt hesabın kendi kredisi, SMS başlıkları, kullanıcıları ve webhook'ları vardır; reseller API'si hesap oluşturma, kredi yükleme, tarife yönetimi ve raporlamayı kapsar. Erişim talep ederken yeniden satış yapacağınızı belirtin ki yapıyı sizinle birlikte kuralım.

Bu konudaki rehberler

Platformun diğer özelliklerini keşfedin

Test erişimi talep edin

Kanallarınızı, ülkelerinizi ve hacimlerinizi bize söyleyin. Bir mühendis doğrulanmış numaralarınız için test kimlik bilgilerini hazırlar ve canlıya geçişi planlamanıza yardımcı olur.

Yazılım yığınınızı ve neyi bağlamak istediğinizi paylaşın. Bir çözüm mühendisi sizinle iletişime geçecek.

Bir API uzmanıyla görüşün

Size yanıt vermek için kullanırız. Herhangi bir kurumsal alan adı olabilir.

İsteğe bağlı. Arama tercih ediyorsanız ülke kodunu ekleyin.

Ayrıntı ekleyin (isteğe bağlı)
İlgilendiğiniz kanallar(isteğe bağlı)

Ekibimiz entegrasyonunuz konusunda sizinle iletişime geçecek.