Webhook SMS - Short Message Service

Anda dapat menentukan URL panggilan balik untuk menerima tanda terima pengiriman dari server HTTP. Dengan mengonfigurasi URL panggilan balik, Anda dapat memastikan penerimaan informasi yang tepat waktu dan akurat terkait status pesan SMS Anda.

null

Idempotensi tanda terima pengiriman tidak dijamin. Kami menyarankan Anda mengambil langkah-langkah yang sesuai untuk memastikan keakuratan dan konsistensi data setelah menerima tanda terima pengiriman.

Protokol

Parameter	Deskripsi
Protokol	HTTP + JSON
Pengkodean	UTF-8

Parameter permintaan

Data dari permintaan POST berformat JSON Array. Beberapa tanda terima pengiriman dapat dikirimkan ke server HTTP secara bersamaan.

Parameter	Tipe	Contoh	Deskripsi
To	String	8521234****	Nomor ponsel yang menerima tanda terima pengiriman.
Status	String	1	Status pesan. 1: Pesan telah dikirim. 2: Pesan gagal dikirim. 6: Pesan kedaluwarsa.
MessageId	String	123456789****	ID tanda terima pengiriman.
SmsSize	String	1	Jumlah pesan. Pesan panjang dibagi menjadi beberapa pesan.
TaskId	String	123456	ID tugas.
SendDate	String	Kam, 25 Nov 2021 10:27:00 +0800	Waktu ketika pesan dikirim ke operator.
ReceiveDate	String	Kam, 25 Nov 2021 10:27:33 +0800	Waktu ketika tanda terima pengiriman diterima dari operator.
ErrorCode	String	success	Kode kesalahan.
ErrorDescription	String	success	Pesan kesalahan.

Contoh

[{
    "To" : "8521111****",
    "SendDate" : "Thu, 25 Nov 2021 10:25:00 +0800",
    "ReceiveDate" : "Thu, 25 Nov 2021 10:25:33 +0800",
    "Status" : "1",
    "ErrorCode" : "success",
    "ErrorDescription" : "success",
    "TaskId" : "67890",
    "SmsSize":"2",
    "MessageId" : "123450000****"
  }]

Parameter respons

Jika tanda terima pengiriman berhasil dikirim ke server HTTP Anda, respons 200 akan dikembalikan. Jika tidak, sistem akan mencoba mengirim ulang tanda terima pengiriman.

Contoh Respons

{
  "code" : 0,
  "msg" : "Pesan diterima."
}

Parameter Respons
Parameter
Tipe
Diperlukan
Contoh
Deskripsi
code
Angka
Ya
0
Kode respons.
msg
String
Tidak
Diterima
Pesan kesalahan.

Percobaan ulang

Jika sistem gagal mengirimkan tanda terima pengiriman, ia akan mencoba lagi dalam 1 menit atau 5 menit hingga pengiriman berhasil. Jika sistem gagal selama tiga kali berturut-turut, pengiriman tanda terima akan dihentikan.

Parameter	Tipe	Diperlukan	Contoh	Deskripsi
code	Angka	Ya	0	Kode respons.
msg	String	Tidak	Diterima	Pesan kesalahan.