การตั้งค่า Webhooks

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

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

สร้างตำแหน่งข้อมูล

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

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

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

สมัครรับข้อมูล Webhooks

ในการสมัครรับข้อมูล Webhooks คุณจะต้องได้รับ ID ของแอพ Meta และสิทธิ์การอนุญาตต่างๆ โดยให้ไปที่แดชบอร์ดของแอพ Meta ซึ่งคุณจะต้องดำเนินการดังต่อไปนี้

  1. สร้างแอพ Meta ในแดชบอร์ดของแอพ Meta
  2. เพิ่มผลิตภัณฑ์ Webhooks ไปยังแอพ Meta ของคุณในแดชบอร์ดของแอพ

    ไม่ว่าในเวลาใดก็ตาม แอพ Meta แต่ละแอพจะมีตำแหน่งข้อมูลที่กำหนดค่าไว้ได้เพียงตำแหน่งเดียวเท่านั้น หากคุณจำเป็นต้องส่งการอัพเดต Webhook ไปยังหลายตำแหน่งข้อมูล คุณจะต้องมีแอพ Meta หลายแอพ

เมื่อคุณพร้อมจะขยายการส่งข้อความจากธุรกิจของคุณ คุณอาจต้องดำเนินการต่อไปนี้

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

ช่องการสมัครรับข้อมูลที่มีให้

ช่องการสมัครรับข้อมูลที่มีให้

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

account_review_update

ระบบจะส่งการแจ้งเตือนให้คุณเมื่อมีการตรวจสอบบัญชี WhatsApp Business

account_update

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

business_capability_update

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

message_template_status_update

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

messages

ระบบจะส่งการแจ้งเตือนถึงคุณเมื่อธุรกิจของคุณได้รับข้อความจากลูกค้า เมื่อคุณส่งข้อความถึงลูกค้า เมื่อข้อความส่งถึงลูกค้า และเมื่อลูกค้าอ่านข้อความ

phone_number_name_update

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

phone_number_quality_update

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

security

ระบบจะส่งการแจ้งเตือนให้คุณในกรณีต่อไปนี้

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

    เพย์โหลดการแจ้งเตือน

    การแจ้งเตือนทั้งหมดมีรูปแบบทั่วไปดังต่อไปนี้

    [{
        "object": "whatsapp_business_account",
        "entry": [{
           "id": "{whatsapp-business-account-id}",
            "time": {unix-timestamp},
            "changes": [{
                "field": "{subscribed-field}",
                "value": {
                    # Information that was update
                }
              }]
          }]
      }]

    อาร์เรย์ระดับสูงสุดจะมีอ็อบเจ็กต์หลัก 2 รายการดังนี้

    พารามิเตอร์คำอธิบาย

    object

    นี่คืออ็อบเจ็กต์ที่เป็นเป้าหมายในการตั้งค่ารับข้อมูล

    entry

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

    โปรดดูอ็อบเจ็กต์ Webhooks ที่มีให้ใช้งานทั้งหมดที่องค์ประกอบ