จัดการหมายเลขโทรศัพท์และใบรับรอง

คู่มือนี้จะให้ข้อมูลภาพรวมเกี่ยวกับหมายเลขโทรศัพท์สำหรับพาร์ทเนอร์โซลูชั่นและลูกค้า นอกจากนี้คู่มือนี้ยังมีข้อมูลกระบวนการสำหรับพาร์ทเนอร์โซลูชั่นในกรณีที่ต้องจัดการหมายเลขโทรศัพท์และใบรับรองของลูกค้าด้วย

ข้อมูลเบื้องต้นเกี่ยวกับหมายเลขโทรศัพท์

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

ธุรกิจต้องมีหมายเลขเฉพาะเพื่อใช้ WhatsApp ผ่านการสมัครใช้งานแบบฝัง หากธุรกิจมีหมายเลขที่ลงทะเบียนไว้ในแอพ WhatsApp Messenger หรือ WhatsApp Business ก็จะไม่สามารถใช้หมายเลขโทรศัพท์เดียวกันได้

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

โปรดดูข้อมูลเพิ่มเติมโดยละเอียดเกี่ยวกับหมายเลขโทรศัพท์และแพลตฟอร์ม WhatsApp Business ที่หมายเลขโทรศัพท์

โปรดดูข้อมูลเกี่ยวกับวิธีย้ายหมายเลขโทรศัพท์ WhatsApp ที่ลงทะเบียนไว้อยู่แล้วที่ย้ายหมายเลขโทรศัพท์

คำแนะนำสำหรับลูกค้า

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

เพิ่มหมายเลขโทรศัพท์ลงในบัญชี WhatsApp Business

การเพิ่มหมายเลขเพิ่มเติมลงในบัญชี WhatsApp Business (WABA) มี 2 วิธี ดังนี้:

1. [แนะนำ] ทำตามขั้นตอนการสมัครใช้งานแบบฝังอีกครั้ง โดยให้เลือกตัวจัดการธุรกิจและ WABA ที่มีอยู่ เพิ่มหมายเลข แล้วตรวจสอบยืนยันหมายเลขดังกล่าว
2. ในตัวจัดการธุรกิจ ให้ไปที่แท็บ "หมายเลขโทรศัพท์" ของตัวจัดการ WhatsApp แล้วเลือก "เพิ่มหมายเลขโทรศัพท์" เมื่อใช้ตัวเลือกนี้ พาร์ทเนอร์โซลูชั่นจะต้องตรวจสอบยืนยันหมายเลขโทรศัพท์ด้วยตนเอง เนื่องจากไม่มีการตรวจสอบยืนยันทางโทรศัพท์ในตัวจัดการธุรกิจ ด้วยเหตุนี้ เราจึงขอแนะนำให้ธุรกิจทำตามขั้นตอนการสมัครใช้งานแบบฝังเพื่อเพิ่มหมายเลขเพิ่มเติม

คำแนะนำสำหรับพาร์ทเนอร์โซลูชั่น

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

ลงทะเบียนหมายเลขโทรศัพท์สำหรับ Cloud API

หลังจากการตรวจสอบยืนยันหมายเลขโทรศัพท์จากขั้นตอนการสมัครใช้งานแบบฝังสำเร็จแล้ว คุณควรเรียกใช้ API ไปยังตำแหน่งข้อมูล register เพื่อให้ลงทะเบียนได้สำเร็จ ในการดำเนินการนี้ ให้ระบุ code_method (sms | voice) เนื่องจากหมายเลขโทรศัพท์ได้รับการตรวจสอบยืนยันแล้ว คุณจึงไม่ต้องกังวลเกี่ยวกับรหัสการลงทะเบียนอีก ทั้งนี้ คุณไม่จำเป็นต้องเรียกใช้ API verify

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

ลงทะเบียนหมายเลขโทรศัพท์สำหรับ On-Premise

หลังจากการตรวจสอบยืนยันหมายเลขโทรศัพท์จากขั้นตอนการสมัครใช้งานแบบฝังสำเร็จแล้ว คุณควรเรียกใช้ API ไปยังตำแหน่งข้อมูล account เพื่อให้ลงทะเบียนได้สำเร็จ ในการดำเนินการนี้ ให้ระบุ code_method (sms | voice) เนื่องจากหมายเลขโทรศัพท์ได้รับการตรวจสอบยืนยันแล้ว คุณจึงไม่ต้องกังวลเกี่ยวกับรหัสการลงทะเบียนอีก ทั้งนี้ คุณไม่จำเป็นต้องเรียกใช้ API verify

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

ดึงข้อมูลสถานะของโทรศัพท์และใบรับรอง

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

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

ในตัวอย่างต่อไปนี้ ให้ใช้ ID สำหรับ WABA ที่กำหนด

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?fields=
    display_phone_number,
    certificate,
    name_status,
    new_certificate,
    new_name_status
  &access_token={system-user-access-token}"

ตัวอย่างการตอบกลับ

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "last_onboarded_time": "2023-08-22T19:05:53+0000",
      "certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
      "new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
      "name_status": "APPROVED",
      "new_name_status": "APPROVED",
    }
  ]
}

พารามิเตอร์การตอบกลับ

ดึงข้อมูลสถานะรหัส OTP ของโทรศัพท์

หากต้องการดูว่าหมายเลขโทรศัพท์ได้รับการตรวจสอบยืนยันผ่านรหัส OTP (รหัสผ่านแบบใช้ครั้งเดียว) หรือไม่ ให้ดูที่ช่อง code_verification_status ของหมายเลขนั้น โดยก่อนอื่นให้เรียกใช้ GET ไปยังตำแหน่งข้อมูล /{whatsapp-business-account-id}/phone_numbers ดังนี้

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?access_token={your-access-token}"

การตอบกลับจะมี code_verification_status พร้อมด้วยตัวเลือก VERIFIED หรือ NOT_VERIFIED อย่างใดอย่างหนึ่ง ตัวอย่างการตอบกลับจะมีลักษณะดังนี้

[
  {
    "code_verification_status": "NOT_VERIFIED",
    "id": "1754951608042154"
  }
]

หรือคุณสามารถดึงข้อมูลสถานะได้โดยเรียกใช้ ID ของหมายเลขโทรศัพท์ดังนี้

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{phone-number-id}
  ?access_token={your-access-token}"

กรองหมายเลขโทรศัพท์ตามโหมดบัญชี

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

พารามิเตอร์คำขอ

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

ในตัวอย่างต่อไปนี้ ให้ใช้ ID สำหรับ WABA ที่กำหนด

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?filtering=[{
    "field":"account_mode",
    "operator":"EQUAL",
    "value":"SANDBOX"}]
  &access_token={system-user-access-token}"

ตัวอย่างการตอบกลับ

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "verified_name": "John’s Cake Shop",
      "quality_rating": "UNKNOWN",
    }
  ],
  "paging": {
	"cursors": {
		"before": "abcdefghij"
		"after": "klmnopqr"
	}
   }
}

เรียนรู้เพิ่มเติม

• หมายเลขโทรศัพท์: ภาพรวมของแพลตฟอร์ม WhatsApp สำหรับธุรกิจ
• หมายเลขโทรศัพท์: ย้ายหมายเลขที่ลงทะเบียนไว้อยู่แล้ว
• ข้อมูลอ้างอิง: บัญชี WhatsApp Business