เริ่มต้นใช้งานสำหรับพาร์ทเนอร์โซลูชั่น

คู่มือนี้อธิบายขั้นตอนที่พาร์ทเนอร์โซลูชั่นต้องดำเนินการเพื่อนำเสนอ Cloud API ให้แก่ลูกค้า ขั้นตอนหลักมี 4 ขั้นตอน ดังนี้

1. เตรียมการและวางแผน
2. ตั้งค่าองค์ประกอบ
3. ลงนามในสัญญา
4. สร้างการผสานการทำงาน

หลังจากที่คุณดำเนินการเสร็จสิ้น โปรดติดตามการอัพเดตรายเดือน

เตรียมการและวางแผน

อ่านเอกสารประกอบ

ก่อนที่คุณจะเริ่มต้น เราขอแนะนำให้อ่านข้อมูลจากเอกสารประกอบสำหรับผู้พัฒนาและคอลเลกชั่น Postman ของเรา ซึ่งจะช่วยให้คุณเข้าใจวิธีการทำงานของ Cloud API รวมถึงวิธีเริ่มต้นใช้งานและย้ายหมายเลข

วางแผนการเริ่มต้นใช้งานและการย้าย

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

ถัดไป คำนึงว่าคุณต้องการย้ายลูกค้ารายใดไปยัง Cloud API เป็นอันดับแรก โดยทั่วไป เราแนะนำว่าให้ย้ายลูกค้าทุกรายจาก On-Premises API ไปยัง Cloud API แต่ความต้องการของลูกค้าแต่ละรายอาจแตกต่างกันไป เมื่อคุณคำนึงว่าจะย้ายลูกค้ารายใด ให้พิจารณารายการต่อไปนี้

เมื่อคุณรู้ว่ากำลังจะย้ายใคร คุณสามารถสร้างแผนและไทม์ไลน์การย้ายได้

เมื่อคุณสร้างแผน พึงจำไว้ว่าให้ออกแบบระบบสำหรับ 2 สถานการณ์ ได้แก่ การช่วยลูกค้าในการเริ่มต้นใช้งานและการย้ายลูกค้าปัจจุบันจาก On-Premises API ไปยัง Cloud API สำหรับสถานการณ์การย้าย ให้รวมแผนการสำรองอินสแตนซ์ภายในองค์กรปัจจุบันและย้ายหมายเลขเหล่านั้นไปยัง Cloud API

วางแผนการสื่อสารกับลูกค้า

ก่อนอื่น คุณจำเป็นต้องตัดสินใจว่าจะแจ้งเรื่องการย้ายกับลูกค้าปัจจุบันหรือไม่ แล้วคุณควรตัดสินใจว่าคุณจำเป็นต้องสร้างหรืออัพเดตเอกสารใดๆ เพื่อสนับสนุนการตั้งค่า Cloud API หรือไม่

ตัดสินใจเกี่ยวกับการกำหนดราคา

เนื่องจาก Meta ครอบคลุมค่าใช้จ่ายด้านโฮสติ้งสำหรับ Cloud API คุณจึงควรตัดสินใจว่าคุณอยากจะอัพเดตราคาของคุณตามนั้นหรือไม่

ตั้งค่าองค์ประกอบ

พาร์ทเนอร์โซลูชั่นจำเป็นต้องมีองค์ประกอบต่อไปนี้เพื่อใช้ Cloud API

ลงนามในสัญญา

การยอมรับข้อกำหนดในการใช้บริการ

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

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

หากคุณเป็นพาร์ทเนอร์เบต้าสำหรับ Cloud API อยู่แล้ว คุณจะมีระยะเวลาผ่อนผัน 90 วัน ซึ่งหมายความว่าคุณต้องยอมรับข้อกำหนดก่อนวันที่ 5 กรกฎาคม 2022 ไม่เช่นนั้น คุณจะเสียสิทธิ์การเข้าถึง

สำหรับธุรกิจที่ใช้ Cloud API รายใหม่ทั้งหมด ซึ่งรวมถึงธุรกิจที่ย้ายมาจาก On-Premises API คุณจะต้องยอมรับข้อกำหนดในการใช้บริการก่อนจึงจะสามารถเริ่มใช้ Cloud API ได้ การโทรติดต่อเพื่อลงทะเบียนจะไม่สามารถดำเนินการได้จนกว่าคุณจะยอมรับข้อกำหนดในการใช้บริการ

สร้างการผสานการทำงาน

ขั้นตอนที่ 1: รับโทเค็นการเข้าถึงสำหรับผู้ใช้ระบบ

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

วิธีสร้างโทเค็นการเข้าถึงสำหรับผู้ใช้ระบบมีดังนี้

