SMS API, SMPP API MS ตัวกำหนดเวลา API
คู่มือการใช้งาน

SMS API, SMPP API MS ตัวกำหนดเวลา API

ปรับปรุงแก้ไข:	6/24/2025
เวอร์ชัน:	1.7
ผู้เขียน:	เคนนี่ โคแลนเดอร์ นอร์เดน, KCN

เอกสารนี้มีไว้สำหรับผู้รับที่กำหนดเท่านั้น และอาจมีข้อมูลพิเศษ กรรมสิทธิ์ หรือข้อมูลส่วนตัวอื่นๆ หากคุณได้รับเนื่องจากข้อผิดพลาด โปรดแจ้งผู้ส่งทันทีและลบต้นฉบับ ห้ามคุณใช้เอกสารในลักษณะอื่นใด

ประวัติการเปลี่ยนแปลง

เรฟ	วันที่	By	การเปลี่ยนแปลงจากรุ่นก่อนหน้า
1.0	2010-03-16	เคซีเอ็น	สร้าง
1.	2019-06-11	ทีพีอี	อัปเดตโลโก้ LINK
1.	2019-09-27	PNI	เพิ่มการอ้างอิงถึงข้อกำหนด SMPP 3.4
1.	2019-10-31	EP	ข้อสังเกตเกี่ยวกับระยะเวลาที่ใช้ได้ tag
1.	2020-08-28	เคซีเอ็น	เพิ่มข้อมูลเกี่ยวกับเวอร์ชัน TLS ที่รองรับ
2.	2022-01-10	เคซีเอ็น	เพิ่มข้อมูลเพิ่มเติมเกี่ยวกับรายงานการจัดส่ง ข้อมูลอัปเดตเกี่ยวกับ TLS 1.3
2.	2025-06-03	GM	เพิ่มรหัสผลลัพธ์ 2108
2.	2025-06-24	AK	เพิ่มโควต้า

การแนะนำ

LINK Mobility เป็นผู้จัดจำหน่าย SMS มาตั้งแต่ปี 2001 และมีประสบการณ์มากมายในการทำงานกับทั้งผู้ให้บริการและผู้รวบรวมการเชื่อมต่อ แพลตฟอร์มนี้ออกแบบมาเพื่อรองรับทราฟฟิกปริมาณมาก รักษาความพร้อมใช้งานสูง และทำให้ง่ายต่อการกำหนดเส้นทางทราฟฟิกผ่านการเชื่อมต่อที่หลากหลาย
เอกสารนี้จะอธิบายอินเทอร์เฟซ SMPP สำหรับแพลตฟอร์ม SMSC รวมถึงพารามิเตอร์และคำสั่งที่จำเป็นและพารามิเตอร์ที่ได้รับการรองรับ
เอกสารนี้จะไม่จัดการกรณีการใช้งานที่เฉพาะเจาะจงเช่นข้อความที่ต่อกัน WAPpush, Flash SMS เป็นต้น สามารถขอข้อมูลเพิ่มเติมเกี่ยวกับกรณีเหล่านี้ได้โดยติดต่อฝ่ายสนับสนุน

คำสั่งที่รองรับ

เซิร์ฟเวอร์ของ LINK Mobility ควรถือเป็น SMPP 3.4 สามารถดูรายละเอียดสเปคอย่างเป็นทางการได้ที่ https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
ไม่รองรับเมธอดทั้งหมด และความแตกต่างทั้งหมดระบุไว้ด้านล่าง
4.1 ผูกพัน
รองรับคำสั่งผูกต่อไปนี้

• เครื่องส่งสัญญาณ
• ตัวรับส่งสัญญาณ
• ตัวรับสัญญาณ

พารามิเตอร์ที่จำเป็น:

• system_id - ได้รับจากการสนับสนุน
• รหัสผ่าน – ได้รับจากการสนับสนุน

พารามิเตอร์เสริม:

• addr_ton – ค่าเริ่มต้นหาก TON ถูกตั้งค่าเป็น Unknown ระหว่างการส่ง
• addr_npi – ค่าเริ่มต้นหากตั้งค่า NPI เป็น Unknown ระหว่างการส่ง

พารามิเตอร์ที่ไม่รองรับ:

• ที่อยู่_ช่วง

4.2 เลิกผูก
รองรับคำสั่ง unbind
4.3 ลิงค์สอบถาม
คำสั่งลิงค์สอบถามได้รับการสนับสนุนและควรเรียกใช้ทุก ๆ 60 วินาที
4.4 ส่ง
ควรใช้วิธีการส่งสำหรับการส่งข้อความ
พารามิเตอร์ที่จำเป็น:

• source_addr_ton
• source_addr_npi
• แหล่งที่มา_addr
• ปลายทาง_addr_ton
• dest_addr_npi
• ปลายทาง
• esm_คลาส
• ข้อมูล_การเข้ารหัส
• sm_length
• ข้อความสั้น ๆ

พารามิเตอร์ที่ไม่รองรับ:

• ประเภทบริการ
• protocol_id
• ลำดับความสำคัญ_ธง
• กำหนดการ_จัดส่ง_เวลา
• แทนที่_if_present_flag
• sm_default_msg_id

บันทึก ว่าน้ำหนักบรรทุก tag ไม่รองรับและอาจมีการส่ง SMS เพียงครั้งเดียวต่อการโทรหนึ่งครั้ง และขอแนะนำให้ใช้ validity_period tag มีค่าความยาว 15 นาทีเป็นอย่างน้อย
4.4.1 TON และ NPI ที่แนะนำ
ควรใช้ TON และ NPI ต่อไปนี้เมื่อส่งข้อความโดยใช้คำสั่ง send
4.4.1.1 แหล่งที่มา
รองรับชุดค่าผสม TON และ NPI ต่อไปนี้สำหรับที่อยู่ต้นทาง ชุดค่าผสมอื่นๆ ทั้งหมดจะถือว่าไม่ถูกต้อง คำสั่ง TON จาก bind เริ่มต้นจะถูกใช้หากตั้งค่า TON เป็น Unknown (0) คำสั่ง NPI จาก bind เริ่มต้นจะถูกใช้หากตั้งค่า NPI เป็น Unknown (0)

ตัน	เอ็นพีไอ	คำอธิบาย
ตัวอักษรและตัวเลข (5)	ไม่ทราบ (0) ไอเอสดีเอ็น (1)	จะถือว่าเป็นข้อความของผู้ส่งที่เป็นตัวอักษรและตัวเลข
นานาชาติ (1)	ไม่ทราบ (0) ไอเอสดีเอ็น (1)	จะถือว่าเป็น MSISDN
แห่งชาติ (2) เฉพาะเครือข่าย (3) หมายเลขสมาชิก (4) ย่อ (6)	ไม่ทราบ (0) ไอเอสดีเอ็น (1) แห่งชาติ (8)	จะถือเป็นหมายเลขสั้นเฉพาะประเทศ

4.4.1.2 จุดหมายปลายทาง
ชุดค่าผสม TON และ NPI ต่อไปนี้รองรับที่อยู่ปลายทาง ชุดค่าผสมอื่นๆ ทั้งหมดจะถือว่าไม่ถูกต้อง คำสั่ง TON from bind เริ่มต้นจะถูกใช้หากตั้งค่า TON เป็น Unknown (0) คำสั่ง NPI จาก bind เริ่มต้นจะถูกใช้หากตั้งค่า NPI เป็น Unknown (0)

ตัน	เอ็นพีไอ	คำอธิบาย
นานาชาติ (1)	ไม่ทราบ (0) ไอเอสดีเอ็น (1)	จะถือว่าเป็น MSISDN

4.4.2 การเข้ารหัสที่รองรับ
รองรับการเข้ารหัสต่อไปนี้ X อาจมีค่าใดๆ

ดีซีเอส	การเข้ารหัส
0xX0	ตัวอักษร GSM เริ่มต้นพร้อมส่วนขยาย
0xX2	ไบนารี 8 บิต

0xX8	UCS2 (ISO-10646-UCS-2)

โควตา

5.1 โควต้าเกินview
โควต้ากำหนดจำนวนข้อความ SMS สูงสุดที่สามารถส่งได้ภายในช่วงเวลาที่กำหนด (เช่น ต่อวัน ต่อสัปดาห์ ต่อเดือน หรือไม่จำกัด) แต่ละโควต้าจะถูกระบุด้วยโควต้า (UUID) ที่ไม่ซ้ำกัน และจะถูกรีเซ็ตตามเขตเวลาของลูกค้า คุณสามารถกำหนดโควต้าได้ตามประเทศ ภูมิภาค หรือระดับเริ่มต้นผ่าน Quota Profileสามารถกำหนดโควต้าแบบไดนามิกได้โดยใช้ Quota Mapping ซึ่งจะจับคู่ QuotaId (UUID) หลักและคีย์โควต้าเฉพาะ (เช่น ผู้ส่งหรือผู้ใช้) เข้ากับ quotaId เฉพาะ
โควตาจะถูกกำหนดตามการสนับสนุนในพื้นที่ของคุณ ผู้จัดการบัญชีที่ได้รับมอบหมายของคุณ หรือตามค่าเริ่มต้นหากไม่มีการระบุอะไรไว้
5.2 สถานะ 106 – เกินโควตา
ข้อความ SMS อาจถูกบล็อคด้วยรหัสสถานะ 106 (“เกินโควตา”) เมื่อ:

