Kirim SMS uji coba pertama Anda lima menit setelah Anda mendapatkan kredensial.
Minta akses uji coba dan kami akan membalas dalam satu hari kerja dengan kredensial uji coba Anda. Kemudian ambil tokennya, instal TypeScript SDK dan panggil smsSendsmsPost. Pesan uji coba pertama Anda akan mencapai nomor terverifikasi Anda sendiri sekitar lima menit setelah Anda menerima kredensial. Setiap sampel di bawah ini siap untuk disalin, dan langkah 5 mencakup apa yang perlu diperiksa sebelum produksi.
Satu jalur menuju pesan pertama Anda, dengan estimasi waktu di setiap langkah.
- 01
Minta akses uji coba
Kami membalas dalam 1 hari kerjaSeorang engineer perpesanan akan membalas dengan kredensial uji coba Anda dan menjadwalkan panggilan selama 30 menit untuk membahas negara, volume, dan kasus penggunaan Anda.
- 02
Pesan uji coba pertama
Sekitar 5 menit setelah kredensial diterimaKirim pesan uji coba ke nomor terverifikasi Anda sendiri menggunakan kode quickstart. Laporan pengiriman akan dikirim kembali ke webhook Anda.
- 03
Integrasi
2–5 hari kerjaBangun dan uji dengan kredensial pengujian Anda pada endpoint yang sama dengan sampel kode. Seorang engineer BroadNet akan mendampingi Anda di REST atau SMPP.
- 04
Persetujuan
3–10 hari kerjaIdentitas pengirim, tujuan trafik, dan aturan tujuan akan ditinjau, serta sender ID akan didaftarkan ke setiap regulator, secara paralel dengan integrasi Anda.
- 05
Produksi
Hari peralihanAkses produksi dan rute telah diaktifkan untuk akun Anda. Integrasi Anda sudah memanggil https://api.broadnet.me.
Total: 5–15 hari kerja dari permintaan hingga produksi untuk sebagian besar pasar; lebih lama jika waktu tunggu registrasi sender ID oleh regulator lebih lama.
- Aplikasi AndaMengirim melalui REST API atau SMPP
- Platform BroadNetMemvalidasi, merutekan, dan menagih setiap pesan
- SMSC milik operatorKoneksi langsung ke operator
- Perangkat pelangganPesan terkirim
Dapatkan token akses Anda.
Token akses Anda menyertakan kredensial uji coba: minta akses uji coba dan kami akan membalas dalam satu hari kerja. Simpan token tersebut dalam variabel lingkungan BROADNET_TOKEN dan kirimkan dalam header Authorization: Bearer pada setiap panggilan. Setiap sampel di halaman ini menggunakan URL dasar produksi, https://api.broadnet.me.
Kirim SMS uji coba ke nomor terverifikasi Anda sendiri dengan POST /sms/sendSms. Respon 200 OK dengan isi berupa ID pesan mengonfirmasi bahwa token berfungsi sebelum Anda menulis kode lainnya.
Instal SDK.
BroadNet memiliki satu SDK resmi, untuk TypeScript dan Node.js: npm install @broadnet/cpaas-sdk axios. Ini dihasilkan dari spesifikasi OpenAPI BroadNet. Dalam bahasa lain, panggil API REST dengan pustaka HTTP Anda yang biasa, atau buat klien dari spesifikasi OpenAPI.
npm install @broadnet/cpaas-sdk axios
export BROADNET_TOKEN=your_access_tokenImpor Configuration dan SMSSMSApi dari @broadnet/cpaas-sdk. Jika impor berhasil dan lolos pemeriksaan tipe, Anda siap untuk mengirim.
Kirim pesan pertama Anda.
Buat SMSSMSApi dengan base URL dan token Anda, panggil smsSendsmsPost dengan senderId, destinationNumber, message, dan messageType, lalu catat hasilnya. Body respons adalah ID pesan; simpan ID tersebut untuk mencocokkan status pengiriman nanti.
// 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 IDHTTP/1.1 200 OK
2603121407537573731Periksa ponsel di tangan Anda. Jika Anda telah menerima SMS, bagian tersulit telah selesai — semua yang di bawah ini hanyalah penyempurnaan operasional.
Terima status pengiriman.
BroadNet mengirimkan status pengiriman ke URL webhook yang dikonfigurasi pada akun Anda: SUBMITTED, SENT, DELIVERED, READ pada saluran yang melaporkan status baca, atau FAILED dan REJECTED. Simpan setiap pembaruan, balas dengan 2xx secara cepat, dan proses secara asinkron.
import express from "express";
const app = express();
app.post("/webhooks/broadnet", express.json(), async (req, res) => {
// Store the status update first, then acknowledge with a 2xx.
// Statuses: SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED.
await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body });
res.sendStatus(200);
});Terkonfirmasi di perangkat genggam. Pembaruan sebelumnya, SUBMITTED dan SENT, muncul saat pesan bergerak melalui jaringan.
Dibuka oleh penerima, pada saluran yang melaporkan status baca, seperti WhatsApp.
Tidak terkirim. Periksa format nomor dan sender ID Anda sebelum mengirim kembali.
Kirim pesan ke ponsel Anda, lalu periksa log server Anda untuk pembaruan status DELIVERED.
Sebelum produksi.
Produksi dibuka setelah persetujuan selesai: identitas pengirim, tujuan trafik, dan sender ID, memakan waktu 3–10 hari kerja, secara paralel dengan integrasi Anda. Setelah disetujui, kode yang sama akan mengirimkan trafik produksi. Sebelum itu, pastikan token tidak tersimpan dalam source control, siapkan webhook status pengiriman, dan tentukan kebijakan retry Anda.
- 01Pindahkan rahasia ke lingkungan Anda
Simpan BROADNET_TOKEN dalam variabel lingkungan atau pengelola rahasia Anda, jangan pernah di kontrol sumber atau kode sisi klien. Ganti segera jika terjadi kebocoran.
- 02Coba lagi dengan aman dan pantau saldo Anda
Coba kembali kesalahan jaringan dan respons 5xx dengan exponential backoff. Setiap pengiriman yang diterima mengembalikan ID pesan, jadi simpanlah dan periksa status pengiriman daripada mengirim ulang secara membabi buta. SMS massal melaporkan sisa kredit Anda dalam setiap respons.
- 03Sematkan versi SDK
Pin @broadnet/cpaas-sdk ke versi yang tepat di package.json dan lakukan upgrade secara sengaja. Jalur API tidak membawa awalan versi, jadi ikuti perubahan dalam changelog dan spesifikasi OpenAPI.
- 04Tangani kesalahan berdasarkan kode status
Kesalahan akan mengembalikan kode status HTTP dan badan ExceptionResponse yang berisi status, error, message, errorCode, dan requestUri. Perbaiki kesalahan 400 dan 401; coba lagi kesalahan 5xx dengan metode backoff.
- 05Tentukan kebijakan pengulangan Anda
Default: exponential backoff pada kesalahan 5xx dan jaringan, tidak pernah pada 4xx. Setelah timeout, periksa status pengiriman sebelum Anda mengirim ulang, karena permintaan pertama mungkin sudah diterima.
Jalankan daftar periksa di bawah ini pada kode Anda. Jika semua kotak telah dicentang, integrasi Anda siap untuk produksi segera setelah persetujuan selesai.
Jalur kode yang sama menangani lebih dari 300 juta pesan per hari.
Trafik uji coba Anda bukanlah simulasi. Setiap permintaan, kunci, dan webhook yang Anda hubungkan pada langkah-langkah di atas berjalan melalui tumpukan perutean, penagihan, dan kepatuhan yang sama dengan yang mengalirkan trafik perusahaan kami — diaudit setiap tahun berdasarkan sertifikasi di bawah ini.
Pertanyaan panduan cepat
Kirim POST https://api.broadnet.me/sms/sendSms dengan header Authorization: Bearer dan body JSON berisi senderId, destinationNumber, message, dan messageType (TEXT atau UNICODE). Responsnya adalah ID pesan. API HTTP lama di bawah /websmpp masih tersedia untuk integrasi era SMPP.
Minta akses uji coba di /signup, dan teknisi BroadNet kami akan membalas dalam satu hari kerja dengan kredensial uji coba Anda: token akses yang Anda kirimkan dalam header Authorization: Bearer, serta instruksi ke mana harus mengirim trafik uji coba. Pesan uji coba pertama Anda dapat dikirimkan sekitar lima menit setelah Anda menerimanya.
Hanya satu SDK resmi: @broadnet/cpaas-sdk untuk TypeScript dan Node.js, di npm. Dalam bahasa lain, panggil REST API secara langsung melalui HTTPS, atau buat klien dari spesifikasi OpenAPI (/developers/openapi.yaml).
Pertanyaan tidak ada di sini? Tanyakan kepada tim engineering kami
Lima langkah tersisa.
Satu kunci lagi.
Uji coba pada nomor terverifikasi Anda sendiri, luncurkan integrasi, lalu tingkatkan ke trafik live dari konsol yang sama. SDK yang sama, endpoint yang sama, dan SLA yang sama yang menangani lebih dari 300 juta pesan setiap hari.