1. ไปที่ตัวจัดการธุรกิจ > การตั้งค่าธุรกิจ > ผู้ใช้ > ผู้ใช้ระบบ เพื่อดูผู้ใช้ระบบที่คุณสร้างไว้
2. คลิกที่ผู้ใช้รายนั้นและเลือกเพิ่มองค์ประกอบ การดำเนินการนี้จะเปิดหน้าต่างใหม่ขึ้นมา
3. ใต้เลือกประเภทองค์ประกอบทางแผงด้านซ้าย ให้เลือกแอพ ใต้เลือกองค์ประกอบ ให้เลือกแอพของ Meta ที่คุณต้องการใช้ (แอพของคุณต้องมีสิทธิ์การอนุญาตที่ถูกต้อง) เปิดใช้งานแอพผู้พัฒนาสำหรับแอพนั้น
4. เลือกบันทึกการเปลี่ยนแปลงเพื่อบันทึกการตั้งค่าของคุณและย้อนกลับไปที่หน้าหลักของผู้ใช้ระบบ
5. ตอนนี้คุณก็พร้อมสร้างโทเค็นของคุณแล้ว คลิกสร้างโทเค็นและเลือกแอพของ Meta ในหน้าจอหลักของผู้ใช้ระบบ หลังจากเลือกแอพแล้ว คุณจะเห็นรายการสิทธิ์การอนุญาตที่ใช้งานได้ เลือก whatsapp_business_management และ whatsapp_business_messaging คลิก "สร้างโทเค็น"
6. หน้าต่างใหม่จะเปิดขึ้นมาพร้อมกับข้อมูลผู้ใช้ระบบ แอพที่กำหนด และโทเค็นการเข้าถึง บันทึกโทเค็นของคุณ
7. คุณสามารถเลือกคลิกที่โทเค็นของคุณแล้วดูตัวแก้ไขจุดบกพร่องของโทเค็นได้เช่นกัน ในตัวแก้ไขจุดบกพร่องของคุณ คุณควรเห็นสิทธิ์การอนุญาต 2 รายการที่คุณได้เลือกไว้ นอกจากนี้ คุณยังสามารถวางโทเค็นลงในตัวแก้ไขจุดบกพร่องของโทเค็นการเข้าถึงได้โดยตรง

ขั้นตอนที่ 2: ตั้งค่า Webhooks

คุณสามารถรับการแจ้งเตือน HTTP แบบเรียลไทม์จากแพลตฟอร์ม WhatsApp Business ได้ด้วยการตั้งค่า Webhooks ซึ่งหมายความว่าคุณจะได้รับการแจ้งเตือน อย่างเช่น เมื่อคุณได้รับข้อความจากลูกค้าหรือมีการเปลี่ยนแปลงในบัญชี WhatsApp Business (WABA) ของคุณ

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

การตั้งค่าแอพ

เมื่อตำแหน่งข้อมูลพร้อมใช้งาน ให้กำหนดค่าตำแหน่งข้อมูลที่แอพ Meta จะใช้

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

ขั้นตอนที่ 3: ตั้งค่าให้ติดตามข้อมูล WABA ของคุณ

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

curl -X POST \
'https://graph.facebook.com/v19.0/WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps' \
-H 'Authorization: Bearer ACCESS_TOKEN'

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

{
  "success": true
}

ขั้นตอนที่ 4: รับ ID หมายเลขโทรศัพท์

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

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

curl -X GET \
'https://graph.facebook.com/v19.0/WHATSAPP_BUSINESS_ACCOUNT_ID/phone_numbers' \
-H 'Authorization: Bearer ACCESS_TOKEN'

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

{
  "data": [
    {
      "verified_name": "Jasper's Market",
      "display_phone_number": "+1 631-555-5555",
      "id": "1906385232743451",
      "quality_rating": "GREEN"
    },
    {
      "verified_name": "Jasper's Ice Cream",
      "display_phone_number": "+1 631-555-5556",
      "id": "1913623884432103",
      "quality_rating": "NA"
    }
  ]
}

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

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

ขั้นตอนที่ 5: ลงทะเบียนหมายเลขโทรศัพท์

คุณจะสามารถลงทะเบียนหมายเลขโทรศัพท์ได้เมื่อมี ID ของหมายเลขนั้นๆ ในการเรียกใช้ API สำหรับการลงทะเบียน คุณจะดำเนินการ 2 อย่างนี้พร้อมกัน

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

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

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

curl -X POST \
'https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER_ID/register' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"messaging_product": "whatsapp","pin": "6_DIGIT_PIN"}'

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

{
  "success": true
}

ผู้ใช้การสมัครใช้งานแบบฝัง

ขั้นตอนที่ 6: รับข้อความจากแอพของผู้บริโภค

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

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

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "16315551234",
              "phone_number_id": "PHONE_NUMBER_ID"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Kerry Fisher"
                },
                "wa_id": "16315555555"
              }
            ],
            "messages": [
              {
                "from": "16315555555",
                "id": "wamid.ABGGFlA5FpafAgo6tHcNmNjXmuSf",
                "timestamp": "1602139392",
                "text": {
                  "body": "Hello!"
                },
                "type": "text"
                }
            ]
          },
        "field": "messages"
        }
      ]
    }
  ]
}

ขั้นตอนที่ 7: ส่งข้อความทดสอบ

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

curl -X  POST \
'https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER_ID/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"messaging_product": "whatsapp", "to": "16315555555","text": {"body" : "hello world!"}}'

หากการเรียกใช้ของคุณสำเร็จ การตอบกลับของคุณจะมี ID ข้อความรวมอยู่ด้วย ให้ใช้ ID ดังกล่าวเพื่อติดตามความคืบหน้าของข้อความของคุณผ่าน Webhooks ความยาวสูงสุดของ ID คือ 128 ตัวอักษร

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

{
  "id":"wamid.gBGGFlaCGg0xcvAdgmZ9plHrf2Mh-o"
}

ติดตามการอัพเดตรายเดือน

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

คำถามที่พบบ่อย

คำถามที่พบบ่อยโดยทั่วไป

คำถามที่พบบ่อยเกี่ยวกับการดำเนินการทางเทคนิค

What is the architecture of the Cloud API?

The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.

ลิงก์ถาวร

คำถามที่พบบ่อยเกี่ยวกับความเป็นส่วนตัวและการรักษาความปลอดภัยของข้อมูล

คำถามที่พบบ่อยการปฏิบัติตามระเบียบข้อบังคับ