การย้ายจาก API ระบบคลาวด์ไปยัง API ภายในองค์กร

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

โปรดทราบว่า การย้ายหมายเลขโทรศัพท์ธุรกิจจาก API หนึ่งมาอีก API หนึ่งนั้นต่างจากการย้ายหมายเลขโทรศัพท์จากบัญชี WhatsApp Business (WABA) หนึ่งไปยังอีกบัญชีหนึ่ง

การย้ายจะไม่กระทบกับสิ่งต่อไปนี้

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

อย่างไรก็ตาม เพื่อให้การย้ายเป็นไปอย่างราบรื่น คุณจะต้องทราบความแตกต่างของ API ทุกประเภท และดำเนินการที่เหมาะสมเพื่อจัดการกับความแตกต่างก่อนที่จะดำเนินขั้นตอนการย้ายที่อธิบายไว้ในเอกสารฉบับนี้

หลักปฏิบัติที่ดีที่สุด

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

นอกจากนี้ เราแนะนำให้คุณทำการย้ายเมื่อการรับส่งข้อมูลไปยัง API ภายในองค์กรที่คุณนำมาใช้อยู่ในระดับต่ำ

ความแตกต่างของ API

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

Webhooks

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

โปรดดูเอกสารต่อไปนี้เพื่อช่วยให้เข้าใจความแตกต่างของเพย์โหลด

• การกำหนดค่า: Webhooks สำหรับ WhatsApp
• เพย์โหลด Webhooks ของ API ระบบคลาวด์: เอกสารอ้างอิงเกี่ยวกับเพย์โหลดการแจ้งเตือน Webhooks
• เพย์โหลด Webhook ของ API การจัดการธุรกิจ: การตั้งค่า Webhooks

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

สื่อ

ID สื่อสำหรับสื่อใดก็ตามที่อัพโหลดไปยัง API ระบบคลาวด์จะไม่สามารถนำมาใช้ได้เมื่อส่งข้อความด้วย API ภายในองค์กร ดังนั้นคุณต้องอัพโหลดสื่ออีกครั้งโดยใช้ API ภายในองค์กรเพื่อสร้าง ID สื่อขึ้นมาใหม่หรือใช้ URL สื่อ หากสื่อดังกล่าวได้รับการโฮสต์ไว้บนเซิร์ฟเวอร์สาธารณะ ดูการส่งข้อความสื่อ

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

รหัสข้อผิดพลาดของ API ระบบคลาวด์และ API การจัดการธุรกิจแตกต่างจากรหัสข้อผิดพลาดของ API ภายในองค์กร โปรดดูเอกสารต่อไปนี้:

• รหัสข้อผิดพลาดของ API ระบบคลาวด์
• รหัสข้อผิดพลาดของ API การจัดการธุรกิจ

ข้อความแบบกดเพื่อพูดคุย

API ภายในองค์กรจะระบุข้อความแบบกดเพื่อพูดคุย (PTT) ใน Webhooks ด้วยการตั้งค่า messages.type เป็น voice แต่ API ระบบคลาวด์จะระบุข้อความ PTT ด้วยการตั้งค่า messages.audio.voice เป็น true

เวลาหยุดทำงาน

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

เราแนะนำอย่างยิ่งให้คุณกำหนดเวลาการย้ายเป็นช่วงเวลาที่มีกิจกรรมน้อย ทั้งนี้เพื่อลดผลกระทบจากเวลาหยุดทำงาน

ขั้นตอนที่ 1: ผสานการทำงาน API ภายในองค์กร

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

ขั้นตอนที่ 2: เตรียมพร้อมสำหรับการย้าย

เราขอแนะนำให้คุณหยุดส่งข้อความขณะที่ดำเนินการย้าย

ไคลเอ็นต์ภายในองค์กรของ WhatsApp Business API มีข้อกำหนดของเครือข่ายบางอย่างในการเชื่อมต่อกับเซิร์ฟเวอร์ WhatsApp หากต้องการให้แน่ใจว่าคุณพร้อมแล้ว ให้ดูตั้งค่าและแก้ไขจุดบกพร่องของเครือข่ายของคุณ

ขั้นตอนที่ 3: ลงทะเบียนไคลเอ็นต์ API

ลงทะเบียนหมายเลขโทรศัพท์ธุรกิจบนไคลเอ็นต์ API ภายในองค์กรของคุณ ซึ่งทำได้โดยเรียกใช้ตำแหน่งข้อมูล /account ดังนี้

POST /v1/account

{
    "cc": "COUNTRY_CODE",
    "phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
    "method": "sms" or "voice",
    "cert": "VERIFIED_NAME_CERT_IN_BASE64",
    "pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}

โปรดดูช่องทั้งหมดที่ใช้งานได้สำหรับตำแหน่งข้อมูลนี้ที่นี่

เมื่อลงทะเบียนเรียบร้อยแล้ว ไคลเอ็นต์ API ภายในองค์กรจะเป็นไคลเอ็นต์ที่ได้รับข้อความ

ขั้นตอนที่ 4: ตั้งค่าชาร์ด

เมื่อลงทะเบียนไคลเอ็นต์แล้ว คุณจะสามารถตั้งค่าชาร์ดได้หากจำเป็น

ขั้นตอนที่ 5: เริ่มส่งข้อความ

คุณพร้อมจะส่งข้อความให้ลูกค้าแล้ว โปรดดูคำแนะนำจากคู่มือส่งข้อความ