Satu API messaging untuk delapan kanal
Kirim SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email, dan push dari kode Anda sendiri dengan satu base URL dan satu Bearer token. Lacak setiap pesan lewat webhook, skalakan SMS melalui SMPP, dan biarkan agen AI memakai API yang sama melalui MCP.
curl -X POST https://api.broadnet.me/sms/sendSms \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"senderId": "OmniDemo",
"destinationNumber": "447700900123",
"message": "Your code is 482913",
"messageType": "TEXT"
}'
# 200 OK
2603121407537573731Contoh request nyata: POST /sms/sendSms mengembalikan ID pesan dalam bentuk teks biasa. Ganti token, Sender ID, dan nomor dengan milik Anda.
Jawaban singkat
Diperbarui
OmniChannels.ai menyediakan satu REST API untuk SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email, dan push bagi developer. API ini memiliki sekitar 225 path terdokumentasi dalam spesifikasi OpenAPI 3.1, SDK TypeScript, webhook status pengiriman, SMPP v3.4 melalui TLS, dan MCP server untuk agen AI. Akses uji coba hanya mengirim ke nomor Anda sendiri yang sudah terverifikasi, engineer kami mendampingi integrasi Anda, dan reseller dapat memakai API yang sama dengan merek sendiri.
Yang Anda dapatkan sebagai developer
Satu integrasi mencakup semua kanal yang dipakai pelanggan Anda, dengan perangkat yang diharapkan tim produksi.
Satu REST API, delapan kanal
SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email, dan push memakai satu base URL, satu Bearer token, dan satu format error. Menambah kanal cukup dengan endpoint baru, bukan vendor baru.
OpenAPI 3.1 dan SDK TypeScript
Sekitar 225 path terdokumentasi dalam spesifikasi OpenAPI 3.1 yang dapat Anda impor ke Postman atau dipakai untuk membuat client, ditambah paket resmi @broadnet/cpaas-sdk untuk TypeScript dan Node.js.
Webhook status pengiriman
Status dinormalisasi di semua kanal (SUBMITTED, SENT, DELIVERED, READ, FAILED, dan REJECTED) dan dikirim ke endpoint HTTPS Anda, dengan endpoint polling dan re-push sebagai jaring pengaman.
SMPP v3.4 untuk SMS volume tinggi
Bind transceiver melalui TLS dengan IP allow-list, disiapkan untuk akun Anda, pada jalur langsung ke operator yang sama dengan REST API.
MCP server untuk agen AI
Hubungkan Claude, Cursor, atau MCP client apa pun ke API dengan token Anda, sehingga agen dapat mengirim pesan dan membaca laporan pengiriman di bawah pengaturan batasan dari Anda.
Uji coba sebelum go-live
Kredensial uji coba hanya mengirim ke nomor Anda sendiri yang sudah terverifikasi, pada base URL yang sama dengan produksi, sehingga kode Anda tidak berubah saat peralihan.
Dukungan dari engineer
Seorang messaging engineer meninjau kasus penggunaan Anda, membantu desain REST atau SMPP, Sender ID, dan aturan tiap negara, serta mendampingi Anda hingga go-live.
Dibuat untuk reseller
Reseller memakai API yang sama dengan merek sendiri, dengan sub-akun yang masing-masing memiliki kredit, Sender ID, pengguna, dan webhook sendiri, ditambah reseller API untuk manajemen akun.
Ringkasan fitur untuk developer
Apa yang tersedia saat ini, dan apa yang disiapkan bersama tim kami.
| Item | Status | Detail |
|---|---|---|
| REST API (SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email, push) | Tersedia | Base URL https://api.broadnet.me dengan autentikasi Bearer token. Akses uji coba diberikan setelah permintaan singkat. |
| Webhook status pengiriman | Tersedia | Dikonfigurasi per akun atau sub-akun. Status dinormalisasi di semua kanal. |
| SDK TypeScript | Tersedia | npm install @broadnet/cpaas-sdk axios. Bahasa lain memanggil REST API secara langsung atau membuat client dari spesifikasi. |
| Spesifikasi OpenAPI 3.1 | Tersedia | Tersedia publik di https://omnichannels.ai/developers/openapi.json (YAML di /developers/openapi.yaml): setiap operasi yang dapat dipanggil token pelanggan, untuk Postman, Insomnia, pembuatan client, dan alat coding AI. |
| MCP server | Tersedia | https://mcp.broadnet.me/mcp melalui Streamable HTTP, diautentikasi dengan token Anda. |
| SMPP v3.4 melalui TLS | Sesuai permintaan | Bind, throughput, dan IP allowlist disiapkan untuk akun Anda oleh tim kami. |
| Voice (OTP, IVR, panggilan keluar, agen suara AI) | Sesuai permintaan | Disiapkan bersama tim akun; tidak ada endpoint voice publik di REST API. |
Dari request pertama hingga produksi
Tidak ada pendaftaran mandiri instan. Akses diawali dengan permintaan singkat agar akun disiapkan sesuai kanal dan negara Anda.
- 1
Minta akses uji coba
Sampaikan kanal, negara tujuan, volume, dan kasus penggunaan Anda. Seorang engineer meninjau permintaan dan menerbitkan kredensial uji coba.
- 2
Kirim pesan uji pertama
Ikuti quickstart untuk mengirim SMS ke nomor Anda sendiri yang sudah terverifikasi dan menerima status pengirimannya di webhook Anda.
- 3
Bangun integrasi
Tambahkan kanal yang Anda butuhkan, tangani error dan retry, serta catat ID pesan. Engineer kami dapat meninjau desain Anda untuk REST atau SMPP.
- 4
Dapatkan persetujuan sender
Sender ID, akun WhatsApp Business, dan agen RCS didaftarkan paralel dengan pengembangan Anda, mengikuti aturan tiap negara dan platform.
- 5
Go live
Jalur produksi diaktifkan untuk akun Anda. Kode Anda tetap memanggil base URL yang sama, sehingga tidak ada yang berubah saat peralihan.
Apakah API ini cocok untuk tim Anda?
Cocok jika
- Anda menginginkan satu integrasi untuk SMS, WhatsApp, RCS, pesan sosial, email, dan push, bukan beberapa vendor.
- Anda membutuhkan status pengiriman per pesan di sistem Anda sendiri, bukan hanya di dashboard.
- Anda mengirim SMS dalam volume tinggi dan ingin SMPP di samping REST.
- Anda menjual ulang layanan messaging dan membutuhkan API yang sama dengan merek Anda, lengkap dengan sub-akun.
- Anda membangun agen AI yang perlu mengirim dan melacak pesan melalui MCP.
Hal yang perlu diketahui sebelum memulai
- Tidak ada pendaftaran mandiri instan; akses uji coba diberikan setelah permintaan singkat.
- SDK resmi hanya tersedia untuk TypeScript; bahasa lain memakai HTTP biasa atau client yang dibuat dari spesifikasi.
- API tidak menerima idempotency key, sehingga integrasi Anda perlu mencatat setiap pengiriman sebelum melakukan retry.
- Voice dan SMPP disiapkan bersama tim kami, bukan melalui endpoint publik.
- Pengiriman WhatsApp, Messenger, dan Instagram mengikuti aturan Meta, termasuk template yang disetujui dan jendela pesan.
Documentation
Everything you need to integrate, from your first API call to SMPP binds and AI agents. The documentation is in English.
- Get startedQuickstart: send your first messageGet test credentials, send your first SMS with cURL, Node.js, Python or PHP, receive the delivery status, and check what to do before going live.
- Get startedAuthenticationHow to authenticate API requests with a Bearer token, store and rotate it safely, read a 401 response, and connect Facebook Pages and Instagram via OAuth.
- Messaging channelsSMS APISend single and bulk SMS, choose TEXT or UNICODE encoding, count segments, schedule, control bulk jobs and look up numbers before you send.
- Messaging channelsWhatsApp Business APISend WhatsApp templates, text, media and interactive messages through one multipart endpoint, manage templates and batches, and track every recipient.
- Messaging channelsRCS Business Messaging APISend RCS text, media, rich cards, carousels and suggested replies, check device capability first, and plan SMS fallback for users without RCS.
- Messaging channelsFacebook Messenger APIConnect a Facebook Page with OAuth, then send Messenger text, media, button and carousel templates and quick replies within Meta's messaging windows.
- Messaging channelsInstagram Messaging APIConnect an Instagram professional account with OAuth and reply to Instagram DMs by API: text, media, quick replies, generic templates and reactions.
- Messaging channelsTelegram APISend Telegram text, photos, documents, video, location and contact messages from your connected sender, use saved templates, and smoke-test in a sandbox.
- Messaging channelsEmail APISend transactional and bulk email through your SMTP sender with HTML, templates, attachments, CC and scheduling, plus domain checks and a sandbox send.
- Messaging channelsPush Notifications APISend push notifications to your app's users by user reference, device token, topic or segment, with images, deep links, actions, templates and dry runs.
- Messaging channelsVoice: OTP, IVR, calls and AI agentsWhat voice can do on OmniChannels.ai, from voice OTP and IVR to AI voice agents and SMS-to-voice fallback, and how our team provisions it for your account.
- Events and errorsWebhooks and delivery statusesReceive delivery statuses and inbound messages on your HTTPS endpoint, respond fast, deduplicate events, and poll or re-trigger statuses when needed.
- Events and errorsErrors, retries and rate limitsHTTP status codes and error bodies, which errors to retry with backoff and jitter, default rate limits, pagination, and how to avoid duplicate sends.
- ConnectivitySMPP v3.4 connectivityWhen to use SMPP instead of REST, how binds are provisioned over TLS, submit_sm essentials, encoding, concatenation, delivery receipts and error codes.
- ToolsMCP server for AI agentsConnect Claude, Cursor, VS Code and other MCP clients to the messaging API so AI agents can send and track messages safely with your token.
- ToolsSDKs, OpenAPI spec and code samplesUse the TypeScript SDK, import the OpenAPI 3.1 spec into Postman or Insomnia, generate clients, and call the API from Java, .NET, Go and Ruby.
- ToolsOpenAPI 3.1 specDownload the public OpenAPI 3.1 spec of the messaging API, import it into Postman or Insomnia, generate clients and types, and give it to AI coding tools.
- ToolsUse the MCP server with Claude CodeAdd the OmniChannels.ai MCP server to Claude Code with claude mcp add, share it in .mcp.json, keep the token in an environment variable and gate send tools.
- ToolsUse the MCP server with CursorConnect Cursor to the OmniChannels.ai MCP server with .cursor/mcp.json, read the token from an environment variable, toggle tools and send a first message.
- ToolsUse the MCP server with n8nGive an n8n AI Agent the OmniChannels.ai messaging tools with the MCP Client Tool node, or call the REST API and receive delivery statuses with plain n8n nodes.
- ToolsMake and Zapier with webhooksSend messages from Make scenarios and Zaps with an HTTP request to the REST API, and get delivery statuses and inbound messages via a Make or Zapier webhook.
Bagaimana API masuk ke stack Anda
Sistem Anda memanggil satu REST API dengan satu bearer token. BroadNet merutekan setiap pesan lewat kanal dan operator yang tepat, lalu mengirim status pengiriman kembali ke webhook Anda.
Aplikasi, CRM, atau agen AI Anda
- Bearer token, satu base URL
- SMPP 3.4 melalui TLS untuk volume tinggi
- Server MCP untuk agen AI
API pesan BroadNet
API pesan BroadNethttps://api.broadnet.mePonsel pelanggan Anda
Status pengiriman ke webhook Anda
SENTDELIVEREDREADFAILED
Pertanyaan developer
Bagaimana cara autentikasi?
Kirim access token akun Anda di header Authorization: Bearer pada setiap request. Token diterbitkan per akun; tidak ada endpoint yang menukar username dan password dengan token. Token yang hilang atau tidak valid mengembalikan 401. Simpan token di server Anda, jangan di kode browser atau aplikasi mobile.
Apa base URL-nya, dan apakah ada sandbox terpisah?
Setiap panggilan menuju https://api.broadnet.me, tanpa prefiks versi. Uji coba dan produksi memakai base URL yang sama: kredensial uji coba hanya mengirim ke nomor Anda sendiri yang sudah terverifikasi, dan produksi diaktifkan untuk akun Anda setelah sender disetujui, sehingga kode Anda tidak berubah.
Bagaimana cara mendapatkan delivery receipt?
Status dikirim ke URL webhook yang dikonfigurasi di akun Anda: SUBMITTED, SENT, DELIVERED, READ pada kanal yang melaporkan status baca, FAILED, dan REJECTED. Anda juga dapat melakukan polling, misalnya GET /sms/list untuk job SMS blast dan GET /whatsapp/message/bulk-insights untuk batch WhatsApp.
Bagaimana menangani retry dan duplikat?
Lakukan retry hanya untuk error jaringan, respons 429 dan 5xx, dengan exponential backoff dan jitter, dan jangan pernah mengulang error 4xx tanpa perubahan. API tidak menerima idempotency key, jadi catat setiap pengiriman sebelum Anda melakukannya, simpan ID pesan yang dikembalikan, dan periksa statusnya setelah timeout sebelum mengirim ulang.
Berapa rate limit-nya?
Default yang terdokumentasi adalah 200 request per detik untuk REST dengan burst hingga 500 selama maksimal 60 detik, 1.000 pesan per detik per bind SMPP, dan 50 request per detik untuk number lookup. Batas untuk akun Anda dikonfirmasi bersama kredensial Anda. Request yang melebihi batas mengembalikan 429 dengan header Retry-After.
Bahasa pemrograman apa yang didukung?
Bahasa apa pun yang dapat membuat request HTTPS. Tersedia SDK TypeScript resmi, @broadnet/cpaas-sdk, dan dokumentasi menyertakan contoh HTTP biasa untuk cURL, Node.js, Python, PHP, Java, .NET, Go, dan Ruby. Anda juga dapat membuat client dari spesifikasi OpenAPI 3.1 publik di /developers/openapi.json.
Sebaiknya pakai REST atau SMPP untuk SMS?
REST cocok untuk sebagian besar aplikasi dan memberi Anda semua kanal lewat satu API. SMPP v3.4 melalui TLS cocok untuk SMS volume tinggi yang berkelanjutan, terutama jika Anda sudah menjalankan SMPP client. Bind, throughput, dan IP allowlist disiapkan untuk akun Anda, dan Anda dapat memakai keduanya pada satu akun.
Bisakah saya menjual ulang layanan messaging lewat API?
Bisa. Reseller memakai API yang sama dengan merek sendiri. Setiap sub-akun memiliki kredit, Sender ID, pengguna, dan webhook sendiri, dan reseller API mencakup pembuatan akun, top-up kredit, daftar harga, dan pelaporan. Sebutkan rencana reseller saat meminta akses agar kami menyiapkan strukturnya bersama Anda.
Panduan tentang topik ini
- IntegrasiPanduan Integrasi API Messaging: REST, SMPP, dan Webhook9 menit baca
- PemasaranSent, Delivered, Read, Failed: Arti Status Pesan Dijelaskan8 menit baca
- IntegrasiCara Menghubungkan CRM ke Omnichannel Inbox dengan Webhook8 menit baca
- SMS & OTPOTP di WhatsApp dan SMS: Keamanan, Pengiriman, dan Fraud9 menit baca
- WhatsAppKode Error WhatsApp Cloud API: Arti dan Cara Mengatasinya8 menit baca
- SMS & OTPApa Itu SMS A2P? Cara Pesan Bisnis Sampai ke Handset8 menit baca
Jelajahi lebih banyak platform
Minta akses uji coba
Sampaikan kanal, negara, dan volume Anda. Seorang engineer akan menyiapkan kredensial uji coba untuk nomor Anda yang sudah terverifikasi dan membantu merencanakan peralihan ke produksi.
Bagikan stack Anda dan apa yang ingin Anda hubungkan. Seorang solutions engineer akan menindaklanjuti.