Perpesanan dan suara untuk agen AI.

Pilih metode akses

Agen biasanya membutuhkan dua hal: fakta untuk perencanaan, dan cara untuk bertindak. BroadNet memisahkan keduanya. Server pengetahuan menjawab pertanyaan tanpa akun; pengiriman selalu membutuhkan token Anda.

Apa yang dapat dikirim oleh agen

Aturan yang sama berlaku untuk ranah apa pun yang digunakan agen: pengirim yang terdaftar, penerima yang telah memberikan persetujuan, dan konten yang sesuai dengan saluran tersebut.

Contoh penerapan: seorang agen merencanakan peluncuran OTP

Seorang pengguna meminta agen untuk merencanakan pengiriman kode OTP ke UEA. Agen memanggil empat alat pada server pengetahuan publik. Hasil di bawah ini adalah output asli server, yang telah dipangkas ke kolom yang digunakan agen.

Salin dan tempel

Contoh hanya menggunakan angka fiktif. Baca token dari variabel lingkungan; jangan pernah menempelkannya ke dalam chat atau file yang dikomit.

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

Titik masuk yang dapat dibaca mesin

Agen yang menjelajah alih-alih terhubung dapat membaca segalanya dari file teks biasa. Tidak ada yang memerlukan login.

• llms.txt
  /llms.txt

  Indeks situs untuk model bahasa, dengan bagian tentang akses dan batasan agen, ditambah satu file per bahasa.

• Keahlian agen
  /.well-known/agent-skills/index.json

  Lima buku panduan SKILL.md: cakupan dan harga, registrasi sender ID, uji coba SMS pertama, akses uji coba, dan menghubungkan ke server MCP.

• Kartu agen A2A
  /.well-known/agent-card.json

  Kartu Agent2Agent untuk alat pengetahuan read-only yang sama, disajikan melalui JSON-RPC pada /a2a.

• Katalog API
  /.well-known/api-catalog

  Kumpulan tautan RFC 9727 yang mengarah ke spesifikasi OpenAPI, dokumentasi API, kedua server MCP, dan halaman status.

• Kartu server MCP
  /.well-known/mcp.json

  Kartu server yang menjelaskan kedua server MCP, transport, dan autentikasinya.

• OpenAPI 3.1
  /developers/openapi.yaml

  Deskripsi lengkap REST API: unduh, atau buat klien bertipe dari deskripsi ini.

• Versi Markdown
  /pricing/sms/uae.md

  Tambahkan .md pada sebagian besar URL halaman, atau kirim Accept: text/markdown, untuk salinan Markdown halaman yang bersih.

• Berkas data
  /data/coverage.json

  Cakupan, harga yang dipublikasikan, dan regulasi untuk setiap pasar sebagai JSON (CSV untuk cakupan dan harga).

• Status JSON
  /status/api/v2/summary.json

  Keterjangkauan situs web, gateway API, dan kedua endpoint MCP yang terukur, dalam format ringkasan Statuspage v2.

Aturan yang harus diikuti agen

Agen yang mengirim pesan bertindak atas nama merek Anda dengan kredensial Anda. Masukkan aturan ini ke dalam instruksi dan alatnya.

• Persetujuan sebelum konten

  Hanya kirim pemasaran ke penerima yang telah memberikan persetujuan (opt-in), dan simpan catatan persetujuan tersebut. Alat sender_id_rules mengembalikan aturan opt-in untuk setiap pasar.

• Hormati opt-out

  Pesan promosi menyertakan kata kunci opt-out pasar, seperti STOP. Agen tidak akan pernah mengirim pesan ke nomor yang telah opt-out.

• Hanya sender ID yang terdaftar

  Banyak pasar mewajibkan pra-registrasi sender ID alfanumerik. Agen menggunakan sender ID yang telah disetujui pada akun Anda, bukan sender ID buatan.

• Hormati jam tenang

  Beberapa pasar melarang pengiriman pemasaran pada malam hari. sender_id_rules mengembalikan jam tenang yang bersumber dari sana; OTP dan peringatan biasanya diizinkan sepanjang waktu.

• Lindungi alur OTP dari pumping

  Bot dapat memicu pengiriman OTP ke nomor yang memberikan keuntungan bagi mereka. Batasi permintaan kode per nomor, IP, dan perangkat, serta blokir destinasi yang tidak Anda layani. MyOTP menyertakan perlindungan ini secara default.

• Seseorang mengonfirmasi setiap pengiriman

  Pastikan klien bertanya sebelum menggunakan alat pengirim apa pun, terutama ke banyak penerima, dan aktifkan hanya alat yang dibutuhkan agen.

• Uji pada nomor Anda sendiri

  Dengan kredensial uji coba, hanya kirim ke nomor terverifikasi milik Anda sendiri. Contoh dan prompt menggunakan nomor fiktif.

• Jaga agar token tetap berada di luar obrolan

  Token adalah kredensial pengiriman. Muat dari variabel lingkungan, jangan pernah dari prompt, dan cabut jika bocor.

Terkait

Pertanyaan