API SMS, API SMPP, API Penjadwal MS
Panduan Pengguna
API SMS, API SMPP, API Penjadwal MS
| Dimodifikasi: | 6/24/2025 |
| Versi: | 1.7 |
| Pengarang: | Kenny Colander Norden, KCN |
Dokumen ini ditujukan hanya untuk penerima yang ditunjuk dan mungkin berisi informasi istimewa, kepemilikan, atau informasi pribadi. Jika Anda menerimanya karena kesalahan, harap segera beri tahu pengirimnya dan hapus yang asli. Penggunaan lain atas dokumen tersebut oleh Anda dilarang.
Riwayat perubahan
| Putaran | Tanggal | By | Perubahan dari rilis sebelumnya |
| 1.0 | Telepon: 2010-03-16 | KCN | Dibuat |
| 1. | Telepon: 2019-06-11 | Bahan Plastik | Logo LINK yang diperbarui |
| 1. | Telepon: 2019-09-27 | PNI | Menambahkan referensi ke spesifikasi SMPP 3.4 |
| 1. | Telepon: 2019-10-31 | EP | Pengamatan tentang masa berlaku tag |
| 1. | Telepon: 2020-08-28 | KCN | Menambahkan informasi mengenai versi TLS yang didukung |
| 2. | Telepon: 2022-01-10 | KCN | Menambahkan informasi tambahan mengenai laporan pengiriman Informasi terbaru mengenai TLS 1.3 |
| 2. | Telepon: 2025-06-03 | GM | Menambahkan kode hasil 2108 |
| 2. | Telepon: 2025-06-24 | AK | Kuota tambahan |
Perkenalan
LINK Mobility telah menjadi distributor SMS sejak tahun 2001 dan memiliki banyak pengalaman bekerja dengan operator dan agregator koneksi. Platform ini dirancang untuk menangani volume lalu lintas yang besar, menjaga ketersediaan tinggi, dan memudahkan perutean lalu lintas melalui banyak koneksi.
Dokumen ini menjelaskan antarmuka SMPP ke platform SMSC dan parameter serta perintah apa saja yang diperlukan dan parameter apa saja yang didukung.
Dokumen ini tidak akan menangani kasus penggunaan khusus seperti pesan gabungan, WAPpush, Flash SMS, dll. Informasi lebih lanjut tentang kasus tersebut dapat diberikan dengan menghubungi dukungan.
Perintah yang didukung
Server LINK Mobility harus diperlakukan sebagai SMPP 3.4. Spesifikasi resminya dapat dilihat di https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Semua metode tidak didukung, dan semua perbedaan dijelaskan di bawah.
4.1 Mengikat
Perintah pengikatan berikut didukung.
- Pemancar
- Transceiver
- Penerima
Parameter yang dibutuhkan:
- system_id – diperoleh dari dukungan
- kata sandi – diperoleh dari dukungan
Parameter opsional:
- addr_ton – nilai default jika TON diatur ke Tidak Diketahui saat pengiriman.
- addr_npi – nilai default jika NPI diatur ke Tidak Diketahui saat pengiriman.
Parameter yang tidak didukung:
- alamat_rentang
4.2 Lepas ikatan
Perintah unbind didukung.
4.3 Tanyakan tautan
Perintah tanya tautan didukung dan harus dipanggil setiap 60 detik.
4.4 Kirim
Metode kirim harus digunakan untuk menyampaikan pesan.
Parameter yang dibutuhkan:
- sumber_addr_ton
- sumber_addr_npi
- sumber_alamat
- tujuan_addr_ton
- dest_addr_npi
- tujuan_addr
- esm_kelas
- pengkodean_data
- sm_panjang
- pesan_pendek
Parameter yang tidak didukung:
- tipe_layanan
- protokol_id
- prioritas_bendera
- jadwal_waktu_pengiriman
- replace_if_present_flag
- sm_default_msg_id
Catatan bahwa muatannya tag tidak didukung dan hanya satu SMS yang dapat dikirimkan per panggilan dan disarankan agar validitas_periode tag memiliki nilai durasi setidaknya 15 menit.
4.4.1 Rekomendasi TON dan NPI
TON dan NPI berikut harus digunakan saat mengirim pesan menggunakan perintah kirim.
4.4.1.1 Sumber
Kombinasi TON dan NPI berikut didukung untuk alamat sumber. Semua kombinasi lainnya akan dianggap tidak valid. Perintah TON default dari bind akan digunakan jika TON diatur ke Tidak Diketahui (0). Perintah NPI default dari bind akan digunakan jika NPI diatur ke Tidak Diketahui (0).
| TON | NPI | Keterangan |
| Alfanumerik (5) | Tidak diketahui (0) ISDN (1) |
Akan diperlakukan sebagai teks pengirim alfanumerik |
| Internasional (1) | Tidak diketahui (0) ISDN (1) |
Akan diperlakukan sebagai MSISDN |
| Nasional (2) Jaringan spesifik (3) Nomor pelanggan (4) Disingkat (6) |
Tidak diketahui (0) ISDN (1) Nasional (8) |
Akan diperlakukan sebagai nomor pendek khusus negara. |
4.4.1.2 Tujuan
Kombinasi TON dan NPI berikut didukung untuk alamat tujuan. Semua kombinasi lainnya akan dianggap tidak valid. Perintah TON default dari bind akan digunakan jika TON diatur ke Tidak Diketahui (0). NPI default dari perintah bind akan digunakan jika NPI diatur ke Tidak Diketahui (0).
| TON | NPI | Keterangan |
| Internasional (1) | Tidak diketahui (0) ISDN (1) |
Akan diperlakukan sebagai MSISDN |
4.4.2 Pengkodean yang didukung
Pengkodean berikut ini didukung. X dapat berisi nilai apa pun.
| DCS | Pengkodean |
| 0xX0 | Alfabet GSM default dengan ekstensi |
| 0xX2 | biner 8-bit |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kuota
5.1 Kuota Berlebihview
Kuota menentukan jumlah maksimum pesan SMS yang dapat dikirim dalam interval waktu tertentu (misalnya per hari, minggu, bulan, atau tanpa batas waktu). Setiap kuota diidentifikasi secara unik oleh sebuah ID kuota (UUID) dan diatur ulang sesuai zona waktu pelanggan. Kuota dapat ditetapkan di tingkat negara, wilayah, atau standar melalui Kuota Pro.fileKuota juga dapat ditetapkan secara dinamis menggunakan Pemetaan Kuota. Pemetaan ini memetakan ID Kuota induk (UUID) dan Kunci kuota unik (misalnya, pengirim atau pengguna) ke ID kuota tertentu.
Kuota ditetapkan sesuai dengan dukungan lokal Anda, manajer akun yang ditugaskan, atau secara default jika tidak ada yang ditentukan.
5.2 Status 106 – Kuota Terlampaui
Pesan SMS dapat diblokir dengan kode status 106 (“kuota terlampaui”) ketika:
- Pesan melampaui batas yang ditentukan untuk quotaId terkait dalam interval saat ini.
- Negara atau wilayah tujuan tidak memiliki kuota yang ditetapkan (yaitu, diblokir secara eksplisit dengan pemetaan kuota nol dalam profile).
- Tidak ada kuota yang cocok dan tidak ada kuota default yang ditetapkan, sehingga mengakibatkan penolakan.
Dalam kasus ini, sistem mencegah pemrosesan pesan lebih lanjut untuk menegakkan batasan berbasis pelanggan atau tujuan dan menghindari penyalahgunaan.
Laporan pengiriman
Hanya tidak ada atau pengiriman akhir dengan hasil sukses/gagal yang didukung.
Format laporan pengiriman: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx selesai tanggal: yyMMddHHmm stat:
Nilai yang tersedia dalam status:
- DIKIRIM
- KEDALUWARSA
- DITOLAK
- TIDAK DIKIRIM
- DIHAPUS
6.1 Format laporan pengiriman yang diperluas
Informasi tambahan dalam laporan pengiriman dapat diminta melalui kontak dengan perwakilan penjualan Anda.
Format laporan pengiriman: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 tanggal pengiriman:
yyMMddHHmm tanggal selesai: yyMMddHHmm stat: berbuat salah: teks:
Nilai yang tersedia dalam status:
- DIKIRIM
- KEDALUWARSA
- DITOLAK
- TIDAK DIKIRIM
- DIHAPUS
Bidang “sub” dan “dlvrd” akan selalu disetel ke 000, dan bidang “teks” akan selalu kosong.
Lihat bab Kode kesalahan untuk mengetahui nilai bidang “err”.
Versi TLS yang didukung
TLS 1.2 atau TLS 1.3 diperlukan untuk semua koneksi TLS melalui SMPP.
Dukungan untuk TLS 1.0 dan 1.1 dihentikan sejak 2020-11-15. TLS versi 1.0 dan 1.1 adalah protokol lama yang sudah tidak digunakan lagi dan dianggap sebagai risiko keamanan dalam komunitas Internet.
LINK sangat menyarankan untuk menggunakan TLS jika koneksi SMPP tidak terenkripsi digunakan saat ini. Koneksi SMPP yang tidak terenkripsi tidak digunakan lagi mulai 2020-09-01 oleh LINK, dan akan dihapus di masa mendatang. Tanggal penghapusan koneksi yang tidak terenkripsi belum diputuskan.
Koneksi ke server SMPP untuk TLS berada di port 3601, bukan tidak terenkripsi di port 3600.
Anda masih dapat menggunakan TLS meskipun implementasi SMPP Anda tidak mendukung TLS menggunakan stunnel, lihat https://www.stunnel.org/
Kode kesalahan
Kode kesalahan berikut mungkin dijawab di kolom err jika kolom tersebut diaktifkan.
| Kode kesalahan | Keterangan |
| 0 | Kesalahan yang tidak diketahui |
| 1 | Kesalahan perutean sementara |
| 2 | Kesalahan perutean permanen |
| 3 | Pelambatan maksimum terlampaui |
| 4 | Waktu habis |
| 5 | Kesalahan operator tidak diketahui |
| 6 | Kesalahan operator |
| 100 | Layanan tidak ditemukan |
| 101 | Pengguna tidak ditemukan |
| 102 | Akun tidak ditemukan |
| 103 | Kata sandi salah |
| 104 | Kesalahan konfigurasi |
| 105 | Kesalahan internal |
| 106 | Kuota terlampaui |
| 200 | OK |
| 1000 | Terkirim |
| 1001 | Terkirim |
| 1002 | Kedaluwarsa |
| 1003 | Dihapus |
| 1004 | Ponsel penuh |
| 1005 | Mengantri |
| 1006 | Tidak terkirim |
| 1007 | Terkirim, tagihan tertunda |
| 1008 | Dikenakan biaya, pesan tidak terkirim |
| 1009 | Dikenakan biaya, pesan tidak terkirim |
| 1010 | Kedaluwarsa, tidak adanya laporan pengiriman operator |
| 1011 | Dikenakan biaya, pesan terkirim (ke operator) |
| 1012 | Mengantri dari jarak jauh |
| 1013 | Pesan terkirim ke operator, pengisian tertunda |
| 2000 | Nomor sumber tidak valid |
| 2001 | Nomor pendek tidak didukung sebagai sumber |
| 2002 | Alpha tidak didukung sebagai sumber |
| 2003 | MSISDN tidak didukung sebagai nomor sumber |
| 2100 | Nomor pendek tidak didukung sebagai tujuan |
| 2101 | Alpha tidak didukung sebagai tujuan |
| 2102 | MSISDN tidak didukung sebagai tujuan |
| 2103 | Operasi diblokir |
| 2104 | Pelanggan tidak dikenal |
| 2105 | Tujuan diblokir |
| 2106 | Kesalahan angka |
| 2107 | Tujuan diblokir sementara |
| 2108 | Tujuan tidak valid |
| 2200 | Kesalahan pengisian daya |
| 2201 | Pelanggan memiliki saldo rendah |
|
2202 |
Pelanggan dilarang karena membayar lebih (premium)
pesan |
|
2203 |
Pelanggan terlalu muda (untuk yang ini)
kandungan) |
| 2204 | Pelanggan prabayar tidak diperbolehkan |
| 2205 | Layanan ditolak oleh pelanggan |
| 2206 | Pelanggan tidak terdaftar di sistem pembayaran |
| 2207 | Pelanggan telah mencapai saldo maksimal |
| 2208 | Konfirmasi pengguna akhir diperlukan |
| 2300 | Dikembalikan dananya |
|
2301 |
Tidak dapat melakukan pengembalian dana karena ilegal atau hilang
MSISDN |
| 2302 | Tidak dapat mengembalikan dana karena ID pesan tidak ada |
| 2303 | Mengantri untuk pengembalian dana |
| 2304 | Batas waktu pengembalian dana |
| 2305 | Kegagalan pengembalian dana |
| 3000 | Pengkodean GSM tidak didukung |
| 3001 | Pengkodean UCS2 tidak didukung |
| 3002 | Pengkodean biner tidak didukung |
| 4000 | Laporan pengiriman tidak didukung |
| 4001 | Isi pesan tidak valid |
| 4002 | Tarif tidak valid |
| 4003 | Data pengguna tidak valid |
| 4004 | Header data pengguna tidak valid |
| 4005 | Pengkodean data tidak valid |
| 4006 | PPN tidak sah |
| 4007 | Konten yang tidak didukung untuk tujuan |
Dokumen / Sumber Daya
 |
API SMS mobilitas tautan, API SMPP MS Scheduler API [Bahasa Indonesia:] Panduan Pengguna SMS API SMPP API MS Penjadwal API, SMS API SMPP API, MS Penjadwal API, Penjadwal API, API |