Skip to content

Delivery Report POST ​

เมื่อเครือข่ายรายงานผลการส่ง SMS ระบบจะ POST สถานะไปยัง URL ของคุณ (notifyUrl) ที่ระบุไว้ตอนส่ง ใช้เพื่ออัปเดตสถานะในระบบของคุณแบบอัตโนมัติ โดยไม่ต้องคอยถาม /sms/loginfo

การตั้งค่า ​

ใส่ notifyUrl ในแต่ละ message ของ POST /sms/send — ตั้งได้ต่อ message ไม่มีการตั้งค่าระดับบัญชี

json
{
  "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 ​

http
POST {notifyUrl}

Content Type ​

application/json (เสมอ ไม่ขึ้นกับค่า notifyContentType)

Parameter Description ​

PropertyTypeDescription
bulkIdstringbulkId ของ request /sms/send ที่ส่งข้อความนี้
detailsarrayรายการผล — มี 1 รายการต่อ callback

details[] ​

PropertyTypeDescription
messageIdstringรหัสอ้างอิงข้อความจากเครือข่าย — อาจไม่ตรงกับ messageId ที่ได้จาก /sms/send ให้จับคู่ด้วย bulkId + to
mobilestringเบอร์ปลายทาง รูปแบบ 66XXXXXXXXX
tostringเบอร์ปลายทาง (ค่าเดียวกับ mobile)
fromstringชื่อผู้ส่ง
textstringข้อความที่ส่ง
creditnumberเครดิตที่ใช้กับเบอร์นี้
sendDatestringเวลาที่ส่งออก รูปแบบ yyyy-MM-dd HH:mm:ss (UTC)
doneDatestringเวลาที่ส่งถึง รูปแบบเดียวกัน — อาจเป็นค่าว่าง ""
callbackDatastringสงวนไว้ — ปัจจุบันเป็นค่าว่าง ""
statusobjectผลการส่ง ดูตารางด้านล่าง

status ​

PropertyTypeDescription
codestring000 = สำเร็จ, ค่าอื่น = รหัสผลจากเครือข่าย
namestringDELIVERED หรือ FAILED
descriptionstringคำอธิบายจากเครือข่าย (อาจเป็นค่าว่าง)
codenameความหมาย
000DELIVEREDเครือข่ายรายงานว่าส่งสำเร็จ
ค่าอื่น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 ​

bash
# จำลอง 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": "" }
    }]
  }'
js
// ตัวอย่างปลายทางรับ 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
HTTP/1.1 200 OK

ข้อควรระวัง ​

callback อาจมาซ้ำ

  • บางเครือข่ายรายงานผล 2 ครั้งต่อข้อความ (เครือข่ายรับข้อความแล้ว และส่งถึงเครื่องผู้รับแล้ว) คุณจึงอาจได้ callback มากกว่าหนึ่งครั้งต่อเบอร์ และทั้งสองครั้งอาจเป็น DELIVERED
  • ถ้าปลายทางตอบช้าเกิน 10 วินาที ระบบจะ retry แม้ปลายทางประมวลผลไปแล้ว

ออกแบบปลายทางให้รับซ้ำได้ (idempotent) และใช้ผลล่าสุดเป็นสถานะสุดท้าย

TIP

messageId ใน callback เป็นรหัสจากเครือข่าย ไม่ใช่ messageId ที่ระบบตอบตอนส่ง ให้เก็บ bulkId และเบอร์ปลายทางไว้ใช้จับคู่ หรือส่ง bulkId ของคุณเองใน request /sms/send