WhatsApp Business Platform > Business Management API

ภาพรวม

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

ข้อกำหนด

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

โทเค็นการเข้าถึง

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

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

โทเค็นการเข้าถึงผู้ใช้ระบบ

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

โทเค็นการเข้าถึงผู้ใช้ระบบเป็นโทเค็นประเภทเดียวที่พาร์ทเนอร์โซลูชั่นสามารถใช้ได้เพื่อแชร์วงเงินเครดิตกับลูกค้าที่เริ่มต้นใช้งาน

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

ผู้ใช้ระบบอาจเป็นพนักงานหรือผู้ดูแลก็ได้

ผู้ใช้ระบบที่เป็นพนักงาน

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

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

ผู้ใช้ระบบที่เป็นผู้ดูแล

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

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

โปรดทราบว่าคุณสามารถแทนที่สิทธิ์การเข้าถึงเริ่มต้นของผู้ใช้ระบบที่เป็นผู้ดูแลได้โดยมอบสิทธิ์การเข้าถึงบางส่วนตามบัญชี WhatsApp Business

การสร้างผู้ใช้ระบบ

วิธีการสร้างผู้ใช้ระบบ

ลงชื่อเข้าใช้ Meta Business Suite
ค้นหาบัญชีธุรกิจของคุณในเมนูดร็อปดาวน์ด้านซ้ายบน แล้วคลิกไอคอนการตั้งค่า (รูปเฟือง)
คลิกที่การตั้งค่าธุรกิจ
ไปที่ผู้ใช้ > ผู้ใช้ระบบ
คลิกปุ่มเพิ่ม แล้วสร้างผู้ใช้ระบบที่เป็นผู้ดูแลหรือพนักงาน

การสร้างโทเค็นการเข้าถึงผู้ใช้ระบบ

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

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

โทเค็นการเข้าถึงผู้ใช้ระบบในการผสานรวมธุรกิจ

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

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

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

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

โทเค็นการเข้าถึงผู้ใช้

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

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

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

การใช้โทเค็นในคำขอ

เมื่อส่งคำขอ API ให้รวมโทเค็นของคุณไว้ในส่วนหัวของคำขอการอนุญาต โดยมี Bearer อยู่ข้างหน้า ตัวอย่างเช่น:

curl 'https://graph.facebook.com/v18.0/102290129340398/message_templates' \
-H 'Authorization: Bearer EAAJB...' \

สิทธิ์การเข้าถึงบัญชี WhatsApp Business

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

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

วิธีการกำหนดสิทธิ์การเข้าถึงของผู้ใช้ในบัญชี WhatsApp Business หรือสินทรัพย์ของบัญชีนั้น

ลงชื่อเข้าใช้ Meta Business Suite
ค้นหาบัญชีธุรกิจของคุณในเมนูดร็อปดาวน์ด้านซ้ายบน แล้วคลิกไอคอนการตั้งค่า (รูปเฟือง)
คลิกที่การตั้งค่าธุรกิจ
ไปที่บัญชี > บัญชี WhatsApp
เลือกบัญชี WhatsApp Business ที่ต้องการ
เลือกแท็บสิทธิ์การเข้าถึงบัญชี WhatsApp
คลิกปุ่ม +เพิ่มผู้คน
เลือกผู้ใช้ระบบที่ต้องการและกำหนดสิทธิ์การเข้าถึงในระดับที่เหมาะสมในบัญชี WhatsApp Business

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

เราขอแนะนำให้ใช้คอลเลกชั่น Postman หรือ cURL เมื่อทดสอบตำแหน่งข้อมูล แม้ว่าคุณจะใช้เครื่องมือ Graph API Explorer ได้ แต่เครื่องมือนี้จะส่งโทเค็นเป็นพารามิเตอร์สตริงการสืบค้น ซึ่งเราไม่แนะนำให้ใช้ (ส่งโทเค็นในส่วนหัวของคำขอแทน)

รับข้อมูลเกี่ยวกับธุรกิจ

หากต้องการรับข้อมูลเกี่ยวกับธุรกิจ ให้ส่งคำขอ GET ไปยังตำแหน่งข้อมูล WhatsAppBusinessAccount โดยที่ <WHATSAPP_BUSINESS_ACCOUNT_ID> คือ ID บัญชี WhatsApp Business ของคุณ

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

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

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

{
  "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
  "name": "Your WhatsApp Business Account Name",
  "timezone_id": "1",
  "message_template_namespace": "05155c78_261e_4b2f_82b3_d7958d4cf75f"
}

หากต้องการรับข้อมูลที่เฉพาะเจาะจงเกี่ยวกับธุรกิจ เช่น ชื่อ เทมเพลตข้อความ และหมายเลขโทรศัพท์ ให้ส่งคำขอ GET ไปยังตำแหน่งข้อมูล WhatsAppBusinessAccount โดยที่ <WHATSAPP_BUSINESS_ACCOUNT_ID> คือ ID บัญชี WhatsApp Business ของคุณ และตั้งค่าพารามิเตอร์ fields เป็นลิสต์รายการต่างๆ ที่คุณต้องการให้ระบบส่งคืนมา

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

