เอกสาร API ส่ง SMS และ OTP สำหรับนักพัฒนา | SEPSMS

POST /message/send sms:send

ส่ง SMS

ส่งข้อความถึงปลายทางหนึ่งหรือหลายเบอร์ในคำขอเดียว ใส่ตัวแปรรายคน (personalize) หรือตั้งเวลาส่งล่วงหน้าได้

originstringชื่อผู้ส่ง (Sender Name) ที่อนุมัติแล้ว

messagestringข้อความที่ต้องการส่ง

recipientsstring[]เบอร์ปลายทาง รูปแบบ 0xxxxxxxxx หรือ 66xxxxxxxxx

scheduledTimestring?เวลาส่งแบบ ISO 8601 (เว้นว่าง = ส่งทันที)

variablesobject?ค่าตัวแปรรายคนสำหรับ personalize

คำขอ

curl -X POST https://sepsms.com/api/v2/message/send \
  -H "X-API-Key: sk_sep_..." \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "SEPSMS",
    "recipients": ["66812345678", "66898765432"],
    "message": "สวัสดีคุณลูกค้า รับส่วนลด 10% วันนี้",
    "scheduledTime": null
  }'

ผลลัพธ์

{
  "result": {
    "uuid": "9f8b2c1e-...",
    "refNo": "SP240115...",
    "totalMsisdn": 2,
    "totalCredit": 2,
    "blockedCount": 0,
    "status": "pending"
  }
}

POST /otp/send otp:send

ส่ง OTP

ส่งรหัสยืนยันแบบใช้ครั้งเดียวพร้อมรหัสอ้างอิง (reference) ระบบสร้างรหัสและส่งทาง SMS ให้ รหัสจะไม่ถูกส่งกลับมาในผลลัพธ์

destinationstringเบอร์ปลายทาง

originstringชื่อผู้ส่ง

templatestring?ข้อความ ต้องมี {code} (และใส่ {ref} ได้)

ttlSecondsnumber?อายุรหัส 60-600 วินาที (ค่าเริ่มต้น 300)

codeLengthnumber?ความยาวรหัส 4-8 หลัก

คำขอ

curl -X POST https://sepsms.com/api/v2/otp/send \
  -H "X-API-Key: sk_sep_..." \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "66812345678",
    "origin": "SEPSMS",
    "template": "รหัสยืนยันของคุณคือ {code} (Ref: {ref})"
  }'

ผลลัพธ์

{
  "result": {
    "uuid": "1a2b...",
    "reference": "A3K9X2",
    "destination": "66812345678",
    "expiresAt": "2026-01-15T10:35:00.000Z",
    "ttlSeconds": 300
  }
}

POST /otp/verify otp:verify

ตรวจสอบ OTP

ตรวจสอบรหัสที่ผู้ใช้กรอก โดยอ้างอิงจาก reference ที่ได้ตอนส่ง

referencestringรหัสอ้างอิงที่ได้จากตอนส่ง OTP

pinstringรหัสที่ผู้ใช้กรอก

คำขอ

curl -X POST https://sepsms.com/api/v2/otp/verify \
  -H "X-API-Key: sk_sep_..." \
  -H "Content-Type: application/json" \
  -d '{ "reference": "A3K9X2", "pin": "123456" }'

ผลลัพธ์

{ "result": { "reference": "A3K9X2", "verified": true } }

GET /message/{uuid} sms:read

สถานะการนำส่ง

ดูสรุปสถานะการนำส่งของข้อความที่ส่งไป (ดูรายเบอร์ได้ที่ /v2/message/{uuid}/recipients)

uuidpathuuid ที่ได้ตอนส่ง SMS

คำขอ

curl https://sepsms.com/api/v2/message/9f8b2c1e-... \
  -H "X-API-Key: sk_sep_..."

ผลลัพธ์

{
  "result": {
    "uuid": "9f8b2c1e-...",
    "origin": "SEPSMS",
    "status": "completed",
    "totalMsisdn": 2,
    "drSummary": [
      { "drStatus": "success", "count": 2 }
    ],
    "refundedCount": 0
  }
}

GET /message/{uuid}/recipients sms:read

รายเบอร์ปลายทางของข้อความหนึ่งฉบับ

ดูสถานะการนำส่งรายเบอร์ ส่งครั้งละไม่เกิน 50 รายการ วิธีที่แนะนำสำหรับงานที่มีปลายทางหลักแสนคือส่ง after เป็นค่า uuid ของรายการสุดท้ายที่ได้มา แล้ววนต่อไปเรื่อย ๆ ต้นทุนต่อหน้าจะไม่โตตามความลึก เมื่อใช้ after ระบบจะคืน pagination.nextCursor ให้ใช้เป็น after รอบถัดไป และ pagination.hasMore บอกว่ายังมีต่อหรือไม่ วนจนกว่า hasMore จะเป็น false ส่วน summary คือจำนวนแยกตามสถานะของทั้งงาน ไม่ใช่เฉพาะหน้านี้ จึงส่งมาให้เฉพาะหน้าแรก ไม่ส่งซ้ำในหน้าถัดไป และ offset ไม่ใช่พารามิเตอร์ของ endpoint นี้ ส่งไปก็ไม่มีผล

uuidpathuuid ที่ได้ตอนส่ง SMS

afternumber?uuid ของรายการสุดท้ายที่ได้มา จะได้รายการถัดจากนั้น หน้าแรกของการไล่ให้ส่ง 0

