Cloud API

แพลตฟอร์ม WhatsApp Business > API ระบบคลาวด์ > ข้อมูลอ้างอิง

การลงทะเบียน

หากต้องการใช้หมายเลขโทรศัพท์ธุรกิจร่วมกับ Cloud API คุณจะต้องลงทะเบียนหมายเลขดังกล่าว ลงทะเบียนหมายเลขโทรศัพท์ธุรกิจในกรณีต่อไปนี้

  • การสร้างบัญชี: เมื่อคุณใช้ API นี้ คุณจำเป็นต้องลงทะเบียนหมายเลขโทรศัพท์ธุรกิจที่คุณต้องการใช้ส่งข้อความ เรากำหนดให้ต้องตั้งค่าการตรวจสอบยืนยันสองขั้นตอนขณะสร้างบัญชี เพื่อเสริมการรักษาความปลอดภัยของบัญชีให้รัดกุมขึ้นอีกชั้น
  • การเปลี่ยนชื่อ: ในกรณีนี้ โทรศัพท์ของคุณได้รับการลงทะเบียนแล้ว และคุณต้องการเปลี่ยนชื่อที่แสดง ในการดำเนินการดังกล่าว คุณจะต้องยื่นขอเปลี่ยนชื่อบนตัวจัดการ WhatsApp เสียก่อน เมื่อชื่อได้รับอนุมัติแล้ว คุณจำเป็นต้องลงทะเบียนโทรศัพท์ของคุณอีกครั้งโดยใช้ชื่อใหม่
  • การย้ายหมายเลขของคุณจาก On-Premises API ไปเป็น Cloud API โปรดดูข้อยกเว้นในการย้าย

คุณจะต้องตรวจสอบยืนยันความเป็นเจ้าของก่อนจึงจะลงทะเบียนหมายเลขโทรศัพท์ธุรกิจได้

ข้อยกเว้นในการย้าย

หากคุณกำลังย้ายหมายเลขโทรศัพท์จาก API ภายในองค์กรไปยัง API ระบบคลาวด์ จะมีขั้นตอนเพิ่มเติมที่คุณต้องดำเนินการก่อนที่จะลงทะเบียนหมายเลขโทรศัพท์ด้วย API ระบบคลาวด์ โปรดดูกระบวนการที่ครบถ้วนสมบูรณ์ได้ที่ย้ายระหว่าง API ระบบคลาวด์กับภายในองค์กร

ลงทะเบียนหมายเลขโทรศัพท์ธุรกิจ

หากต้องการลงทะเบียนหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันแล้ว ให้ส่งคำขอ POST ไปยัง PHONE_NUMBER_ID/register ระบุพารามิเตอร์ตามรายการด้านล่าง

ตำแหน่งข้อมูลการยืนยันตัวตน

PHONE_NUMBER_ID/register

(โปรดดูที่ เรียกดู ID หมายเลขโทรศัพท์)

Solution Partners must authenticate themselves with an access token with the whatsapp_business_management permission.

ข้อจำกัด

คำขอที่ส่งไปยังตำแหน่งข้อมูลการลงทะเบียนจำกัดไว้ที่คำขอ 10 รายการต่อหมายเลขทางธุรกิจภายในช่วงระยะเวลา 72 ชั่วโมง

เมื่อคุณส่งคำขอลงทะเบียน เราจะตรวจสอบจำนวนคำขอลงทะเบียนที่คุณได้ดำเนินการเพื่อลงทะเบียนหมายเลขนั้นในระยะเวลา 72 ชั่วโมงล่าสุด หากคุณได้ส่งคำขอไปแล้ว 10 รายการ API จะส่งรหัสข้อผิดพลาด 133016 กลับมาให้ และหมายเลขดังกล่าวจะถูกปิดกั้นไม่ให้ลงทะเบียนภายในระยะเวลา 72 ชั่วโมงต่อจากนี้

พารามิเตอร์

ชื่อคำอธิบาย

messaging_product

ต้องระบุ

ใช้บริการส่งข้อความ ตั้งค่าส่วนนี้เป็น "whatsapp"

pin

ต้องระบุ

หากหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันแล้วได้เปิดใช้งานการตรวจสอบยืนยันสองขั้นตอนไว้แล้ว ให้ตั้งค่านี้เป็น PIN การตรวจสอบยืนยันสองขั้นตอน 6 หลักของหมายเลขนั้น แต่หากคุณจำ PIN ไม่ได้ คุณก็สามารถอัพเดต PIN ได้


หากหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันแล้วยังไม่ได้เปิดใช้งานการตรวจสอบยืนยันสองขั้นตอนไว้ ให้ตั้งค่านี้เป็นหมายเลข 6 หลัก ส่วนนี้จะเป็น PIN การตรวจสอบยืนยันสองขั้นตอนของหมายเลขโทรศัพท์ธุรกิจที่เพิ่งตรวจสอบยืนยัน

data_localization_region

ระบุหรือไม่ก็ได้


