# Yapay zeka ajanları için mesajlaşma ve ses.

- Kanonik URL: https://www.broadnet.me/tr/developers/ai-agents
- Dil: tr
- Son güncelleme: 2026-10-21
- Yayıncı: BroadNet (https://www.broadnet.me)
- Yukarıdaki sayfanın, görüntülenen sayfadan oluşturulmuş Markdown sürümü.

Yapay zeka ajanları için· /developers/ai-agents

Bir yapay zeka temsilcisine kapsama, kurallar ve fiyatları sorgulaması ve BroadNet hesabınız üzerinden SMS, WhatsApp ve tek kullanımlık şifreleri göndermesi için güvenli bir yol sağlayın. Mimarinize uygun olanı kullanın: iki MCP sunucusu, REST API, TypeScript SDK veya düz makine tarafından okunabilir dosyalar.

[Test erişimi talep edin (İngilizce form)](https://www.broadnet.me/tr/contact?intent=test-access) MCP yapılandırmasını kopyalayın

## Giriş yöntemini seçin

Ajanların genellikle iki şeye ihtiyacı vardır: planlama yapmak için gerçekler ve eyleme geçmek için bir yol. BroadNet bunları birbirinden ayrı tutar. Bilgi sunucusu soruları bir hesap olmadan yanıtlar; gönderim yapmak için ise her zaman token'ınız gerekir.

MCP Bilgi sunucusu

Bu web sitesindeki verilerle aynı olan herkese açık, salt okunur yanıtlar: kapsama, gönderici adı kuralları, gösterge niteliğindeki liste fiyatları, düzenlemeler, segment sayıları, yanıtlar, vaka çalışmaları, değişiklik günlüğü ve durum.

https://www.broadnet.me/mcp

**Kimlik Doğrulama:**

Yok

**Erişim:**

Salt okunur · 13 araçları, IP başına dakikada 60 istek

**Şunlar için en iyisi::**

Herhangi bir hesap oluşturulmadan önceki planlama, araştırma ve satış öncesi sorular için.

MCP Mesajlaşma sunucusu

MCP araçları olarak sunulan BroadNet mesajlaşma API yapısıdır. Ajan, verdiğiniz token'ın izinleriyle mesajları gönderir ve takip eder.

https://mcp.broadnet.me/mcp

**Kimlik Doğrulama:**

Bearer <token>

**Erişim:**

Hesabınızda işlem yapar

**Şunlar için en iyisi::**

Bir kullanıcının talebi üzerine gönderim yapan ve her gönderimi bir kişinin onayladığı asistanlar ve ajanlar.

REST API

Bearer-token REST, her kanal için bir yol ailesi, OpenAPI 3.1 spesifikasyonu ile açıklanmıştır. Ajanınız karar verir; kodunuz çağrıyı yapar.

https://api.broadnet.me

**Kimlik Doğrulama:**

Bearer <token>

**Erişim:**

Kodunuz API'yi çağırır · OpenAPI 3.1

**Şunlar için en iyisi::**

Yeniden denemelerin, günlüğün ve sınırların backend tarafında yönetildiği üretim aşamasındaki temsilciler.

TypeScript SDK

OpenAPI spesifikasyonundan oluşturulan tek resmi SDK, @broadnet/cpaas-sdk'dır. Diğer diller REST API yapısını çağırır veya bir istemci oluşturur.

npm i @broadnet/cpaas-sdk

**Kimlik Doğrulama:**

Bearer <token>

**Erişim:**

Kodunuz API'yi çağırır · TypeScript / Node.js

**Şunlar için en iyisi::**

Tam tür tanımlarıyla Node.js temsilci çerçeveleri ve araç tanımları.

## Bir temsilcinin gönderebileceği içerikler

Ajanın kullandığı arayüz ne olursa olsun aynı kurallar geçerlidir: kayıtlı bir gönderici adı, onay vermiş bir alıcı ve kanala uygun içerik.

SMS

İstek başına bir mesaj veya bir dosyadan toplu iş. Faturalandırma segment başına yapılır, bu nedenle uzun veya Latin alfabesi dışındaki metinler daha maliyetlidir: önce segment sayısını belirleyin.

**REST API**

`POST /sms/sendSms` (JSON) `POST /sms/sendbulk` (çok parçalı)

**Mesajlaşma MCP**

SMS gönderim araçları, örneğin `post_sms_send`

WhatsApp

24 saatlik hizmet penceresi içindeki serbest biçimli mesajlar; bu pencere dışında ise yalnızca onaylı şablonlar kullanılabilir. Şablonlar listelenir ve isimle gönderilir.

**REST API**

`POST /whatsapp/message/sendbulk` (çok parçalı)

**Mesajlaşma MCP**

`post_whatsapp_message_send` `get_whatsapp_template_list` `post_whatsapp_template_send`

OTP

Kodu sisteminiz oluşturur; aracı ise bunu bir SMS veya WhatsApp kimlik doğrulama şablonu ile gönderir. Genel API için ayrı bir doğrulama uç noktası bulunmamaktadır, bu nedenle kodun kontrolü sizin sisteminizde kalır.

**REST API**

Mesajdaki kod ile `POST /sms/sendSms`

**Mesajlaşma MCP**

Aynı SMS ve WhatsApp şablon araçları

Ses

Sesli OTP, metinden sese (text-to-speech) aramalar ve IVR, hesap ekibiniz aracılığıyla tanımlanır. Genel OpenAPI spesifikasyonu ve MCP araçları sesli aramaları değil, mesajlaşma kanallarını kapsar. Yapay zeka destekli dış arama (outbound calling) için DialerBee kısmına bakın.

**REST API**

Hesap başına tanımlanır

**Mesajlaşma MCP**

Sesli araç bulunmamaktadır

## Uygulamalı örnek: bir temsilci OTP lansmanı planlıyor

Bir kullanıcı, bir ajandan BAE'ye tek kullanımlık şifre planlamasını ister. Ajan, genel bilgi sunucusundaki dört aracı çağırır. Aşağıdaki sonuçlar, ajanın kullandığı alanlara göre kırpılmış olan sunucunun gerçek çıktısıdır.

Kullanıcı

BAE'deki müşterilere ayda yaklaşık 50.000 giriş kodu göndermek istiyoruz. Neye ihtiyacımız var ve maliyeti ne olacak?

1. 1 Araç çağrısı `check_coverage` BAE kapsama dahil mi, hangi operatörler üzerinden? → `{"country":"UAE"}` Sonuç (kırpılmış) `{ "country": "UAE", "regulator": "TDRA (Telecommunications and Digital Government Regulatory Authority)", "channels": { "sms": "Live", "otp": "Live", "whatsapp": "Live", "rcs": "Available", "voice": "Live" }, "operators": [ { "name": "Etisalat / e&", "status": "Direct" }, { "name": "du", "status": "Direct" }, { "name": "Virgin Mobile", "status": "Operator-grade" } ] }`
2. 2 Araç çağrısı `sender_id_rules` Orada bir gönderici adı için ne gereklidir? → `{"country":"ae"}` Sonuç (kırpılmış) `{ "typicalLeadTime": "5-7 business days", "requirements": [ { "format": "Alphanumeric (Latin or Arabic), up to 11 chars. AD- prefix mandatory on promotional senders.", "preRegistration": "Required — one sender ID per legal entity per use case" } ], "marketingRules": { "quietHours": "TDRA's spam policy bars marketing text messages between 21:00 and 07:00 GST. Transactional OTP and alerts are 24/7." } }`
3. 3 Araç çağrısı `count_sms_segments` Mesaj kaç segmentten oluşuyor? → `{"text":"Your MyShop code is 482913. It expires in 5 minutes. Never share it."}` Sonuç (kırpılmış) `{ "encoding": "GSM-7", "units": 68, "segments": 1 }`
4. 4 Araç çağrısı `estimate_price` Tahmini fiyat nedir? → `{"country":"UAE","channel":"sms","volume":50000}` Sonuç (kırpılmış) `{ "country": "UAE", "unitPriceUsd": 0.0123, "unit": "per SMS segment", "estimatedMonthlyUsd": 615, "ratesReviewed": "2026-09-24", "note": "Indicative list rate, excluding taxes and sender-ID fees. Volume pricing available; a written quote confirms per-operator pricing." }`

Temsilci

BAE, operatör doğrudan (Etisalat / e& · du) kapsama alanındadır. Gönderici adınızın TDRA ile ön kaydı yapılması gerekir, bu genellikle 5–7 iş günü sürer. Kod mesajınız 1 SMS segmentidir. Segment başına $0,0123 tutarındaki örnek amaçlı liste fiyatıyla, vergiler ve gönderici adı ücretleri hariç, 50.000 kodun aylık maliyeti yaklaşık $615 tutarındadır. Bu bir teklif değildir.

Sonraki adım: broadnet.me/signup adresinden test erişimi talep edin. Bir token'ınız olduğunda, mesajlaşma sunucusu aracılığıyla kendi doğrulanmış numaranıza bir test kodu gönderebilirim. Onaylamanız için bu mesajı hazırlayayım mı?

Her dağıtımda canlı araç çıktısından oluşturulmuştur

## Kopyala ve yapıştır

Örnekler yalnızca kurgusal sayılar kullanmaktadır. Token'ı bir ortam değişkeninden okuyun; asla bir sohbete veya işlenen (committed) bir dosyaya yapıştırmayın.

mcp.json — her iki sunucu

```
{
  "mcpServers": {
    "broadnet-knowledge": {
      "type": "http",
      "url": "https://www.broadnet.me/mcp"
    },
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}
```

Alan adları istemciler arasında küçük farklılıklar gösterir (bazıları tip olarak "streamable-http" bekler, bazıları başlıkları ayrı bir ayardan okur). Henüz bir token'ınız yoksa yalnızca bilgi girişini ekleyin.

tools/call estimate_price (bilgi sunucusu)

```
curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"estimate_price",
                 "arguments":{"country":"UAE","channel":"sms","volume":50000}}}'
```

bir adet SMS gönderin (REST API)

```
curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "BroadNet",
    "destinationNumber": "447700900123",
    "message": "Your verification code is 482913",
    "messageType": "TEXT"
  }'

# 200 OK → response body is the message ID, e.g. 2603121407537573731
```

HTTP 200 mesaj kimliğini döndürür. API'nin idempotency başlığı bulunmamaktadır: bir ağ hatasından veya 5xx hatasından sonra, tekrar göndermeden önce mesaj durumunu kimliği ile kontrol edin.

aynı gönderimi TypeScript SDK ile yapı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 ID
```

onaylanmış bir WhatsApp şablonu gönderin (REST API)

```
# Send an approved WhatsApp template
curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-updates \
  -F destinationNo=447700900123 \
  -F messageType=TEMPLATE \
  -F templateName=order_update \
  -F templateLanguage=en_US \
  -F bodyTemplateVariables=INV-400

# 200 OK → the response carries the batchId; per-recipient status
# (SUBMITTED → SENT → DELIVERED → READ) arrives on your webhook.
```

Şablonlar 24 saatlik hizmet penceresinin dışında çalışır; serbest metinler için açık bir pencere gerekir.

## Makine tarafından okunabilir giriş noktaları

Bağlanmak yerine tarama yapan ajanlar, düz dosyalardan her şeyi okuyabilir. Hiçbirinin oturum açmasına gerek yoktur.

- [llms.txt `/llms.txt` Dil modelleri için site dizini; ajan erişimi ve kısıtlamaları üzerine bir bölüm ve her dil için bir dosya içerir.](https://www.broadnet.me/llms.txt)
- [Temsilci becerileri `/.well-known/agent-skills/index.json` Beş SKILL.md kılavuzu: kapsama ve fiyat, gönderici adı kaydı, ilk test SMS, test erişimi ve MCP sunucularına bağlantı.](https://www.broadnet.me/.well-known/agent-skills/index.json)
- [A2A ajan kartı `/.well-known/agent-card.json` Aynı salt okunur bilgi araçları için, /a2a. üzerinde JSON-RPC üzerinden sunulan bir Agent2Agent kartı.](https://www.broadnet.me/.well-known/agent-card.json)
- [API kataloğu `/.well-known/api-catalog` OpenAPI spesifikasyonuna, API dokümanlarına, her iki MCP sunucusuna ve durum sayfasına işaret eden bir RFC 9727 bağlantı seti.](https://www.broadnet.me/.well-known/api-catalog)
- [MCP sunucu kartı `/.well-known/mcp.json` Her iki MCP sunucusunu, taşıma yöntemlerini ve kimlik doğrulamalarını açıklayan sunucu kartı.](https://www.broadnet.me/.well-known/mcp.json)
- [OpenAPI 3.1 `/developers/openapi.yaml` Tam REST API açıklaması: İndirin veya ondan yazılı bir istemci oluşturun.](https://www.broadnet.me/developers/openapi.yaml)
- [Markdown ikizleri `/pricing/sms/uae.md` Sayfanın temiz bir Markdown kopyasını almak için çoğu sayfa URL'sine .md ekleyin veya Accept: text/markdown gönderin.](https://www.broadnet.me/pricing/sms/uae.md)
- [Veri dosyaları `/data/coverage.json` Her pazar için JSON olarak kapsama, yayınlanmış fiyatlar ve düzenlemeler (kapsama ve fiyatlandırma için CSV).](https://www.broadnet.me/data/coverage.json)
- [JSON Durumu `/status/api/v2/summary.json` Web sitesinin, API ağ geçidinin ve her iki MCP uç noktasının ölçülen erişilebilirliği, Statuspage v2 özet formatında.](https://www.broadnet.me/status/api/v2/summary.json)

## Bir temsilcinin uyması gereken kurallar

Mesaj gönderen bir ajan, sizin kimlik bilgilerinizle markanız adına hareket eder. Bu kuralları ajanın talimatlarına ve araçlarına dahil edin.

- İçerikten önce onay Pazarlama mesajlarını yalnızca onay vermiş alıcılara gönderin ve onay kayıtlarını saklayın. sender_id_rules aracı, her pazarın onay kurallarını döndürür.
- Abonelikten çıkma taleplerine uyun Promosyon mesajları, STOP gibi pazarın opt-out anahtar kelimesini taşır. Bir ajan, abonelikten çıkan bir numaraya asla mesaj göndermez.
- Yalnızca kayıtlı gönderici adları Birçok pazar, alfanümerik gönderici adlarının önceden kaydedilmesini gerektirir. Ajan, uydurma bir isim yerine hesabınızda onaylanmış gönderici adlarını kullanır.
- Sessiz saatlere saygı gösterin Birçok pazarda gece saatlerinde pazarlama mesajı gönderimi yasaktır. sender_id_rules kaynaklı sessiz saatleri döndürür; OTP ve uyarılar genellikle gün boyunca serbesttir.
- OTP akışlarını pumping saldırılarına karşı koruyun Botlar, fayda sağladıkları numaralara OTP gönderimlerini tetikleyebilir. Numara, IP ve cihaz başına kod isteklerini hız sınırına tabi tutun ve hizmet vermediğiniz destinasyonları engelleyin. MyOTP bu korumaları varsayılan olarak etkinleştirir.
- Her gönderimi bir kişi onaylar Özellikle çok sayıda alıcıya gönderim yapan herhangi bir araçtan önce istemcinin sormasını sağlayın ve yalnızca ajanın ihtiyaç duyduğu araçları etkinleştirin.
- Kendi numaranızla test edin Test kimlik bilgileriyle, yalnızca kendi doğruladığınız numaraya gönderim yapın. Örnekler ve istemler kurgusal numaralar kullanır.
- Token'ı sohbet dışında tutun Token bir gönderim kimlik bilgisidir. Bir ortam değişkeninden yükleyin, asla bir istemden (prompt) yüklemeyin ve sızarsa iptal edin.

## İlgili

[MCP sunucuları Her iki sunucu hakkında detaylar: uç noktalar, kimlik doğrulama, istemci kurulumu ve demo.](https://www.broadnet.me/tr/developers/mcp) [Hızlı Başlangıç Test erişiminden curl veya TypeScript SDK ile ilk SMS'e.](https://www.broadnet.me/tr/developers/quickstart) [API referansı Her kanalın gönderim uç noktası, Bearer kimlik doğrulaması ve hata formatı.](https://www.broadnet.me/developers/api) [Güvenli yeniden denemeler Mesajı iki kez göndermeden nasıl tekrar denenir.](https://www.broadnet.me/developers/idempotency) [SMS segment sayacı Herhangi bir mesaj metni için kodlama ve segment sayısı.](https://www.broadnet.me/developers/sms-counter) [BroadNet Inference Ses ve belge temsilcileri için Arapça konuşmadan metne ve görüntü modelleri.](https://www.broadnet.me/tr/products/inference) [DialerBee Çağrı merkezleri için çok dilli yapay zeka outbound arama sistemi (dialer).](https://www.broadnet.me/tr/dialerbee) [SMS pumping nedir? OTP dolandırıcılığı nasıl çalışır ve bunu durduran savunmalar nelerdir.](https://www.broadnet.me/tr/answers/what-is-sms-pumping)

## Sorular

### Bir yapay zeka temsilcisi BroadNet üzerinden SMS ve WhatsApp mesajları gönderebilir mi?

Evet. BroadNet token'ınız ile https://mcp.broadnet.me/mcp adresindeki mesajlaşma MCP sunucusuna bağlayın veya kodunuzun https://api.broadnet.me. adresindeki REST API'yi çağırmasını sağlayın. Her iki durumda da temsilci sizin token'ınızın izinleriyle hareket eder, bu nedenle her gönderimi onaylaması için bir kişi gereklidir.

### Kapsama alanı veya fiyatlar hakkında soru sormak için bir temsilcinin hesaba ihtiyacı var mı?

Hayır. https://www.broadnet.me/mcp adresindeki bilgi MCP sunucusu halka açıktır ve yalnızca okunabilir. Web sitesiyle aynı verileri kullanarak kapsama, gönderici adı kuralları, örnek amaçlı liste fiyatları ve düzenlemeleri döndürür. Fiyatlar örnek amaçlı liste oranlarıdır, teklif değildir.

### Bir temsilci tek kullanımlık şifreyi nasıl gönderir?

Sisteminiz kodu oluşturur ve temsilci, POST /sms/sendSms ile bir SMS içinde veya bir WhatsApp kimlik doğrulama şablonu ile gönderir. Genel API ayrı bir doğrulama uç noktasına sahip değildir, bu nedenle kodun kontrolü sizin sisteminizde kalır.

### Bir temsilci sesli arama yapabilir mi?

Voice OTP, metinden sese arama ve IVR hizmetleri BroadNet hesap ekibiniz aracılığıyla sağlanır. Bu hizmetler halka açık OpenAPI spesifikasyonunda veya MCP araçlarında bulunmaz. DialerBee ise BroadNet tarafından çağrı merkezleri için sunulan yapay zeka tabanlı bir outbound arama sistemi (dialer) hizmetidir.

### Nasıl token alabilirim?

Test erişimini /signup üzerinden talep edin. BroadNet bir iş günü içinde test kimlik bilgileriyle yanıt verir. Anında kullanılabilen self-servis anahtar yoktur.

## Ajanınızı BroadNet'e bağlayın

Halka açık bilgi sunucusuyla bugün başlayın. Ajanınız gönderime hazır olduğunda test erişimi talep edin.

[Test erişimi talep edin (İngilizce form)](https://www.broadnet.me/tr/contact?intent=test-access) [MCP sunucu kılavuzu](https://www.broadnet.me/tr/developers/mcp)