WhatsApp Business Tools MCP

ทางการ

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

คุณทำอะไรได้บ้างด้วย WhatsApp Business Tools MCP?

  • ค้นหาธุรกิจและบัญชี — แสดงรายการธุรกิจที่คุณดูแลด้วย whatsapp_biz_businesses จากนั้นแสดงบัญชี WhatsApp ภายใต้ธุรกิจนั้นด้วย whatsapp_biz_accounts
  • เริ่มต้นใช้งานหมายเลขโทรศัพท์ — เพิ่มหมายเลข ส่งรหัสยืนยัน ยืนยันรหัส และลงทะเบียนหมายเลขเพื่อรับส่งข้อความผ่าน whatsapp_biz_add_phone_number และเครื่องมือที่เกี่ยวข้อง
  • จัดการเทมเพลตข้อความ — แสดงรายการ ตรวจสอบ สร้าง อัปเดต และลบเทมเพลตในบัญชีด้วย whatsapp_biz_list_templates และ whatsapp_biz_create_template
  • ส่งข้อความ — ส่งข้อความอิสระภายในช่วงเวลา 24 ชั่วโมง หรือส่งเทมเพลตที่ได้รับอนุมัติจากหมายเลขที่ลงทะเบียนไว้ด้วย whatsapp_biz_send_message
  • กำหนดค่าเว็บฮุก — ตั้งค่า URL สำหรับเรียกกลับและโทเค็นยืนยัน จากนั้นสมัครบัญชี WhatsApp ให้รับเว็บฮุกของแอป
  • ตรวจสอบการตั้งค่าบัญชี — กำหนดค่าการชำระเงิน ตรวจสอบสถานะการยืนยันธุรกิจ และรับลิงก์สำหรับสร้างโทเค็นผู้ใช้ระบบ

เซิร์ฟเวอร์ MCP แบบโฮสต์

npx add-mcp 'https://mcp.facebook.com/whatsapp_business_tools'

ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ

เอกสาร

WhatsApp Business Tools MCP

สำหรับนักพัฒนาที่สร้างบน WhatsApp Business Platform (Cloud API) — เซิร์ฟเวอร์ WhatsApp Business Tools MCP ช่วยให้เอเจนต์ AI และผู้ช่วย IDE ของคุณจัดการและแก้ไขข้อบกพร่องของการผสานรวม WhatsApp Business ได้จากที่เดียว โดยช่วยให้เอเจนต์ค้นหาธุรกิจและบัญชี WhatsApp ที่คุณดูแลอยู่ เริ่มต้นใช้งานและลงทะเบียนหมายเลขโทรศัพท์ สร้างและจัดการเทมเพลตข้อความ กำหนดค่าเว็บฮุก และส่งข้อความ โดยดำเนินการในนามของคุณ บนแอปและธุรกิจที่คุณดูแลอยู่

หมายเหตุ: หมายเหตุ: อินเทอร์เฟซและชุดเครื่องมือของเซิร์ฟเวอร์ WhatsApp Business Tools MCP อยู่ในรุ่นเบต้าและอาจมีการเปลี่ยนแปลง

ภาพรวม

ตารางต่อไปนี้สรุปรายละเอียดของเซิร์ฟเวอร์:

คุณสมบัติค่า
ชื่อเซิร์ฟเวอร์WhatsApp Business Tools
การขนส่งStreamable HTTP
Endpointhttps://mcp.facebook.com/whatsapp_business_tools
การตรวจสอบสิทธิ์ลงชื่อเข้าใช้บัญชีนักพัฒนา Meta (OAuth)
Client IDไม่จำเป็น เซิร์ฟเวอร์จะจดจำไคลเอ็นต์ที่รองรับโดยอัตโนมัติ
Redirect URIไม่จำเป็น คุณไม่ต้องสร้างหรือกำหนดค่าแอป Meta สำหรับเซิร์ฟเวอร์นี้
ไคลเอ็นต์ที่รองรับClaude Code, Claude Desktop, ChatGPT, Codex CLI, Codex app
สถานะเบต้า - อินเทอร์เฟซและชุดเครื่องมืออาจมีการเปลี่ยนแปลง

ก่อนเริ่มต้น

หากต้องการเชื่อมต่อไคลเอ็นต์ คุณต้องใช้ไคลเอ็นต์ที่รองรับรายการใดรายการหนึ่งข้างต้นในเวอร์ชันปัจจุบัน

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

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

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

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

เชื่อมต่อไคลเอ็นต์

หากต้องการเชื่อมต่อไคลเอ็นต์ที่รองรับและดำเนินการอนุญาต OAuth ให้เสร็จสิ้น โปรดทำตาม เชื่อมต่อไคลเอ็นต์ MCP กับ Meta ใช้ชื่อเซิร์ฟเวอร์และ endpoint จาก ภาพรวม เซิร์ฟเวอร์นี้ไม่ต้องใช้ client ID ดังนั้นให้ใช้ การลงทะเบียนอัตโนมัติ

ขอบเขตสิทธิ์

เซิร์ฟเวอร์จะขอสิทธิ์ต่อไปนี้ระหว่างการให้ความยินยอม:

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

คุณตรวจสอบสิทธิ์เหล่านี้และเพิกถอนการเข้าถึงได้บน Facebook ที่ การตั้งค่า > กิจกรรมของคุณ > การผสานรวมธุรกิจ

ตรวจสอบการเชื่อมต่อ

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

ขีดจำกัดอัตราการเรียกใช้

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

เครื่องมือ

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