curl -i -X GET 'https://graph.facebook.com/v19.0/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=id,name,message_templates,phone_numbers' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

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

{
  "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
  "name": "Your WhatsApp Business Account Name",
  "message_templates": {
    "data": [
      {
        "name": "hello_world",
        "components": [
          {
            "type": "HEADER",
            "format": "TEXT",
            "text": "Hello World"
          },
          {
            "type": "BODY",
            "text": "Welcome and congratulations!! This message demonstrates your ability to send a message notification from WhatsApp Business Platform. Thank you for taking the time to test with us."
          },
          {
            "type": "FOOTER",
            "text": "WhatsApp Business Team"
          }
        ],
        "language": "en_US",
        "status": "APPROVED",
        "category": "ACCOUNT_UPDATE",
        "id": "307191531401674"
      },
      {
        "name": "sample_flight_confirmation",
        "components": [
          {
            "type": "HEADER",
            "format": "DOCUMENT"
          },
          {
            "type": "BODY",
            "text": "Confirmamos tu vuelo a {{1}}-{{2}} para el {{3}}."
          },
          {
            "type": "FOOTER",
            "text": "Este mensaje proviene de un negocio no verificado."
          }
        ],
        "language": "es",
        "status": "APPROVED",
        "category": "TICKET_UPDATE",
      },
      ...

ขีดจำกัดอัตรา

คำขอที่ส่งจากแอพของคุณไปยัง API การจัดการ WhatsApp Business จะนับรวมอยู่ในจำนวนของแอพ จำนวนการเรียกใช้ของแอพ คือ จำนวนการเรียกใช้ที่แอพสามารถทำได้ในระยะเวลา 1 ชั่วโมงต่อเนื่อง ทั้งนี้ ในกรณีของ API การจัดการ WhatsApp Business ดังต่อไปนี้ แอพของคุณสามารถเรียกใช้ได้ 200 ครั้งต่อชั่วโมง ต่อแอพ ต่อบัญชี WhatsApp Business (WABA) โดยค่าเริ่มต้น ส่วนในกรณีของ WABA ที่ใช้งานอยู่และมีหมายเลขโทรศัพท์ที่ลงทะเบียนไว้อย่างน้อย 1 หมายเลข แอพของคุณจะเรียกใช้ได้ 5,000 ครั้งต่อชั่วโมง ต่อแอพ ต่อ WABA ที่ใช้งานอยู่

ประเภทการเรียกใช้	ตำแหน่งข้อมูล
`GET`	`/{whatsapp-business-account-id}`
`GET`, `POST` และ `DELETE`	`/{whatsapp-business-account-id}/assigned_users`
`GET`	`/{whatsapp-business-account-id}/phone_numbers`
`GET`, `POST` และ `DELETE`	`/{whatsapp-business-account-id}/message_templates`
`GET`, `POST` และ `DELETE`	`/{whatsapp-business-account-id}/subscribed_apps`
`GET`	`/{whatsapp-business-account-to-number-current-status-id}`

ในกรณีของ API วงเงินเครดิตต่อไปนี้ แอพของคุณจะเรียกใช้ได้ 5,000 ครั้งต่อชั่วโมง ต่อแอพ

ประเภทการเรียกใช้	ตำแหน่งข้อมูล
`GET`	`/{business-id}/extendedcredits`
`POST`	`/{extended-credit-id}/whatsapp_credit_sharing_and_attach`
`GET` และ `DELETE`	`/{allocation-config-id}`
`GET`	`/{extended-credit-id}/owning_credit_allocation_configs`

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

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

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

Facebook SDK — หากต้องการขอสิทธิ์การอนุญาตจากผู้ใช้โดยใช้การเข้าสู่ระบบด้วย Facebook คุณสามารถใช้ SDK ตัวใดตัวหนึ่งของเราก็ได้
ตัวจัดการธุรกิจของ API การตลาด – เรียนรู้เพิ่มเติมเกี่ยวกับตัวจัดการธุรกิจของ API การตลาด
การตรวจสอบแอพ – เรียนรู้เพิ่มเติมเกี่ยวกับกระบวนการเข้าถึงข้อมูลของคุณเองหรือข้อมูลของผู้อื่น
รับชมวิดีโอเกี่ยวกับการตั้งค่าแพลตฟอร์ม WhatsApp Business

ขั้นตอนถัดไป

คู่มือ – เรียนรู้ว่าคุณจะใช้ API การจัดการ WhatsApp Business เพื่อทำอะไรได้อีกบ้าง
สำรวจคอลเลกชั่น Postman ของเรา

แพลตฟอร์ม WhatsApp Business | API ระบบคลาวด์ | API ภายในองค์กร | API การจัดการธุรกิจ