ชื่อผู้ส่ง

ชื่อผู้ส่งคือชื่อที่ผู้รับเห็นเป็นต้นทางของข้อความ ผู้ให้บริการกำหนดให้ต้องลงทะเบียนและ ได้รับอนุมัติก่อนจึงจะส่งได้ การลงทะเบียนจึงเป็นการยื่นเอกสาร KYC ไม่ใช่แค่ตั้งชื่อ

ทุก route อยู่ในขอบเขตองค์กร และยืนยันตัวตนคนละแบบกับ API ฝั่งส่งข้อความ คือใช้ token ของผู้ใช้ที่ล็อกอินอยู่ ไม่ใช่ API key — ถ้าส่ง API-Key มาจะถูกปฏิเสธด้วย 401 เพราะ route กลุ่มนี้ตรวจสิทธิ์จากการเป็นสมาชิกของ {organizationId} ซึ่งอ่านจาก path จึงไม่ต้องส่ง X-TenantID ด้วย

การทำงาน	Route
ดูรายการ	`GET /organization/{organizationId}/sender-names`
ตรวจสอบว่าว่างหรือไม่	`GET /organization/{organizationId}/sender-names/availability`
ลงทะเบียน	`POST /organization/{organizationId}/sender-names`
แก้ไขเอกสาร	`PUT /organization/{organizationId}/sender-names/{documentId}`
ลบ	`DELETE /organization/{organizationId}/sender-names/{documentId}`

ตรวจสอบก่อนว่าชื่อว่างหรือไม่

bash

curl "$ME_BASE/organization/$ME_TENANT/sender-names/availability?sender_name=MyBrand" \
  -H "Authorization: Bearer $ME_ACCESS_TOKEN"

ลงทะเบียน

การลงทะเบียนคือการยื่น KYC เพราะผู้ให้บริการต้องรู้ว่าใครอยู่เบื้องหลังชื่อนั้น ไม่ใช่แค่ชื่ออะไร

bash

curl -X POST "$ME_BASE/organization/$ME_TENANT/sender-names" \
  -H "Authorization: Bearer $ME_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "sender_name": "MyBrand",
        "usage_type": "Transactional",
        "business_name": "My Company Co., Ltd.",
        "contact_person": "มาลี สุขใจ",
        "country": "TH",
        "email": "ops@example.com",
        "name": "มาลี สุขใจ",
        "nationality": "TH",
        "phone_number": "+66886578553",
        "purpose": "แจ้งสถานะคำสั่งซื้อและการจัดส่ง",
        "company_registration_certificate": "https://…/cert.pdf",
        "brand_ownership_proof": "https://…/trademark.pdf"
      }'

การแก้ไข

PUT เป็นการแก้ไขเอกสารแบบบางส่วน มีสี่ฟิลด์ที่แก้ไม่ได้โดยตั้งใจ

ฟิลด์	เหตุผล
`sender_name`	เปลี่ยนชื่อต้องผ่าน KYC ใหม่
`obj_status`	ระบบกำหนด เป็นผลการพิจารณา
`is_active`	ระบบกำหนด
`approved_operators`	กำหนดโดยผู้ให้บริการที่อนุมัติชื่อนั้น

หากต้องการเปลี่ยนชื่อ ให้ลงทะเบียนชื่อใหม่

การอนุมัติแยกตามผู้ให้บริการ

approved_operators คือรายชื่อผู้ให้บริการที่อนุมัติชื่อนี้แล้ว การส่งด้วยชื่อที่ยังไม่ได้รับอนุมัติ สำหรับผู้ให้บริการปลายทางจะไม่ทำให้ทั้งคำขอล้มเหลว แต่ผู้รับเหล่านั้นจะถูกนับใน rejected ดู การส่ง SMS

ชื่อผู้ส่ง ​

ตรวจสอบก่อนว่าชื่อว่างหรือไม่ ​

ลงทะเบียน ​

การแก้ไข ​

ชื่อผู้ส่ง

ตรวจสอบก่อนว่าชื่อว่างหรือไม่

ลงทะเบียน

การแก้ไข