# Perpesanan dan suara untuk agen AI.

- URL kanonis: https://www.broadnet.me/id/developers/ai-agents
- Bahasa: id
- Terakhir diperbarui: 2026-10-21
- Penerbit: BroadNet (https://www.broadnet.me)
- Versi Markdown dari halaman di atas, dibuat dari halaman yang dirender.

Untuk agen AI· /developers/ai-agents

Berikan agen AI cara yang aman untuk mencari cakupan, aturan, dan harga, serta untuk mengirim SMS, WhatsApp, dan kode OTP pada akun BroadNet Anda. Gunakan antarmuka mana pun yang sesuai dengan tumpukan teknologi Anda: dua server MCP, REST API, TypeScript SDK, atau file yang dapat dibaca mesin secara langsung.

[Minta akses uji coba (formulir berbahasa Inggris)](https://www.broadnet.me/id/contact?intent=test-access) Salin konfigurasi MCP

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

Server pengetahuan MCP

Jawaban publik yang bersifat read-only dari data yang sama dengan situs web ini: cakupan, aturan sender ID, daftar harga indikatif, regulasi, jumlah segmen, jawaban, studi kasus, changelog, dan status.

https://www.broadnet.me/mcp

**Autentikasi:**

Tidak ada

**Akses:**

Hanya baca · alat 13, 60 permintaan per menit per IP

**Terbaik untuk:**

Perencanaan, riset, dan pertanyaan pra-penjualan, sebelum akun dibuat.

Server perpesanan MCP

Perpesanan BroadNet API yang diekspos sebagai alat MCP. Agen mengirim dan melacak pesan dengan izin dari token yang Anda berikan.

https://mcp.broadnet.me/mcp

**Autentikasi:**

Bearer <token>

**Akses:**

Bertindak pada akun Anda

**Terbaik untuk:**

Asisten dan agen yang mengirim berdasarkan permintaan pengguna, dengan konfirmasi orang untuk setiap pengiriman.

REST API

Bearer-token REST, satu keluarga jalur per saluran, dijelaskan oleh spesifikasi OpenAPI 3.1. Agen Anda yang memutuskan; kode Anda yang melakukan panggilan.

https://api.broadnet.me

**Autentikasi:**

Bearer <token>

**Akses:**

Kode Anda memanggil API · OpenAPI 3.1

**Terbaik untuk:**

Agen produksi di mana backend Anda mengelola retry, logging, dan limit.

TypeScript SDK

Satu-satunya SDK resmi, @broadnet/cpaas-sdk, yang dihasilkan dari spesifikasi OpenAPI. Bahasa lain memanggil REST API atau menghasilkan klien.

npm i @broadnet/cpaas-sdk

**Autentikasi:**

Bearer <token>

**Akses:**

Kode Anda memanggil API · TypeScript / Node.js

**Terbaik untuk:**

Kerangka kerja agen Node.js dan definisi alat dengan tipe lengkap.

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

SMS

Satu pesan per permintaan, atau pekerjaan massal dari file. Penagihan dilakukan per segmen, sehingga teks yang panjang atau non-Latin membutuhkan biaya lebih besar: hitung terlebih dahulu.

**REST API**

`POST /sms/sendSms` (JSON) `POST /sms/sendbulk` (multipart)

**Perpesanan MCP**

Alat pengiriman SMS, contohnya `post_sms_send`

WhatsApp

Pesan bebas di dalam jendela layanan 24 jam; di luar itu, hanya templat yang telah disetujui. Templat terdaftar dan dikirim berdasarkan nama.

**REST API**

`POST /whatsapp/message/sendbulk` (multipart)

**Perpesanan MCP**

`post_whatsapp_message_send` `get_whatsapp_template_list` `post_whatsapp_template_send`

OTP

Sistem Anda menghasilkan kode; agen mengirimkannya dalam templat autentikasi SMS atau WhatsApp. API publik tidak memiliki endpoint verifikasi terpisah, sehingga pengecekan kode tetap dilakukan di sistem Anda.

**REST API**

`POST /sms/sendSms` dengan kode di dalam pesan

**Perpesanan MCP**

Alat templat SMS dan WhatsApp yang sama

Voice

Suara OTP, panggilan text-to-speech, dan IVR disediakan melalui tim akun Anda. Spesifikasi OpenAPI publik dan alat MCP mencakup saluran perpesanan, bukan panggilan suara. Untuk panggilan keluar berbasis AI, lihat DialerBee.

**REST API**

Disediakan per akun

**Perpesanan MCP**

Tidak ada fitur suara

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

Pengguna

Kami ingin mengirim sekitar 50.000 kode login per bulan ke pelanggan di UEA. Apa yang kami butuhkan, dan berapa biayanya?

1. 1 Panggilan alat `check_coverage` Apakah UEA dicakup, pada operator mana? → `{"country":"UAE"}` Hasil (dipangkas) `{ "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 Panggilan alat `sender_id_rules` Apa yang dibutuhkan sender ID di sana? → `{"country":"ae"}` Hasil (dipangkas) `{ "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 Panggilan alat `count_sms_segments` Berapa segmen pesan tersebut? → `{"text":"Your MyShop code is 482913. It expires in 5 minutes. Never share it."}` Hasil (dipangkas) `{ "encoding": "GSM-7", "units": 68, "segments": 1 }`
4. 4 Panggilan alat `estimate_price` Berapa perkiraan harganya? → `{"country":"UAE","channel":"sms","volume":50000}` Hasil (dipangkas) `{ "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." }`

Agen

UEA terjangkau melalui koneksi langsung ke operator (Etisalat / e& · du). Sender ID Anda memerlukan registrasi sebelumnya dengan TDRA, biasanya dalam 5–7 hari kerja. Pesan kode Anda adalah segmen 1 SMS. Dengan tarif daftar indikatif sebesar US$0,0123 per segmen, 50.000 kode mencapai sekitar US$615 per bulan, tidak termasuk pajak dan biaya sender ID. Ini bukan penawaran harga.

Langkah selanjutnya: minta akses uji coba di broadnet.me/signup. Setelah Anda memiliki token, saya dapat mengirimkan satu kode uji coba ke nomor terverifikasi Anda sendiri melalui server perpesanan. Haruskah saya menyiapkan pesan tersebut untuk Anda konfirmasi?

Dibangun dari output alat live pada setiap deployment

## Salin dan tempel

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

mcp.json — kedua server

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

Nama field sedikit bervariasi antar klien (beberapa mengharapkan "streamable-http" sebagai tipe, beberapa membaca header dari pengaturan terpisah). Tambahkan entri pengetahuan saja jika Anda belum memiliki token.

tools/call estimate_price (server pengetahuan)

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

kirim satu SMS (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 mengembalikan ID pesan. API tidak memiliki header idempotensi: setelah terjadi kesalahan jaringan atau 5xx, periksa status pesan berdasarkan ID-nya sebelum mengirim kembali.

pengiriman yang sama dengan TypeScript SDK

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

kirim templat WhatsApp yang telah disetujui (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.
```

Templat bekerja di luar jendela layanan 24 jam; teks bebas memerlukan jendela terbuka.

## 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.](https://www.broadnet.me/llms.txt)
- [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.](https://www.broadnet.me/.well-known/agent-skills/index.json)
- [Kartu agen A2A `/.well-known/agent-card.json` Kartu Agent2Agent untuk alat pengetahuan read-only yang sama, disajikan melalui JSON-RPC pada /a2a.](https://www.broadnet.me/.well-known/agent-card.json)
- [Katalog API `/.well-known/api-catalog` Kumpulan tautan RFC 9727 yang mengarah ke spesifikasi OpenAPI, dokumentasi API, kedua server MCP, dan halaman status.](https://www.broadnet.me/.well-known/api-catalog)
- [Kartu server MCP `/.well-known/mcp.json` Kartu server yang menjelaskan kedua server MCP, transport, dan autentikasinya.](https://www.broadnet.me/.well-known/mcp.json)
- [OpenAPI 3.1 `/developers/openapi.yaml` Deskripsi lengkap REST API: unduh, atau buat klien bertipe dari deskripsi ini.](https://www.broadnet.me/developers/openapi.yaml)
- [Versi Markdown `/pricing/sms/uae.md` Tambahkan .md pada sebagian besar URL halaman, atau kirim Accept: text/markdown, untuk salinan Markdown halaman yang bersih.](https://www.broadnet.me/pricing/sms/uae.md)
- [Berkas data `/data/coverage.json` Cakupan, harga yang dipublikasikan, dan regulasi untuk setiap pasar sebagai JSON (CSV untuk cakupan dan harga).](https://www.broadnet.me/data/coverage.json)
- [Status JSON `/status/api/v2/summary.json` Keterjangkauan situs web, gateway API, dan kedua endpoint MCP yang terukur, dalam format ringkasan Statuspage v2.](https://www.broadnet.me/status/api/v2/summary.json)

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

[Server MCP Detail kedua server: endpoint, autentikasi, pengaturan klien, dan demo.](https://www.broadnet.me/id/developers/mcp) [Mulai Cepat Dari akses uji coba hingga SMS pertama dengan curl atau TypeScript SDK.](https://www.broadnet.me/id/developers/quickstart) [Referensi API Endpoint pengiriman setiap saluran, Bearer auth, dan format kesalahan.](https://www.broadnet.me/developers/api) [Percobaan ulang yang aman Cara mencoba kembali tanpa mengirim pesan dua kali.](https://www.broadnet.me/developers/idempotency) [Penghitung segmen SMS Pengodean dan jumlah segmen untuk teks pesan apa pun.](https://www.broadnet.me/developers/sms-counter) [BroadNet Inference Model speech-to-text dan vision bahasa Arab untuk agen suara dan dokumen.](https://www.broadnet.me/id/products/inference) [DialerBee Dialer outbound AI multibahasa untuk contact centre.](https://www.broadnet.me/id/dialerbee) [Apa itu SMS pumping? Cara kerja penipuan OTP dan pertahanan yang menghentikannya.](https://www.broadnet.me/id/answers/what-is-sms-pumping)

## Pertanyaan

### Dapatkah agen AI mengirim pesan SMS dan WhatsApp melalui BroadNet?

Ya. Hubungkan ke server perpesanan MCP di https://mcp.broadnet.me/mcp dengan token BroadNet Anda, atau gunakan kode Anda untuk memanggil REST API di https://api.broadnet.me. Apa pun caranya, agen akan bertindak dengan izin token Anda, jadi wajibkan konfirmasi manusia untuk setiap pengiriman.

### Apakah agen memerlukan akun untuk menanyakan cakupan atau harga?

Tidak. Server pengetahuan MCP di https://www.broadnet.me/mcp bersifat publik dan hanya dapat dibaca. Server ini mengembalikan data cakupan, aturan sender ID, daftar harga indikatif, dan regulasi dari data yang sama dengan situs web. Harga yang tertera adalah tarif daftar indikatif, bukan penawaran harga.

### Bagaimana agen mengirimkan kode OTP?

Sistem Anda menghasilkan kode dan agen mengirimkannya dalam SMS dengan POST /sms/sendSms, atau dalam templat autentikasi WhatsApp. API publik tidak memiliki endpoint verifikasi terpisah, sehingga pengecekan kode tetap dilakukan di sistem Anda.

### Dapatkah agen melakukan panggilan suara?

Voice OTP, panggilan text-to-speech, dan IVR disediakan melalui tim akun BroadNet Anda. Fitur ini tidak tersedia dalam spesifikasi OpenAPI publik atau alat MCP. DialerBee adalah dialer outbound AI milik BroadNet untuk contact centre.

### Bagaimana cara mendapatkan token?

Minta akses uji coba di /signup. BroadNet membalas dalam satu hari kerja dengan kredensial uji coba. Tidak tersedia kunci mandiri instan.

## Hubungkan agen Anda ke BroadNet

Mulai dengan server pengetahuan publik hari ini. Minta akses uji coba saat agen Anda siap untuk mengirim.

[Minta akses uji coba (formulir berbahasa Inggris)](https://www.broadnet.me/id/contact?intent=test-access) [Panduan server MCP](https://www.broadnet.me/id/developers/mcp)