หากระบุ ให้เปิดใช้พื้นที่เก็บข้อมูลในเครื่องกับหมายเลขโทรศัพท์ธุรกิจนั้น ค่าต้องเป็นรหัสประเทศ 2 ตัวอักษรตามมาตรฐาน ISO 3166 (เช่น IN) ซึ่งระบุประเทศที่คุณต้องการจัดเก็บข้อมูลสำหรับเก็บไว้ในองค์กร


ค่าที่รองรับ ได้แก่


APAC

  • ออสเตรเลีย: AU
  • อินโดนีเซีย: ID
  • อินเดีย: IN
  • ญี่ปุ่น: JP
  • สิงคโปร์: SG
  • เกาหลีใต้: KR

ยุโรป

  • สหภาพยุโรป (เยอรมนี): DE
  • สวิตเซอร์แลนด์: CH
  • สหราชอาณาจักร: GB

LATAM

  • บราซิล: BR

MEA

  • บาห์เรน: BH
  • แอฟริกาใต้: ZA
  • สหรัฐอาหรับเอมิเรตส์: AE

NORAM

  • แคนาดา: CA

เมื่อเปิดใช้งานแล้ว จะไม่สามารถปิดใช้งานหรือเปลี่ยนแปลงโดยตรงได้ แต่คุณจะต้องยกเลิกการลงทะเบียนหมายเลขดังกล่าวและลงทะเบียนอีกครั้งโดยไม่ใช้พารามิเตอร์นี้ (หากต้องการปิดใช้งาน) หรือระบุพารามิเตอร์พร้อมรหัสประเทศใหม่ (หากต้องการเปลี่ยนแปลง)


หากต้องการเปิดใช้งานพื้นที่เก็บข้อมูลในเครื่องกับหมายเลขโทรศัพท์ที่ลงทะเบียนไปแล้ว คุณต้องยกเลิกการลงทะเบียนหมายเลขนั้น แล้วจึงลงทะเบียนใหม่และระบุพารามิเตอร์นี้

ตัวอย่างคำขอที่ไม่ได้ร้องขอพื้นที่เก็บข้อมูลในเครื่อง

curl 'https://graph.facebook.com/v21.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "pin": "212834"
}

ตัวอย่างคำขอที่ร้องขอพื้นที่เก็บข้อมูลในเครื่อง

curl 'https://graph.facebook.com/v21.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "pin": "212834",
  "data_localization_region": "CH"
}

All API calls require authentication with access tokens.

Developers can authenticate their API calls with the access token generated in the App Dashboard > WhatsApp > API Setup.

Solution Partners must authenticate themselves with an access token with the whatsapp_business_messaging and whatsapp_business_management permissions. See System User Access Tokens for information.

ยกเลิกการลงทะเบียนหมายเลขโทรศัพท์ธุรกิจ

การยกเลิกการลงทะเบียนหมายเลขโทรศัพท์ธุรกิจจะทำให้หมายเลขนั้นไม่สามารถใช้กับ Cloud API ได้อีกและจะเป็นการปิดใช้งานพื้นที่เก็บข้อมูลในเครื่องของหมายเลขนั้นด้วย หากเคยเปิดใช้งานเอาไว้

การยกเลิกการลงทะเบียนจะไม่เป็นการลบหมายเลขหรือลบประวัติข้อความแต่อย่างใด หากต้องการลบหมายเลขและประวัติ โปรดดูที่ลบหมายเลขโทรศัพท์จาก WABA

หากต้องการยกเลิกการลงทะเบียนหมายเลขโทรศัพท์ธุรกิจ ให้เรียกใช้ POST ไปยัง PHONE_NUMBER_ID/deregister ดังนี้

ตำแหน่งข้อมูลการยืนยันตัวตน

PHONE_NUMBER_ID/deregister

(โปรดดูที่ เรียกดู ID หมายเลขโทรศัพท์)

Solution Partners must authenticate themselves with an access token with the whatsapp_business_management permission.

ข้อจำกัด

คำขอที่ส่งไปยังตำแหน่งข้อมูลการยกเลิกการลงทะเบียนจำกัดไว้ที่คำขอ 10 รายการต่อหมายเลขทางธุรกิจภายในช่วงระยะเวลา 72 ชั่วโมง

เมื่อคุณส่งคำขอยกเลิกการลงทะเบียน เราจะตรวจสอบจำนวนคำขอยกเลิกการลงทะเบียนที่คุณได้ดำเนินการเพื่อยกเลิกการลงทะเบียนหมายเลขนั้นในระยะเวลา 72 ชั่วโมงล่าสุด หากคุณได้ส่งคำขอไปแล้ว 10 รายการ API จะส่งรหัสข้อผิดพลาด 133016 กลับมาให้ และหมายเลขดังกล่าวจะถูกปิดกั้นไม่ให้ยกเลิกการลงทะเบียนภายในระยะเวลา 72 ชั่วโมงต่อจากนี้

ตัวอย่าง

ตัวอย่างคำขอ:

curl -X POST \  
 'https://graph.facebook.com/v21.0/FROM_PHONE_NUMBER_ID/deregister' \  
 -H 'Authorization: Bearer ACCESS_TOKEN'

การตอบกลับที่สำเร็จจะมีลักษณะดังนี้

{
  "success": true
}

ดูเพิ่มเติม