---
title: "Sekiz kanal için tek mesajlaşma API'si"
description: "SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-posta ve push için tek REST API; webhook'lar, SMPP, TypeScript SDK ve MCP sunucusu ile."
canonical: "https://omnichannels.ai/tr/developers/"
language: "tr"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

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

Canonical: https://omnichannels.ai/tr/developers/
Language: tr
Publisher: OmniChannels.ai by BroadNet Technologies

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.

**Kısa yanıt:** 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.

## Geliştirici olarak neler elde edersiniz

- **Tek REST API, sekiz kanal:** SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-posta ve push; tek temel URL, tek Bearer token ve tek hata biçimini paylaşır. Böylece yeni bir kanal eklemek, yeni bir tedarikçi değil yeni bir uç nokta eklemek anlamına gelir.
- **OpenAPI 3.1 ve TypeScript SDK:** Postman'e aktarabileceğiniz veya istemci üretmek için kullanabileceğiniz OpenAPI 3.1 şemasında yaklaşık 225 dokümante edilmiş yol; ayrıca TypeScript ve Node.js için resmi @broadnet/cpaas-sdk paketi.
- **İletim durumu webhook'ları:** Durumlar kanallar arasında normalleştirilir (SUBMITTED, SENT, DELIVERED, READ, FAILED ve REJECTED) ve HTTPS uç noktanıza iletilir; güvence olarak sorgulama ve yeniden iletme uç noktaları da vardır.
- **Yüksek hacimli SMS için SMPP v3.4:** IP izin listesi ile TLS üzerinden transceiver bağlantıları, hesabınız için tahsis edilir ve REST API ile aynı doğrudan operatör rotalarını kullanır.
- **Yapay zeka ajanları için MCP sunucusu:** Claude, Cursor veya herhangi bir MCP istemcisini token'ınızla API'ye bağlayın; ajanlar sizin belirlediğiniz sınırlar içinde mesaj gönderebilir ve iletim raporlarını okuyabilir.
- **Canlıya geçmeden önce test edin:** Test kimlik bilgileri, üretimle aynı temel URL üzerinden yalnızca doğrulanmış numaralarınıza gönderim yapar; böylece canlıya geçişte kodunuz değişmez.
- **Mühendislerden destek:** Bir mesajlaşma mühendisi kullanım senaryonuzu inceler; REST veya SMPP tasarımı, SMS başlıkları ve ülke kuralları konusunda yardımcı olur ve canlıya geçişe kadar yanınızda kalır.
- **Bayiler için tasarlandı:** 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, hesap yönetimi için ise bir reseller API'si bulunur.

## Geliştirici yüzeyi bir bakışta

| Öğe | Ayrıntılar |
|---|---|
| REST API (SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-posta, push) | Temel URL: https://api.broadnet.me, Bearer token kimlik doğrulaması. Test erişimi kısa bir talepten sonra verilir. |
| İletim durumu webhook'ları | Hesap veya alt hesap bazında yapılandırılır. Durumlar kanallar arasında normalleştirilir. |
| TypeScript SDK | npm install @broadnet/cpaas-sdk axios. Diğer diller REST API'yi doğrudan çağırır veya bir istemci üretir. |
| OpenAPI 3.1 şeması | https://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 sunucusu | Streamable HTTP üzerinden https://mcp.broadnet.me/mcp, token'ınızla kimlik doğrulaması. |
| TLS üzerinden SMPP v3.4 | Bağ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ı) | Hesap ekibiyle birlikte tahsis edilir; REST API'de herkese açık sesli uç noktası yoktur. |

## İlk istekten canlı ortama

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. **İ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. **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. **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. **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.

## 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.

Güncelleme: 2026-10-10