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

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.

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.

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.

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.

{
  "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}"
      }
    }
  }
}

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}}}'

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

// 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

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

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.

• 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ı.

• 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ı.

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

• MCP sunucu kartı
  /.well-known/mcp.json

  Her iki MCP sunucusunu, taşıma yöntemlerini ve kimlik doğrulamalarını açıklayan sunucu kartı.

• OpenAPI 3.1
  /developers/openapi.yaml

  Tam REST API açıklaması: İndirin veya ondan yazılı bir istemci oluşturun.

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

• 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).

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

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

Sorular