• ข้อความเกินขีดจำกัดที่กำหนดไว้สำหรับโควตาId ที่สอดคล้องกันภายในช่วงปัจจุบัน
• ประเทศหรือภูมิภาคปลายทางไม่มีการกำหนดโควตา (กล่าวคือ ถูกบล็อกอย่างชัดเจนด้วยการแมปโควตาว่างในโปรfile).
• ไม่มีโควตาที่ตรงกันและไม่มีการกำหนดโควตาเริ่มต้น ส่งผลให้ถูกปฏิเสธ
  ในกรณีเหล่านี้ ระบบจะป้องกันการประมวลผลข้อความเพิ่มเติมเพื่อบังคับใช้ข้อจำกัดตามลูกค้าหรือปลายทางและหลีกเลี่ยงการใช้งานในทางที่ผิด

รายงานการจัดส่ง

รองรับเฉพาะไม่มีหรือการส่งมอบขั้นสุดท้ายที่มีผลสำเร็จ/ล้มเหลวเท่านั้น
รูปแบบในรายงานการนำส่ง: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx วันที่เสร็จสิ้น: yyMMddHHmm stat:
ค่าที่มีอยู่ในสถานะ:

• จัดส่งแล้ว
• หมดอายุแล้ว
• ถูกปฏิเสธ
• ไม่ส่งมอบ
• ลบแล้ว

6.1 รูปแบบรายงานการจัดส่งเพิ่มเติม
อาจมีการขอข้อมูลเพิ่มเติมในรายงานการจัดส่งโดยติดต่อตัวแทนฝ่ายขายของคุณ
รูปแบบรายงานการจัดส่ง: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm วันที่เสร็จสิ้น: yyMMddHHmm สถิติ: ผิดพลาด: ข้อความ:
ค่าที่มีอยู่ในสถานะ:

• จัดส่งแล้ว
• หมดอายุแล้ว
• ถูกปฏิเสธ
• ไม่ส่งมอบ
• ลบแล้ว

ช่อง "sub" และ "dlvrd" จะตั้งค่าเป็น 000 เสมอ และช่อง "text" จะว่างเปล่าเสมอ
ดูรหัสข้อผิดพลาดของบทสำหรับค่าสำหรับฟิลด์ "err"

เวอร์ชัน TLS ที่รองรับ

ต้องใช้ TLS 1.2 หรือ TLS 1.3 สำหรับการเชื่อมต่อ TLS ทั้งหมดผ่าน SMPP
การสนับสนุนสำหรับ TLS 1.0 และ 1.1 ถูกยกเลิกตั้งแต่วันที่ 2020-11-15 เวอร์ชัน 1.0 และ 1.1 ของ TLS เป็นโปรโตคอลรุ่นเก่าที่เลิกใช้แล้วและถือเป็นความเสี่ยงด้านความปลอดภัยในชุมชนอินเทอร์เน็ต
LINK ขอแนะนำให้ใช้ TLS หากมีการใช้การเชื่อมต่อ SMPP ที่ไม่ได้เข้ารหัสในปัจจุบัน การเชื่อมต่อ SMPP ที่ไม่ได้เข้ารหัสจะเลิกใช้งานในวันที่ 2020-09-01 โดย LINK และจะถูกลบออกในอนาคต ยังไม่ได้กำหนดวันที่สำหรับการลบการเชื่อมต่อที่ไม่ได้เข้ารหัส
การเชื่อมต่อกับเซิร์ฟเวอร์ SMPP สำหรับ TLS อยู่ที่พอร์ต 3601 แทนที่จะไม่ได้เข้ารหัสที่พอร์ต 3600
คุณยังคงใช้ TLS ได้แม้ว่าการใช้งาน SMPP ของคุณไม่รองรับ TLS โดยใช้ Stunnel โปรดดู https://www.stunnel.org/

รหัสข้อผิดพลาด

รหัสข้อผิดพลาดต่อไปนี้อาจได้รับการตอบกลับในฟิลด์ err หากเปิดใช้งานฟิลด์นี้

รหัสข้อผิดพลาด	คำอธิบาย
0	ข้อผิดพลาดที่ไม่รู้จัก
1	ข้อผิดพลาดในการกำหนดเส้นทางชั่วคราว
2	ข้อผิดพลาดในการกำหนดเส้นทางอย่างถาวร
3	เกินการควบคุมสูงสุด
4	หมดเวลา
5	ข้อผิดพลาดที่ไม่รู้จักของผู้ให้บริการ
6	ข้อผิดพลาดของผู้ปฏิบัติงาน
100	ไม่พบบริการ
101	ไม่พบผู้ใช้
102	ไม่พบบัญชี