การค้นหา

  • whatsapp_biz_businesses — แสดงรายการธุรกิจที่คุณดูแลและให้สิทธิ์ไว้ระหว่างการให้ความยินยอม ใช้เครื่องมือนี้ก่อนเพื่อเลือกธุรกิจ ตัวอย่าง: "แสดงรายการธุรกิจที่ฉันจัดการบน WhatsApp ได้"
  • whatsapp_biz_accounts — แสดงรายการบัญชี WhatsApp (และบัญชีการรับส่งข้อความ) ภายใต้ธุรกิจ ตัวอย่าง: "แสดงบัญชี WhatsApp ของธุรกิจ 1234567890"
  • whatsapp_biz_phone_numbers — แสดงรายการหมายเลขโทรศัพท์ในธุรกิจหรือบัญชี WhatsApp พร้อมสถานะและสถานะการเริ่มต้นใช้งาน ตัวอย่าง: "แสดงรายการหมายเลขโทรศัพท์และสถานะของหมายเลขเหล่านั้นสำหรับธุรกิจนี้"

การเริ่มต้นใช้งานหมายเลขโทรศัพท์

  • whatsapp_biz_add_phone_number — เพิ่มหมายเลขโทรศัพท์ลงในบัญชี WhatsApp ตัวอย่าง: "เพิ่มหมายเลขโทรศัพท์ +1 555 010 1234 ลงในบัญชี WhatsApp ของฉัน"
  • whatsapp_biz_send_verification_code — ส่งรหัสยืนยันไปยังหมายเลขโทรศัพท์ ตัวอย่าง: "ส่งรหัสยืนยันทาง SMS ไปยังหมายเลขนี้"
  • whatsapp_biz_verify_phone_number — ยืนยันหมายเลขโทรศัพท์ด้วยรหัสที่ได้รับ ตัวอย่าง: "ยืนยันหมายเลขนี้ด้วยรหัส 123456"
  • whatsapp_biz_register_phone_number — ลงทะเบียนหมายเลขที่ยืนยันแล้วเพื่อให้ส่งและรับข้อความได้ ตัวอย่าง: "ลงทะเบียนหมายเลขนี้เพื่อรับส่งข้อความ"

เทมเพลตข้อความ

  • whatsapp_biz_list_templates / whatsapp_biz_get_template — แสดงรายการและตรวจสอบเทมเพลตข้อความในบัญชี ตัวอย่าง: "แสดงรายการเทมเพลตที่ได้รับอนุมัติสำหรับบัญชีนี้"
  • whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — สร้าง อัปเดต และลบเทมเพลตข้อความ ตัวอย่าง: "สร้างเทมเพลตการตลาดชื่อ order_update ใน en_US"

การรับส่งข้อความ

  • whatsapp_biz_send_message — ส่งข้อความข้อความอิสระ (ส่งได้เฉพาะภายในช่วงเวลาบริการลูกค้า 24 ชั่วโมง) หรือข้อความจากเทมเพลตที่ได้รับอนุมัติจากหมายเลขที่ลงทะเบียนไว้ ระบบจะยืนยันผู้รับกับคุณก่อนส่ง ตัวอย่าง: "ส่งเทมเพลต order_update ไปยัง +1 555 010 9999 จากหมายเลขนี้"

เว็บฮุก

  • whatsapp_biz_configure_webhooks — ตั้งค่า URL สำหรับ callback และโทเค็นยืนยันสำหรับหัวข้อ WhatsApp แล้วสมัครรับฟิลด์ที่อนุญาต ตัวอย่าง: "กำหนดค่าเว็บฮุกสำหรับธุรกิจนี้ด้วย callback https://example.com/webhook."
  • whatsapp_biz_subscribe_webhook — สมัครบัญชี WhatsApp ให้รับเว็บฮุกของแอป เพื่อให้ส่งเหตุการณ์ของบัญชีนั้นได้ ตัวอย่าง: "สมัครบัญชี WhatsApp นี้ให้รับเว็บฮุก"

การตั้งค่าบัญชี

  • whatsapp_biz_configure_payments — กำหนดค่าวิธีการชำระเงินเพื่อให้บัญชีส่งข้อความที่มีค่าใช้จ่ายได้ ตัวอย่าง: "ช่วยฉันตั้งค่าการชำระเงินสำหรับบัญชีนี้"
  • whatsapp_biz_verify_business — ตรวจสอบและเริ่มการยืนยันธุรกิจ ตัวอย่าง: "สถานะการยืนยันธุรกิจเป็นอย่างไร และฉันจะเริ่มได้อย่างไร"
  • whatsapp_biz_system_user_token — รับลิงก์สำหรับสร้าง โทเค็นการเข้าถึงของผู้ใช้ระบบ สำหรับธุรกิจของคุณ เพื่อให้คุณสร้างโซลูชันการรับส่งข้อความแบบกำหนดเองที่เรียกใช้ WhatsApp Cloud API ได้โดยตรง การสร้างโทเค็นจะดำเนินการอย่างปลอดภัยใน Business Settings — เครื่องมือจะแสดง deep link ไปยังหน้า System Users ซึ่งคุณเลือกผู้ใช้ระบบและสร้างโทเค็นได้ ดูข้อมูลเพิ่มเติมที่ สร้างผู้ใช้ระบบและสร้างโทเค็นการเข้าถึงแบบถาวร ตัวอย่าง: "ขอลิงก์สำหรับสร้างโทเค็นการเข้าถึงของผู้ใช้ระบบสำหรับธุรกิจนี้"

ข้อเสนอแนะ

หากมีข้อเสนอแนะหรือต้องการให้เพิ่มเครื่องมือ โปรด ส่งข้อเสนอแนะ

ที่เกี่ยวข้อง


ดัชนีเอกสารฉบับเต็มสำหรับผลิตภัณฑ์นี้: https://developers.facebook.com/documentation/mcp/llms.txt