ภาพรวม

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 โปรดดูการเข้าถึงทรัพย์สินธุรกิจเพื่อเรียนรู้วิธีตั้งค่าและแทนที่สิทธิ์การเข้าถึง

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

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

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

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

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

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

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

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

โทเค็นประเภทนี้มีประโยชน์สำหรับแอพที่มีการดำเนินการอัตโนมัติเชิงโปรแกรมบนบัญชี 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...' \

สิทธิ์การเข้าถึงสินทรัพย์ธุรกิจ

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

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

วิธีตั้งค่าการเข้าถึงสินทรัพย์ธุรกิจในบัญชี WhatsApp Business:

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

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

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

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

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

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

curl -i -X GET 'https://graph.facebook.com/v21.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/v21.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",
      },
      ...
    

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

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

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

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

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