103	รหัสผ่านไม่ถูกต้อง
104	ข้อผิดพลาดในการกำหนดค่า
105	ข้อผิดพลาดภายใน
106	เกินโควต้า
200	OK
1000	ส่งแล้ว
1001	จัดส่งแล้ว
1002	หมดอายุแล้ว
1003	ลบแล้ว
1004	มือถือเต็ม
1005	เข้าคิว
1006	ไม่ส่งมาให้
1007	จัดส่งแล้ว เรียกเก็บเงินล่าช้า
1008	เรียกเก็บเงินแล้ว ส่งข้อความไม่ได้
1009	เรียกเก็บเงินแล้ว ข้อความไม่ส่ง
1010	หมดอายุ ไม่มีรายงานการจัดส่งของผู้ประกอบการ
1011	เรียกเก็บเงินแล้ว ส่งข้อความ (ไปยังโอเปอเรเตอร์)
1012	เข้าคิวจากระยะไกล
1013	ส่งข้อความถึงโอเปอเรเตอร์แล้ว การชาร์จล่าช้า
2000	หมายเลขแหล่งที่มาไม่ถูกต้อง
2001	ไม่สนับสนุนหมายเลขสั้นเป็นแหล่งที่มา
2002	อัลฟ่าไม่ได้รับการสนับสนุนเป็นแหล่งที่มา
2003	ไม่รองรับ MSISDN เป็นหมายเลขต้นทาง
2100	ไม่รองรับหมายเลขสั้นเป็นปลายทาง
2101	อัลฟ่าไม่ได้รับการสนับสนุนเป็นปลายทาง
2102	ไม่รองรับ MSISDN เป็นปลายทาง
2103	การดำเนินการถูกบล็อก
2104	สมาชิกที่ไม่รู้จัก
2105	ปลายทางถูกบล็อก
2106	หมายเลขผิดพลาด
2107	ปลายทางถูกบล็อกชั่วคราว
2108	จุดหมายปลายทางไม่ถูกต้อง
2200	ข้อผิดพลาดในการชาร์จ
2201	สมาชิกมียอดคงเหลือน้อย
2202	สมาชิกถูกระงับการใช้งานเนื่องจากถูกเรียกเก็บเงินเกิน (พรีเมียม) ข้อความ
2203	สมาชิกอายุน้อยเกินไป (สำหรับกรณีนี้โดยเฉพาะ เนื้อหา)
2204	ไม่อนุญาตให้สมัครสมาชิกแบบเติมเงิน
2205	บริการถูกปฏิเสธโดยสมาชิก
2206	ผู้ใช้บริการไม่ได้ลงทะเบียนในระบบการชำระเงิน
2207	สมาชิกมียอดเงินคงเหลือสูงสุดแล้ว
2208	จำเป็นต้องมีการยืนยันจากผู้ใช้ปลายทาง
2300	คืนเงินแล้ว
2301	ไม่สามารถคืนเงินได้เนื่องจากผิดกฏหมายหรือสูญหาย เอ็มเอสดีเอ็น

2302	ไม่สามารถคืนเงินได้เนื่องจากไม่มีรหัสข้อความ
2303	เข้าคิวขอเงินคืน
2304	หมดเวลาคืนเงิน
2305	การคืนเงินล้มเหลว
3000	ไม่รองรับการเข้ารหัส GSM
3001	ไม่รองรับการเข้ารหัส UCS2
3002	ไม่รองรับการเข้ารหัสไบนารี
4000	ไม่รองรับรายงานการจัดส่ง
4001	เนื้อหาข้อความไม่ถูกต้อง
4002	อัตราค่าไฟฟ้าไม่ถูกต้อง
4003	ข้อมูลผู้ใช้ไม่ถูกต้อง
4004	ส่วนหัวของข้อมูลผู้ใช้ไม่ถูกต้อง
4005	การเข้ารหัสข้อมูลไม่ถูกต้อง
4006	ภาษีมูลค่าเพิ่มไม่ถูกต้อง
4007	เนื้อหาที่ไม่รองรับสำหรับปลายทาง

เอกสาร / แหล่งข้อมูล

ลิงก์การเคลื่อนย้าย SMS API, SMPP API MS Scheduler API [พีดีเอฟ] คู่มือการใช้งาน SMS API SMPP API MS กำหนดการ API, SMS API SMPP API, MS กำหนดการ API, กำหนดการ API, API

อ้างอิง

• คู่มือการใช้งาน