Cloud API ที่โฮสต์โดย Meta ช่วยให้ธุรกิจขนาดกลางและขนาดใหญ่สามารถสื่อสารกับลูกค้าได้ในวงกว้าง เมื่อใช้ API ดังกล่าว ธุรกิจจะสามารถสร้างระบบที่เชื่อมต่อลูกค้าหลายพันรายเข้ากับเจ้าหน้าที่หรือบอทได้ ซึ่งจะเอื้อให้เกิดการสื่อสารทั้งผ่านทางโปรแกรมและผ่านบุคคลจริง นอกจากนี้ ธุรกิจยังสามารถผสานการทำงาน API ดังกล่าวเข้ากับระบบแบ็กเอ็นด์จำนวนมาก เช่น CRM และแพลตฟอร์มการตลาดต่างๆ ได้อีกด้วย
Cloud API สร้างขึ้นบน API กราฟ ดังนั้นระบบจะแสดงคำขอโดยใช้โปรโตคอล HTTP และพารามิเตอร์ URL, ส่วนหัว และเนื้อความของคำขอรวมกัน ตัวอย่างเช่น การเรียกไปยัง Cloud API จากบรรทัดคำสั่งในรูปแบบ UNIX โดยทั่วไปจะมีลักษณะดังนี้
curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505555555", "type": "text", "text": { "preview_url": true, "body": "Here'\''s the info you requested! https://www.meta.com/quest/quest-3/" } }'
หากคุณไม่คุ้นเคยกับ API กราฟ โปรดอ่านเอกสารประกอบเกี่ยวกับ API กราฟของเราเพื่อเรียนรู้ข้อมูลพื้นฐาน โดย API กราฟและ Cloud API มีจุดที่แตกต่างกันหลักๆ ได้แก่ ประเภทโทเค็นการเข้าถึงที่คุณใช้งานโดยทั่วไป สิทธิ์การอนุญาตในการใช้งานแหล่งข้อมูล รูปแบบคำสั่งของคำขอ และรูปแบบคำสั่งของ Webhooks ซึ่งเราได้อธิบายความแตกต่างเหล่านี้เพิ่มเติมอย่างละเอียดในส่วนที่เกี่ยวข้องในชุดเอกสารเกี่ยวกับ Cloud API
สิ่งเหล่านี้คือแหล่งข้อมูลหลักที่คุณจะโต้ตอบด้วยเมื่อใช้ API นี้
หากต้องการใช้ API นี้ คุณจะต้องมีพอร์ตโฟลิโอธุรกิจ หากไม่มี ระบบจะแจ้งให้คุณสร้างพอร์ตโฟลิโอ ซึ่งเป็นส่วนหนึ่งของกระบวนการเริ่มต้นใช้งานของเรา โดยพอร์ตโฟลิโอธุรกิจทำหน้าที่เป็นคอนเทนเนอร์สำหรับบัญชี WhatsApp Business (WABA) และหมายเลขโทรศัพท์ธุรกิจของคุณ
โปรดดูบทความ "เกี่ยวกับพอร์ตโฟลิโอธุรกิจใน Meta Business Suite" จากศูนย์ช่วยเหลือของเราเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับพอร์ตโฟลิโอธุรกิจ
บัญชี WhatsApp Business จะแสดงตัวตนของธุรกิจบนแพลตฟอร์ม WhatsApp Business และประกอบด้วยเมตาดาต้าเกี่ยวกับธุรกิจนั้นๆ เป็นหลัก ส่วนแหล่งข้อมูลอื่นๆ จาก WhatsApp ส่วนใหญ่ เช่น หมายเลขโทรศัพท์ธุรกิจบน WhatsApp และเทมเพลตข้อความบน WhatsApp จะเชื่อมโยงกับ WABA
คุณสามารถสร้าง WABA ได้โดยทำตามขั้นตอนในเอกสาร "เริ่มต้นใช้งาน" ของเรา หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ WABA และข้อจำกัด โปรดดู "บัญชี WhatsApp Business"
หมายเลขโทรศัพท์ธุรกิจบน WhatsApp (หมายเลขโทรศัพท์ธุรกิจ) คือหมายเลขโทรศัพท์จริงที่เมื่อได้รับการลงทะเบียนเพื่อใช้กับ Cloud API แล้ว จะสามารถใช้หมายเลขโทรศัพท์นี้รับส่งข้อความกับผู้ใช้ WhatsApp ผ่าน API ดังกล่าวได้
หมายเลขโทรศัพท์ธุรกิจประกอบด้วยเมตาดาต้าเกี่ยวกับหมายเลขนั้นๆ และธุรกิจของคุณเป็นส่วนใหญ่ และเมตาดาต้านี้อาจปรากฏในไคลเอ็นต์ WhatsApp เมื่อผู้ใช้โต้ตอบกับหมายเลขโทรศัพท์ธุรกิจของคุณ
คุณสามารถสร้างหมายเลขโทรศัพท์ธุรกิจได้โดยทำตามขั้นตอนในเอกสาร "เริ่มต้นใช้งาน" ของเรา ทั้งนี้ โปรดทราบว่าหมายเลขโทรศัพท์ธุรกิจและการใช้งานมีข้อจำกัดและขีดจำกัด ซึ่งเราได้อธิบายไว้อย่างละเอียดในเอกสาร "หมายเลขโทรศัพท์ธุรกิจ"
เทมเพลตข้อความ WhatsApp (เทมเพลต) เป็นเทมเพลตที่ปรับแต่งได้ ซึ่งคุณสามารถสร้างผ่าน API โดยใช้องค์ประกอบเทมเพลตต่างๆ ได้ เมื่อสร้างแล้ว เทมเพลตดังกล่าวจะได้รับการตรวจสอบโดยอัตโนมัติ และหากได้รับอนุมัติ ก็จะสามารถนำมาใช้ในข้อความเทมเพลตได้
ข้อความที่คุณสามารถส่งผ่าน API มีอยู่ด้วยกัน 2 ประเภทหลักๆ ได้แก่ ข้อความที่มีรูปแบบอิสระและข้อความเทมเพลต ซึ่งใน 2 ประเภทนี้ ข้อความเทมเพลตจะมีข้อจำกัดมากที่สุด เนื่องจากต้องใช้เทมเพลตข้อความ WhatsApp ที่ได้รับอนุมัติ แต่เนื่องจากเทมเพลตต้องได้รับการตรวจสอบและอนุมัติก่อนจึงจะสามารถใช้งานได้ ข้อความเทมเพลตจึงมีโอกาสน้อยลงที่จะได้รับคำติชมเชิงลบจากผู้รับซึ่งอาจส่งผลเสียต่อความสามารถโดยรวมในการส่งข้อความถึงลูกค้า
โปรดดูเอกสาร "เทมเพลต" ของเราเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับเทมเพลต
Webhooks คือเพย์โหลด JSON ที่ส่งโดยใช้โปรโตคอล HTTP ไปยังตำแหน่งข้อมูลสาธารณะบนเซิร์ฟเวอร์ของคุณ ซึ่ง Cloud API ต้องพึ่งพา Webhooks เป็นหลัก เนื่องจากเนื้อหาของข้อความที่ส่งจากผู้ใช้ WhatsApp ไปยังหมายเลขโทรศัพท์ธุรกิจของคุณจะถูกส่งเป็น Webhook และการอัพเดตสถานะการส่งข้อความขาออกทั้งหมดจะได้รับการรายงานผ่าน Webhook
โปรดทราบว่าเรามีตัวอย่างแอพ Webhook ที่คุณสามารถโคลนบน Glitch และใช้สำหรับการทดสอบได้ โดยแอพดังกล่าวจะแสดงเพย์โหลด Webhooks ไปที่คอนโซลโดยตรงเพื่อให้คุณสามารถดูเนื้อหาได้ ทั้งนี้ อย่าลืมว่าสุดท้ายแล้ว เมื่อถึงจุดหนึ่งคุณจะต้องสร้างตำแหน่งข้อมูลบนเซิร์ฟเวอร์ของคุณ ซึ่งจะประมวลผล Webhooks ตามตรรกะธุรกิจของคุณเอง
โปรดดู "Webhooks ของ Meta" เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับ Webhooks และวิธีประมวลผล รวมถึงเอกสาร "Webhooks สำหรับบัญชี WhatsApp Business" ของเรา
เมื่อคุณทำตามขั้นตอนในเอกสาร "เริ่มต้นใช้งาน" ของเราแล้ว ระบบจะสร้าง WABA และหมายเลขโทรศัพท์ธุรกิจสำหรับทดสอบให้คุณโดยอัตโนมัติ
WABA และหมายเลขโทรศัพท์ธุรกิจสำหรับทดสอบมีประโยชน์สำหรับใช้ในการทดสอบ เนื่องจากบัญชีและหมายเลขโทรศัพท์เหล่านี้จะไม่อยู่ในขีดจำกัดการส่งข้อความส่วนใหญ่ และไม่จำเป็นต้องมีวิธีการชำระเงินที่บันทึกไว้เพื่อส่งข้อความเทมเพลต
คุณสามารถลบพอร์ตโฟลิโอธุรกิจและแหล่งข้อมูลสำหรับทดสอบได้หากเป็นไปตามเงื่อนไขดังต่อไปนี้
หากต้องการลบพอร์ตโฟลิโอธุรกิจและแหล่งข้อมูลสำหรับทดสอบ ให้ดำเนินการดังนี้
API รองรับโทเค็น 3 ประเภท ดังนี้
โปรดดู "โทเค็นการเข้าถึง" ของเราเพื่อพิจารณาว่าคุณควรใช้โทเค็นประเภทใด ทั้งนี้ โปรดทราบว่าโทเค็นควรถูกส่งผ่านส่วนหัวของคำขอ ไม่ใช่ส่งเป็นพารามิเตอร์สตริงการสืบค้น
API ต้องอาศัยสิทธิ์การอนุญาตสำหรับ API กราฟต่อไปนี้ ซึ่งชุดของสิทธิ์การอนุญาตที่แอพของคุณจำเป็นต้องใช้นั้นจะขึ้นอยู่กับตำแหน่งข้อมูลที่แอพของคุณจะเข้าถึง
โดยทั่วไปแล้ว คุณจะได้รับสิทธิ์การอนุญาตเหล่านี้เมื่อสร้างโทเค็นการเข้าถึงใน Meta Business Suite โปรดดูเนื้อหาส่วนการสร้างโทรเค็นในเอกสาร "โทเค็นการเข้าถึง" ของเรา
การกำหนดเวอร์ชั่นจะใช้โปรโตคอลการกำหนดเวอร์ชั่นของ API กราฟ ซึ่งหมายความว่าคำขอตำแหน่งข้อมูลทั้งหมดสามารถมีหมายเลขเวอร์ชั่นได้ และแต่ละเวอร์ชั่นจะใช้งานได้ประมาณ 2 ปี ก่อนจะหยุดให้บริการและไม่สามารถเรียกใช้ได้อีก
สำหรับหมายเลขโทรศัพท์ของธุรกิจที่ลงทะเบียนไว้แต่ละหมายเลข ตามค่าเริ่มต้นแล้ว Cloud API รองรับได้สูงสุด 80 ข้อความต่อวินาที (mps) และเมื่อมีการอัพเกรดอัตโนมัติจะสามารถรองรับได้สูงสุดถึง1,000 ข้อความต่อวินาที
โดยปริมาณข้อความนี้นับรวมทั้งข้อความขาเข้าและขาออกและข้อความทุกประเภท โปรดทราบว่าหมายเลขโทรศัพท์ของธุรกิจ ไม่ว่าจะมีปริมาณข้อความเท่าใดก็ตาม จะยังคงอยู่ภายใต้ขีดจำกัดอัตรากรณีการใช้งานของธุรกิจและขีดจำกัดการส่งข้อความเทมเพลตของบัญชี WhatsApp Business
หากคุณพยายามส่งข้อความมากเกินกว่าที่ระดับปริมาณข้อความปัจจุบันของคุณอนุญาต API จะส่งคืนรหัสข้อผิดพลาด 130429
จนกว่าคุณจะอยู่ในระดับที่อนุญาตอีกครั้ง นอกจากนี้ ระดับปริมาณข้อความยังมีไว้สำหรับแคมเปญการส่งข้อความที่มีหมายเลขโทรศัพท์ของผู้ใช้ WhatsApp แตกต่างกันอีกด้วย หากคุณพยายามส่งข้อความไปยังหมายเลขโทรศัพท์ของผู้ใช้ WhatsApp หมายเลขเดียวกันมากเกินไป คุณอาจพบข้อผิดพลาดขีดจำกัดอัตราการจับคู่
หากคุณมีคุณสมบัติตรงตามข้อกำหนด เราจะอัพเกรดหมายเลขโทรศัพท์ธุรกิจของคุณเป็น 1,000 ข้อความต่อวินาทีให้โดยอัตโนมัติโดยไม่มีค่าใช้จ่าย ปริมาณข้อความที่มากขึ้นจะไม่ทำให้เกิดค่าใช้จ่ายเพิ่มเติมหรือส่งผลกระทบต่อราคา
กระบวนการอัพเกรดอาจใช้เวลาสูงสุด 1 นาที ในช่วงเวลานี้ หมายเลขดังกล่าวจะไม่สามารถใช้งานบนแพลตฟอร์มของเราได้ API จะส่งรหัสข้อผิดพลาด 131057
กลับมา หากใช้หมายเลขดังกล่าวในคำขอ API เมื่อหมายเลขโทรศัพท์ของธุรกิจได้รับการอัพเกรดแล้ว หมายเลขนั้นก็จะได้รับการอัพเกรดเพื่อเพิ่มปริมาณข้อความในอนาคตโดยอัตโนมัติโดยไม่มีเวลาหยุดทำงาน
เซิร์ฟเวอร์ Webhook ของคุณควรสามารถรองรับการส่งข้อความขาออกได้ถึง 3 เท่า และรองรับการรับข้อความขาเข้าที่คาดการณ์ไว้ได้ 1 เท่า ตัวอย่างเช่น หากส่ง 1,000 mps โดยคาดการณ์ว่าจะมีอัตราการตอบกลับ 30% เซิร์ฟเวอร์ของคุณควรสามารถประมวลผล Webhooks สถานะข้อความได้สูงสุด 3,000 ข้อความ บวกกับ Webhooks ข้อความขาเข้าอีก 300 ข้อความ
เราพยายามส่ง Webhooks พร้อมกัน เราจึงขอแนะนำให้คุณกำหนดค่าและทดสอบโหลดเซิร์ฟเวอร์ Webhooks ของคุณเพื่อจัดการกับคำขอที่เข้ามาพร้อมกันด้วยมีมาตรฐานเวลาแฝงต่อไปนี้
เราจะพยายามส่ง Webhooks ที่ไม่สำเร็จอีกครั้งภายในไม่เกิน 7 วัน โดยใช้อัลกอริทึม Exponential Backoff
หากต้องการใช้ประโยชน์จากปริมาณข้อความที่สูงขึ้นอย่างเต็มที่ เราขอแนะนำให้คุณอัพโหลดองค์ประกอบสื่อของคุณไว้บนเซิร์ฟเวอร์ของเรา และใช้ ID สื่อที่ส่งคืนมาในข้อความสื่อ แทนที่จะโฮสต์องค์ประกอบเหล่านั้นไว้บนเซิร์ฟเวอร์ของเราเองและใช้ URL ขององค์ประกอบดังกล่าว หากคุณอยากจะ (หรือต้อง) โฮสต์องค์ประกอบไว้บนเซิร์ฟเวอร์ของคุณเอง เราขอแนะนำให้คุณใช้การแคชสื่อ
ใช้ตำแหน่งข้อมูลหมายเลขโทรศัพท์ธุรกิจบน WhatsApp เพื่อเรียกดูปริมาณข้อความในปัจจุบันของหมายเลขโทรศัพท์นั้นๆ
GET /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>?fields=throughput
หากคุณย้ายหมายเลขโทรศัพท์ของธุรกิจที่มีการเชื่อมต่อหลายจุดซึ่งเรียกใช้ตั้งแต่ 2 ชาร์ดขึ้นไปจาก On-Premises API มาใช้ Cloud API หมายเลขจะอัพเกรดปริมาณข้อความให้เพิ่มมากขึ้น
ดูขีดจำกัดอัตรา API การจัดการธุรกิจ WhatsApp ต่างๆ
นอกจากขีดจำกัดอัตราเหล่านี้แล้ว เรามีขีดจำกัดที่ละเอียดกว่านั้นสำหรับแหล่งข้อมูลแต่ละรายการ เช่น ข้อความเทมเพลตและหมายเลขโทรศัพท์ธุรกิจสำหรับทดสอบ ดังนี้
ในฐานะผู้ใช้ Cloud API คุณสามารถดูจำนวนข้อความที่ส่งออกและส่งถึงผู้รับ รวมถึงเกณฑ์ชี้วัดอื่นๆ ได้ด้วย โปรดดูข้อมูลที่รับเกณฑ์ชี้วัดบัญชี
ในโครงสร้างพื้นฐานของ Meta นั้น Cloud API จะขยายและปรับขนาดโดยอัตโนมัติเพื่อจัดการภาระงานภายในขีดจำกัดอัตรา (ปริมาณการส่งข้อความและจำนวน WABA) ของคุณ
ดูข้อมูลได้ที่ภาพรวมความเป็นส่วนตัวและการรักษาความปลอดภัยของเรา
เมื่อใช้ Cloud API ข้อความบน WhatsApp ทุกข้อความจะยังคงได้รับการปกป้องผ่านการเข้ารหัสโปรโตคอล Signal ซึ่งจะรักษาความปลอดภัยให้กับข้อความก่อนที่จะส่งออกจากอุปกรณ์ ซึ่งหมายความว่าข้อความจาก WABA จะส่งถึงปลายทางที่แต่ละธุรกิจเลือกไว้อย่างปลอดภัย
Cloud API ใช้เทคนิคการเข้ารหัสที่ได้มาตรฐานในวงการนี้ เพื่อปกป้องข้อมูลที่อยู่ระหว่างการถ่ายโอนและข้อมูลที่จัดเก็บ โดย API นี้จะใช้ API กราฟเพื่อส่งข้อความและใช้ Webhooks เพื่อรับเหตุการณ์ และทั้งสองเครื่องมือนี้จะดำเนินการผ่าน HTTPS ตามมาตรฐานของวงการนี้ ซึ่งได้รับการปกป้องโดย TLS โปรดดูรายละเอียดเพิ่มเติมที่เอกสารภาพรวมเกี่ยวกับการเข้ารหัสของเรา
โปรดดูรายละเอียดเพิ่มเติมที่เอกสารภาพรวมเกี่ยวกับการเข้ารหัสของเรา
ระบบจำกัดให้หมายเลขโทรศัพท์ธุรกิจสามารถส่งข้อความไปยังหมายเลขโทรศัพท์ของผู้ใช้ WhatsApp หมายเลขเดียวกันได้ 1 ข้อความทุกๆ 6 วินาที (0.17 ข้อความ/วินาที) ซึ่งจะเท่ากับ 10 ข้อความต่อนาที หรือ 600 ข้อความต่อชั่วโมงโดยประมาณ หากคุณส่งข้อความเกินขีดจำกัดนี้ API จะส่งคืนรหัสข้อผิดพลาด 131056
จนกว่าคุณจะส่งข้อความไม่เกินขีดจำกัดอีกครั้ง
คุณสามารถส่งข้อความแบบต่อเนื่องได้สูงสุด 45 ข้อความใน 6 วินาทีหากจำเป็น หากคุณส่งข้อความแบบต่อเนื่อง จะเท่ากับว่าคุณกำลังยืมปริมาณการส่งข้อความจากขีดจำกัดอัตราการจับคู่ ดังนั้นระบบจะป้องกันไม่ให้คุณส่งข้อความถัดไปถึงผู้ใช้รายเดิมได้ จนกว่าเวลาจะผ่านไปเท่ากับเวลาที่ใช้ในการส่งข้อความแบบ "ไม่ต่อเนื่อง" จำนวนดังกล่าวถึงผู้ใช้ในกรณีปกติ ตัวอย่างเช่น โดยปกติจะใช้เวลาประมาณ 2 นาทีในการส่งข้อความแบบ "ไม่ต่อเนื่อง" จำนวน 20 ข้อความถึงผู้ใช้รายหนึ่ง ดังนั้นหากคุณส่งข้อความแบบต่อเนื่อง 20 ข้อความ คุณจะต้องรออีกประมาณ 2 นาที จึงจะสามารถส่งข้อความถัดไปถึงผู้ใช้รายเดิมได้
เพื่อให้ไม่ต้องคำนวณระยะเวลาที่รอหลังจากส่งข้อความแบบต่อเนื่อง เราขอแนะนำว่า หากคุณส่งคำขอส่งข้อความไม่สำเร็จหลังจากที่ส่งข้อความแบบต่อเนื่องไปแล้ว ให้ลองอีกครั้งในอีก 4^X วินาทีต่อมา โดยที่ X = 0 และให้เพิ่มค่า X ทีละ 1 หลังจากส่งคำขอไม่สำเร็จแต่ละครั้ง จนกว่าจะส่งคำขอสำเร็จ
ตัวจัดการ WhatsApp คือเว็บแอพที่ช่วยให้คุณจัดการแหล่งข้อมูล WhatsApp เช่น WABA หมายเลขโทรศัพท์ธุรกิจ และเทมเพลตได้ด้วยตนเอง และช่วยให้คุณสามารถดูข้อมูลเชิงลึกและการให้คะแนนคุณภาพหรือขีดจำกัดของแหล่งข้อมูลเหล่านี้ได้อย่างสะดวก นอกจากนี้ คุณสามารถใช้งานฟังก์ชั่นการทำงานส่วนใหญ่ที่ตัวจัดการ WhatsApp มีให้ผ่าน API โดยมีข้อยกเว้นเล็กน้อยบางประการเท่านั้น
การเข้าใช้ตัวจัดการ WhatsApp ทำได้หลายวิธี ดังนี้ โดยแต่ละวิธีจะถือว่าคุณทำขั้นตอนในเอกสารเริ่มต้นใช้งานของเราเสร็จทั้งหมดแล้ว
คุณสามารถไปที่ "ภาพรวมของตัวจัดการ WhatsApp" ได้โดยตรง ซึ่งจะแสดง WABA ทั้งหมดที่พอร์ตโฟลิโอธุรกิจดังกล่าวเป็นเจ้าของหรือใช้ร่วมกัน โดยไปที่:
ตามค่าเริ่มต้น ภาพรวมจะโหลด WABA ล่าสุดที่คุณสร้างขึ้นหรือได้รับอนุญาตให้เข้าถึง แต่คุณสามารถใช้เมนูดร็อปดาวน์ทางด้านซ้ายเพื่อเลือกพอร์ตโฟลิโอธุรกิจที่มี WABA ที่คุณกำลังพยายามเข้าถึง การดำเนินการนี้จะนำคุณออกจากภาพรวม จากนั้นคุณจะต้องใช้เมนูทางด้านซ้ายและไปที่ "บัญชี > บัญชี WhatsApp > (เลือก WABA ที่ต้องการ) > การตั้งค่า > ตัวจัดการ WhatsApp" (ปุ่ม)
หรือหากคุณมีพอร์ตโฟลิโอธุรกิจหลายบัญชี คุณสามารถนำ ID ของบัญชีมาต่อท้าย URL และบุ๊กมาร์กไว้เพื่อให้เข้าถึงได้ง่ายขึ้น ดังนี้
https://business.facebook.com/wa/manage/home/?business_id=<META_BUSINESS_ACCOUNT_ID>
เรามีคอลเลกชั่น Postman สำหรับ Cloud API ที่มีชุดคำสั่งสืบค้นทั่วไปในพื้นที่ทำงานของแพลตฟอร์ม WhatsApp Business