pagenumber?เลขหน้า เริ่มที่ 1 ใช้เมื่อไม่ได้ใช้ after จะช้าลงเมื่อหน้าลึก

limitnumber?จำนวนต่อหน้า 1 ถึง 50 ค่าเริ่มต้น 50

statusstring?กรองตามสถานะนำส่ง เช่น pending, success, failed, expired, blocked, invalid, timeout, cancelled

searchstring?ค้นบางส่วนของเบอร์ปลายทาง

คำขอ

curl "https://sepsms.com/api/v2/message/9f8b2c1e-.../recipients?limit=50&after=3c7f1a90-4b21-4e77-9a03-0d5e1c884f60" \
  -H "X-API-Key: sk_sep_..."

ผลลัพธ์

{
  "result": [
    {
      "id": 8814022,
      "uuid": "3c7f1a90-4b21-4e77-9a03-0d5e1c884f60",
      "destination": "66812345678",
      "message": "ข้อความที่ส่ง",
      "drStatus": "success",
      "drStatusAt": "2026-08-31T09:14:02.000Z"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 50,
    "total": 1250,
    "nextCursor": "3c7f1a90-4b21-4e77-9a03-0d5e1c884f60",
    "hasMore": true
  },
  "summary": [
    { "drStatus": "success", "count": 1180 },
    { "drStatus": "failed", "count": 70 }
  ]
}

GET /message/credit/balance credit:read

ยอดเครดิตคงเหลือ

ตรวจสอบเครดิตคงเหลือในบัญชี

คำขอ

curl https://sepsms.com/api/v2/message/credit/balance \
  -H "X-API-Key: sk_sep_..."

ผลลัพธ์

{ "result": { "balance": 18420 } }

GET /senders senders:read

รายชื่อผู้ส่ง (Sender)

ดึงรายชื่อผู้ส่ง (Sender Name) ที่บัญชีของคุณใช้ได้ พร้อมสถานะการอนุมัติ (status), การมองเห็น (privilege) และเป็นชื่อสำหรับ OTP เท่านั้นหรือไม่ (isOtpOnly) นำค่า origin ที่ได้ไปใช้เป็นชื่อผู้ส่งตอนส่ง SMS/OTP ใช้ privilege แยกผู้ส่งที่เป็นของคุณเอง (private) ออกจากผู้ส่งกองกลางที่ทุกบัญชีใช้ได้ (public) ไม่มีฟิลด์อื่นที่แยกสองอย่างนี้ได้

คำขอ

curl https://sepsms.com/api/v2/senders \
  -H "X-API-Key: sk_sep_..."

ผลลัพธ์

{
  "result": [
    {
      "uuid": "95d7bb42-...",
      "origin": "SEPSMS",
      "status": "approved",
      "privilege": "private",
      "isOtpOnly": false,
      "trialAllowed": true,
      "sample": "พิเศษ! ลูกค้ารับส่วนลด 20% วันนี้",
      "purpose": "แจ้งโปรโมชันและข่าวสารถึงลูกค้า",
      "availableSince": "2026-06-01T07:08:44.000Z",
      "lastUsedAt": null,
      "createdAt": "2026-06-01T07:08:44.000Z"
    }
  ]
}

POST /webhooks dashboard

Webhook แจ้งเตือน

ลงทะเบียนและจัดการ URL ปลายทางจากแดชบอร์ดนักพัฒนา (ต้องเข้าสู่ระบบ ไม่รองรับการสร้างผ่าน API Key) เมื่อลงทะเบียนแล้ว ทุกเหตุการณ์ เช่น ส่งสำเร็จ/ล้มเหลว, ผลนำส่ง และเครดิตใกล้หมด จะถูกส่งไปที่ URL ของคุณ ทุก payload เซ็นด้วย HMAC-SHA256 (header X-Webhook-Signature)

urlstringปลายทาง HTTPS ที่จะรับ event

eventsstring[]รายการ event ที่ต้องการรับ

คำขอ

# Webhook endpoints are registered + managed in the
# developer dashboard (logged-in). Registration is not
# available to API keys. Registration payload:
{
  "url": "https://your-app.com/hooks/sepsms",
  "events": ["dr.success", "dr.failed"]
}

ผลลัพธ์

// POST sent to your URL. The event name, timestamp and
// signature travel in headers, not the body:
//   X-Webhook-Event: dr.success
//   X-Webhook-Timestamp: 1737020405
//   X-Webhook-Signature: t=1737020405,v1=<hmac-sha256>
{
  "smsUuid": "9f8b2c1e-...",
  "msisdn": "66812345678",
  "txId": "8f3a1c9d...",
  "status": "success"
}

Webhook events: sms.sentsms.failedsms.completeddr.successdr.failedotp.verifiedcredit.loworder.completed

เชื่อมต่อส่ง SMS และ OTP ผ่าน REST API

เริ่มเชื่อมต่อใน 3 ขั้นตอน

รับ API Key

แนบ Header

เรียก Endpoint

ยืนยันตัวตนด้วย API Key

Endpoints หลัก

ส่ง SMS

ส่ง OTP

ตรวจสอบ OTP

สถานะการนำส่ง

รายเบอร์ปลายทางของข้อความหนึ่งฉบับ

ยอดเครดิตคงเหลือ

รายชื่อผู้ส่ง (Sender)

Webhook แจ้งเตือน

ลิมิตการเรียก

รูปแบบข้อผิดพลาด

พร้อมเชื่อมต่อแล้วหรือยัง?