เอกสารนี้จะอธิบายวิธีนำเสนอหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วให้กับลูกค้าปลายทางของคุณในขั้นตอนการสมัครใช้งานแบบฝังรูปแบบใหม่ หมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วคือหมายเลขโทรศัพท์ธุรกิจที่คุณได้ตรวจสอบยืนยันแล้ว ซึ่งช่วยให้ลูกค้าปลายทางไม่จำเป็นต้องติดต่อคุณเพื่อขอรับรหัสผ่านแบบใช้ครั้งเดียว
โปรดทราบว่าหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วจะแสดงโดยอ็อบเจ็กต์หมายเลขโทรศัพท์ที่ตรวจสอบยืนยันล่วงหน้าแล้วของ WhatsApp Business ซึ่งเป็นแบบชั่วคราว เมื่อลูกค้าปลายทางเลือกหมายเลขใดหมายเลขหนึ่งเหล่านี้ และดำเนินตามขั้นตอนการสมัครใช้งานแบบฝังรูปแบบใหม่เรียบร้อยแล้ว ระบบก็จะแทนที่อ็อบเจ็กต์แบบชั่วคราวนี้ด้วยอ็อบเจ็กต์หมายเลขโทรศัพท์ WhatsApp Business และคุณจะต้องเรียกดู ID ของอ็อบเจ็กต์ใหม่เพื่อที่จะลงทะเบียนหมายเลขโทรศัพท์
verification_expiry_time
ทำตามขั้นตอนเหล่านี้เพื่อสร้างหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้ว แสดงหมายเลขดังกล่าวในการสมัครใช้งานแบบฝัง และลงทะเบียนหลังจากที่ลูกค้าปลายทางได้อ้างสิทธิ์แล้ว
ใช้ตำแหน่งข้อมูลบัญชีธุรกิจ > เพิ่มหมายเลขโทรศัพท์ เพื่อสร้างหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วลงในธุรกิจของคุณ ซึ่งจะเป็นการเพิ่มหมายเลขดังกล่าวไปยังกลุ่มหมายเลขของคุณ
POST /<BUSINESS_ACCOUNT_ID>/add_phone_numbers ?phone_number=<PHONE_NUMBER>
เมื่อดำเนินการสำเร็จ API จะส่งคืน ID หมายเลขโทรศัพท์ที่ตรวจสอบยืนยันล่วงหน้าแล้วของ WhatsApp Business ให้บันทึกค่านี้ไว้เพื่อใช้ในคำขอถัดไป
{ "id": "<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER_ID>" }
curl -X POST 'https://graph.facebook.com/v20.0
/506914307656634/add_phone_numbers?phone_number=15550783881' \
-H 'Authorization: Bearer EAAJB...'
{ "id": "106540352242922" }
โปรดดูรูปแบบหมายเลขโทรศัพท์และพารามิเตอร์การสืบค้นที่รองรับที่ข้อมูลอ้างอิงเกี่ยวกับตำแหน่งข้อมูลบัญชีธุรกิจ > เพิ่มหมายเลขโทรศัพท์
ใช้ตำแหน่งข้อมูลหมายเลขโทรศัพท์ที่ตรวจสอบยืนยันล่วงหน้าแล้วของ WhatsApp Business > ขอรหัส เพื่อขอรหัสผ่านแบบใช้ครั้งเดียวผ่านทาง SMS หรือทางเสียงสำหรับหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วที่เพิ่งสร้างขึ้น
POST /<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER_ID>/request_code ?code_method=<CODE_METHOD> &language=<LANGUAGE>
เมื่อดำเนินการสำเร็จ API จะส่งคืน true
{ "success": <SUCCESS> }
นอกจากนี้ เราจะส่งข้อความ SMS หรือข้อความเสียงที่มีรหัสผ่านแบบใช้ครั้งเดียวไปยังหมายเลขโทรศัพท์นั้นๆ ให้บันทึกรหัสผ่านแบบใช้ครั้งเดียวไว้เพื่อใช้ในคำขอถัดไป
WhatsApp code <CODE>
ทำซ้ำ 3 ครั้ง
Verification code is <CODE>
curl -X POST 'https://graph.facebook.com/v20.0
/106540352242922/request_code?code_method=SMS&language=en_US' \
-H 'Authorization: Bearer EAAJB...'
{ "success": true }
WhatsApp code 123-456
ทำซ้ำ 3 ครั้ง
Verification code is 123456
โปรดดูเมธอดของรหัส รวมถึงภาษาและพารามิเตอร์การสืบค้นที่รองรับที่ข้อมูลอ้างอิงเกี่ยวกับตำแหน่งข้อมูลหมายเลขโทรศัพท์ที่ตรวจสอบยืนยันล่วงหน้าแล้วของ WhatsApp Business > ขอรหัส
ใช้ตำแหน่งข้อมูลหมายเลขโทรศัพท์ที่ตรวจสอบยืนยันล่วงหน้าแล้วของ WhatsApp Business > ตรวจสอบยืนยันรหัส เพื่อตรวจสอบยืนยันหมายเลขโทรศัพท์ธุรกิจโดยใช้รหัสผ่านแบบใช้ครั้งเดียวของหมายเลขนั้น
POST /<WHATSAPP_BUSINESS_PRE_VERIFIED_PHONE_NUMBER_ID>/verify_code ?code=<CODE>
เมื่อดำเนินการสำเร็จ API จะส่งคืนค่า true
และหมายเลขโทรศัพท์ธุรกิจจะมีการตั้งค่า code_verification_status
เป็น VERIFIED
เป็นเวลา 90 วัน
{ "success": <SUCCESS> }
curl -X POST 'https://graph.facebook.com/v20.0
/106540352242922/verify_code?code=123456' \
-H 'Authorization: Bearer EAAJB...'
{ "success": true }
โปรดดูพารามิเตอร์การสืบค้นที่รองรับที่ข้อมูลอ้างอิงเกี่ยวกับตำแหน่งข้อมูลหมายเลขโทรศัพท์ที่ตรวจสอบยืนยันล่วงหน้าแล้วของ WhatsApp Business > ตรวจสอบยืนยันรหัส
เมื่อคุณมีหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วซึ่งมีสถานะเป็น "ตรวจสอบยืนยันแล้ว" (หรือชุดหมายเลขดังกล่าว) ให้แสดงหมายเลขเหล่านั้นในขั้นตอนการสมัครใช้งานแบบฝังรูปแบบใหม่
คุณสามารถแสดงหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วในขั้นตอนการสมัครใช้งานแบบฝังรูปแบบใหม่ผ่านข้อมูลแบบฟอร์มที่ป้อนล่วงหน้า ซึ่งทำได้โดยเพิ่มอ็อบเจ็กต์ preVerifiedPhone
พร้อมคุณสมบัติ ids
ลงในอ็อบเจ็กต์ setup
และกำหนด ID ของหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วของคุณเป็นอาร์เรย์สตริงไปยังคุณสมบัติ ids
ดังนี้
{ scope: '<SCOPE>', extras: { feature: '<FEATURE>', setup: { preVerifiedPhone: { ids: [<IDS>] } } } }
ตัวอย่างเช่น:
{ scope: 'business_management,whatsapp_business_management', extras: { feature: 'whatsapp_embedded_signup', version: 2, setup: { business: { name: 'Acme Inc.', email: 'johndoe@acme.com', phone: { code: 1, number: '6505551234' }, website: 'https://www.acme.com', address: { streetAddress1: '1 Acme Way', city: 'Acme Town', state: 'CA', zipPostal: '94000', country: 'US' }, timezone: 'UTC-08:00' }, phone: { displayName: 'Acme Inc.', category: 'ENTERTAIN', description: 'Gears and widgets' }, preVerifiedPhone: { ids: ['106540352242922','105954558954427'] } } } }
โปรดทราบว่า หากไม่มีการอ้างสิทธิ์ในหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วที่มีสถานะเป็น VERIFIED
ภายใน 90 วันนับตั้งแต่ตรวจสอบยืนยัน ระบบจะตั้งค่าสถานะของหมายเลขนั้นเป็น UNVERIFIED
แต่จะยังคงปรากฏในขั้นตอนการสมัครใช้งานแบบฝังรูปแบบใหม่ หากลูกค้าปลายทางพยายามอ้างสิทธิ์ในหมายเลขที่ยังไม่ได้ตรวจสอบยืนยัน ลูกค้าจะต้องตรวจสอบยืนยันให้แล้วเสร็จด้วยตนเอง ซึ่งหมายความว่าลูกค้าจะต้องขอรหัสผ่านแบบใช้ครั้งเดียวจากคุณ
เพื่อป้องกันไม่ให้ผู้ใช้ได้รับประสบการณ์ที่ไม่ดีเช่นนี้ เราขอแนะนำให้คุณคอยติดตามดูเวลาที่ตรวจสอบยืนยันหมายเลขเอาไว้ และตรวจสอบยืนยันหมายเลขอีกครั้งก่อนที่สถานะจะเปลี่ยนกลับเป็นยังไม่ได้ตรวจสอบยืนยัน
หากไม่แน่ใจว่าคุณตรวจสอบยืนยันหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วครั้งล่าสุดเมื่อใด ให้สืบค้นตำแหน่งข้อมูลหมายเลขโทรศัพที่ตรวจสอบยืนยันล่วงหน้าแล้วของ WhatsApp Business แล้วดูที่ช่อง code_verification_time
และ verification_expiry_time
ซึ่งจะระบุเวลาที่ตรวจสอบยืนยันล่าสุดและเวลาหมดอายุของการตรวจสอบยืนยัน
ส่งคำขอ GET ไปที่ตำแหน่งข้อมูลบัญชี WhatsApp Business > หมายเลขโทรศัพท์ ซึ่งจะส่งคืนหมายเลขโทรศัพท์ WhatsApp Business ทั้งหมดในบัญชี WhatsApp Business
แยกวิเคราะห์คุณสมบัติ display_phone_number
ในแต่ละอ็อบเจ็กต์ที่ส่งคืนมาในชุดผลลัพธ์ หากอ็อบเจ็กต์มีหมายเลขโทรศัพท์ที่แสดง (เช่น 16505551234
) เป็นค่า display_phone_number
แสดงว่ามีการอ้างสิทธิ์ในหมายเลขนั้นแล้ว คัดลอกค่าคุณสมบัติ id
ของอ็อบเจ็กต์เนื่องจากเป็น ID สำหรับอ็อบเจ็กต์หมายเลขโทรศัพท์ WhatsApp Business ใหม่ ซึ่งในตอนนี้จะแสดงถึงหมายเลขนี้ (ID เก่าจะใช้ไม่ได้อีกต่อไป)
อีกทางเลือกหนึ่งก็คือ คุณสามารถใช้ตำแหน่งข้อมูลเดียวกันนี้พร้อมการขยายเงื่อนไขใน field
เพื่อส่งคำขอช่อง display_phone_number
และระบุหมายเลขโทรศัพท์ที่แสดงได้ ตัวอย่างเช่น:
GET /102290129340398/phone_numbers?display_phone_number=16505551234
หากการดำเนินการนี้ส่งคืนอ็อบเจ็กต์หมายเลขโทรศัพท์ WhatsApp Business พร้อมหมายเลขโทรศัพท์ที่แสดงดังกล่าว แสดงว่าหมายเลขนั้นมีการอ้างสิทธิ์แล้ว และคุณควรคัดลอก id
ของอ็อบเจ็กต์
ใช้ตำแหน่งข้อมูลบัญชีธุรกิจ > หมายเลขที่ตรวจสอบยืนยันล่วงหน้าแล้ว เพื่อเรียกดูรายการอ็อบเจ็กต์หมายเลขโทรศัพท์ที่ตรวจสอบยืนยันล่วงหน้าแล้วของ WhatsApp Business ทั้งหมด (ไม่ว่าจะมีสถานะการตรวจสอบยืนยันเช่นใด) ในกลุ่มหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วสำหรับบัญชีธุรกิจของคุณดังนี้
GET /<BUSINESS_ACCOUNT_ID>/preverified_numbers
ระบบจะเรียงผลลัพธ์ตามลำดับเวลาที่สร้างขึ้นโดยอัตโนมัติ นอกจากนี้ คุณสามารถใช้การขยายเงื่อนไขในช่องเพื่อส่งคำขอช่อง code_verification_status
ได้ เพื่อให้ API ส่งคืนเฉพาะหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วพร้อมสถานะการตรวจสอบยืนยันตามที่ระบุไว้ ดังนี้
GET /<BUSINESS_ACCOUNT_ID>/preverified_numbers?code_verification_status=VERIFIED
ส่งคำขอ POST ไปที่ตำแหน่งข้อมูลธุรกิจ > แชร์หมายเลขที่ตรวจสอบยืนยันล่วงหน้าแล้ว เพื่อแชร์หมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วกับพาร์ทเนอร์ธุรกิจ หรือส่งคำขอ DELETE ไปที่ตำแหน่งข้อมูลเดียวกันนี้เพื่อยกเลิกการแชร์
พาร์ทเนอร์ธุรกิจสามารถแสดงหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วที่แชร์ได้ในขั้นตอนการสมัครใช้งานแบบฝัง
หากคุณแชร์หมายเลขกับพาร์ทเนอร์ธุรกิจหลายราย เราขอแนะนำให้คุณแนะนำให้พาร์ทเนอร์ของคุณดูรายการหมายเลขที่ตรวจสอบยืนยันล่วงหน้าแล้วที่มีการแชร์ก่อนที่จะแสดงหมายเลขเหล่านี้ในการสมัครใช้งานแบบฝัง วิธีนี้จะช่วยลดโอกาสที่พาร์ทเนอร์จะพยายามแสดงหมายเลขที่ได้รับการอ้างสิทธิ์ไปแล้ว (หมายเลขที่อ้างสิทธิ์แล้วจะไม่ปรากฏในขั้นตอน แต่พาร์ทเนอร์อาจไม่ทราบและสงสัยว่าทำไมหมายเลขนี้จึงไม่ปรากฏ)
POST /<BUSINESS_ID>/share_preverified_numbers ?partner_business_id=<PARTNER_BUSINESS_ID> &preverified_id=<PREVERIFIED_ID>
DELETE /<BUSINESS_ID>/share_preverified_numbers ?partner_business_id=<PARTNER_BUSINESS_ID> &preverified_id=<PREVERIFIED_ID>
เมื่อดำเนินการสำเร็จ API จะส่งคืนค่า true หากต้องการแชร์ ให้แจ้งพาร์ทเนอร์ธุรกิจของคุณให้ทราบถึงหมายเลขที่ตรวจสอบยืนยันแล้วที่แชร์ล่าสุด พร้อมทั้งแจ้ง ID ของหมายเลขนั้น หากยกเลิกการแชร์ หมายเลขดังกล่าวจะไม่ปรากฏในการใช้งานการสมัครใช้งานแบบฝังของพาร์ทเนอร์อีกต่อไป
{ "success": <SUCCESS> }
curl -X POST 'https://graph.facebook.com/v17.0/share_preverified_numbers?partner_business_id=506914307656634&preverified_id=1706193509821738' \ -H 'Authorization: Bearer EAAH0...'
curl -X DELETE 'https://graph.facebook.com/v17.0/share_preverified_numbers?partner_business_id=506914307656634&preverified_id=1706193509821738' \ -H 'Authorization: Bearer EAAH0...'
{ "success": true }
คุณสามารถข้ามการเลือกหมายเลขโทรศัพท์ที่มีการสมัครใช้งานแบบฝังได้ทั้งหมด และลงทะเบียนหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าในบัญชี WhatsApp Business ของลูกค้าปลายทางที่เริ่มต้นใช้งานโดยใช้โปรแกรม ให้ทำตามขั้นตอนในเอกสาร "ลงทะเบียนหมายเลขโทรศัพท์" แต่ให้ใช้ ID ของหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้วในขั้นตอนที่ 1 จากนั้นให้ข้ามไปที่ขั้นตอนที่ 4
ใช้คำขอนี้เพื่อสร้างหมายเลขโทรศัพท์ WhatsApp Business บนบัญชี WhatsApp Business โดยใช้ ID ของหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้ว โดยขั้นตอนที่จะแทนที่ขั้นตอนที่ 1
POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/phone_numbers
{ "preverified_id": "<PREVERIFIED_ID>", "country_dial_code": "<COUNTRY_DIAL_CODE>", "display_phone_number": "<DISPLAY_PHONE_NUMBER>", "verified_name": "<VERIFIED_NAME>" }
ตัวยึดตำแหน่ง | คำอธิบาย | ค่าตัวอย่าง |
---|---|---|
สตริง | จำเป็นต้องระบุ ID ของหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้ว |
|
สตริง | จำเป็นต้องระบุ รหัสการโทรของประเทศของหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้ว |
|
สตริง | จำเป็นต้องระบุ หมายเลขโทรศัพท์ที่แสดงของหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้ว |
|
สตริง | จำเป็นต้องระบุ ชื่อที่แสดงของหมายเลขโทรศัพท์ธุรกิจที่ตรวจสอบยืนยันล่วงหน้าแล้ว |
|
เมื่อดำเนินการสำเร็จ API จะตอบกลับด้วย ID ของหมายเลขโทรศัพท์ WhatsApp Business ใช้ ID นี้เพื่อลงทะเบียนหมายเลข (ขั้นตอนที่ 4 ในเอกสาร "ลงทะเบียนหมายเลขโทรศัพท์")
{ "id": "<ID>" }
ตัวยึดตำแหน่ง | คำอธิบาย | ค่าตัวอย่าง |
---|---|---|
| ID ของหมายเลขโทรศัพท์ทางธุรกิจของ WhatsApp อ็อบเจ็กต์นี้ได้เข้ามาแทนที่อ็อบเจ็กต์หมายเลขโทรศัพท์ที่ตรวจสอบยืนยันล่วงหน้าแล้วของ WhatsApp Business แล้ว |
|
curl 'https://graph.facebook.com/v20.0
/506914307656634/phone_numbers' \
-H 'Content-Type: text/plain' \
-H 'Authorization: Bearer EAAH7...' \
-d '
{
"preverified_id": "6635066806614622",
"country_dial_code": "1",
"display_phone_number": "5550783881",
"verified_name": "Lucky Shrub"
}'
{ "id": "108692048990658" }