Delivery Report POST
เมื่อเครือข่ายรายงานผลการส่ง SMS ระบบจะ POST สถานะไปยัง URL ของคุณ (notifyUrl) ที่ระบุไว้ตอนส่ง ใช้เพื่ออัปเดตสถานะในระบบของคุณแบบอัตโนมัติ โดยไม่ต้องคอยถาม /sms/loginfo
การตั้งค่า
ใส่ notifyUrl ในแต่ละ message ของ POST /sms/send — ตั้งได้ต่อ message ไม่มีการตั้งค่าระดับบัญชี
{
"messages": [
{
"from": "MYBRAND",
"destinations": [{ "to": "0812345678" }],
"text": "รหัสสั่งซื้อ #1234 จัดส่งแล้ว",
"notifyUrl": "https://example.com/smsup/dr?token=YOUR_SECRET"
}
]
}TIP
callback ส่งเฉพาะข้อความจาก /sms/send ที่มี notifyUrl เท่านั้น ส่วน /OTP/requestotp รับฟิลด์ notifyUrl ได้แต่ไม่มีการส่ง callback
Authorization
ไม่มีลายเซ็นหรือ header ยืนยันตัวตนใน callback — แนะนำให้ใช้ HTTPS และใส่ค่าลับของคุณเองใน notifyUrl (เช่น query token) แล้วตรวจค่านั้นที่ปลายทาง
HTTP Request
POST {notifyUrl}Content Type
application/json (เสมอ ไม่ขึ้นกับค่า notifyContentType)
Parameter Description
| Property | Type | Description |
|---|---|---|
bulkId | string | bulkId ของ request /sms/send ที่ส่งข้อความนี้ |
details | array | รายการผล — มี 1 รายการต่อ callback |
details[]
| Property | Type | Description |
|---|---|---|
messageId | string | รหัสอ้างอิงข้อความจากเครือข่าย — อาจไม่ตรงกับ messageId ที่ได้จาก /sms/send ให้จับคู่ด้วย bulkId + to |
mobile | string | เบอร์ปลายทาง รูปแบบ 66XXXXXXXXX |
to | string | เบอร์ปลายทาง (ค่าเดียวกับ mobile) |
from | string | ชื่อผู้ส่ง |
text | string | ข้อความที่ส่ง |
credit | number | เครดิตที่ใช้กับเบอร์นี้ |
sendDate | string | เวลาที่ส่งออก รูปแบบ yyyy-MM-dd HH:mm:ss (UTC) |
doneDate | string | เวลาที่ส่งถึง รูปแบบเดียวกัน — อาจเป็นค่าว่าง "" |
callbackData | string | สงวนไว้ — ปัจจุบันเป็นค่าว่าง "" |
status | object | ผลการส่ง ดูตารางด้านล่าง |
status
| Property | Type | Description |
|---|---|---|
code | string | 000 = สำเร็จ, ค่าอื่น = รหัสผลจากเครือข่าย |
name | string | DELIVERED หรือ FAILED |
description | string | คำอธิบายจากเครือข่าย (อาจเป็นค่าว่าง) |
code | name | ความหมาย |
|---|---|---|
000 | DELIVERED | เครือข่ายรายงานว่าส่งสำเร็จ |
| ค่าอื่น | FAILED | ส่งไม่สำเร็จ — code และ description มาจากเครือข่ายปลายทาง |
Response Description
ปลายทางของคุณต้องตอบ HTTP 2xx ภายใน 10 วินาที — body ใช้อะไรก็ได้ (ระบบไม่อ่าน)
| ผล | ระบบถือว่า |
|---|---|
| HTTP 200–299 ภายใน 10 วินาที | ส่งสำเร็จ ไม่ส่งซ้ำ |
| HTTP อื่น, timeout, เชื่อมต่อไม่ได้ | ไม่สำเร็จ — ลองใหม่ตามตาราง retry |
Retry
| ครั้งที่ | เวลา |
|---|---|
| 1 | ทันทีหลังได้รับผลจากเครือข่าย |
| 2 | อย่างน้อย 5 วินาทีหลังครั้งที่ 1 ล้มเหลว |
| 3 | อย่างน้อย 30 วินาทีหลังครั้งที่ 2 ล้มเหลว |
ล้มเหลวครบ 3 ครั้งระบบจะหยุดส่ง callback นั้น — ตรวจสถานะย้อนหลังได้จาก /sms/loginfo
ตัวอย่าง Request
# จำลอง callback เพื่อทดสอบปลายทางของคุณ
curl -X POST 'https://example.com/smsup/dr?token=YOUR_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"bulkId": "6f1c2a8e-1b7a-4c35-9d0e-2b8f6f3e9a11",
"details": [{
"messageId": "2611160315200001",
"mobile": "66812345678",
"to": "66812345678",
"from": "MYBRAND",
"text": "รหัสสั่งซื้อ #1234 จัดส่งแล้ว",
"credit": 1,
"sendDate": "2026-11-16 03:15:20",
"doneDate": "",
"callbackData": "",
"status": { "code": "000", "name": "DELIVERED", "description": "" }
}]
}'// ตัวอย่างปลายทางรับ callback (Express)
import express from 'express'
const app = express()
app.use(express.json())
app.post('/smsup/dr', async (req, res) => {
if (req.query.token !== process.env.SMSUP_DR_TOKEN) return res.sendStatus(403)
const { bulkId, details = [] } = req.body
for (const d of details) {
// อัปเดตแบบ idempotent: callback ของข้อความเดียวกันอาจมาซ้ำ
await saveStatus({ bulkId, to: d.to, code: d.status.code, name: d.status.name })
}
res.sendStatus(200) // ตอบให้เร็ว (ภายใน 10 วินาที)
})
app.listen(3000)ตัวอย่าง Response
HTTP/1.1 200 OKข้อควรระวัง
callback อาจมาซ้ำ
- บางเครือข่ายรายงานผล 2 ครั้งต่อข้อความ (เครือข่ายรับข้อความแล้ว และส่งถึงเครื่องผู้รับแล้ว) คุณจึงอาจได้ callback มากกว่าหนึ่งครั้งต่อเบอร์ และทั้งสองครั้งอาจเป็น
DELIVERED - ถ้าปลายทางตอบช้าเกิน 10 วินาที ระบบจะ retry แม้ปลายทางประมวลผลไปแล้ว
ออกแบบปลายทางให้รับซ้ำได้ (idempotent) และใช้ผลล่าสุดเป็นสถานะสุดท้าย
TIP
messageId ใน callback เป็นรหัสจากเครือข่าย ไม่ใช่ messageId ที่ระบบตอบตอนส่ง ให้เก็บ bulkId และเบอร์ปลายทางไว้ใช้จับคู่ หรือส่ง bulkId ของคุณเองใน request /sms/send
