ใช้ตำแหน่งข้อมูล /PHONE_NUMBER_ID/messages
ในการส่งข้อความตัวอักษร, สื่อ, ผู้ติดต่อ, ตำแหน่ง และข้อความแบบอินเทอร์แอคทีฟ รวมถึงเทมเพลตข้อความให้กับลูกค้าของคุณ เรียนรู้เพิ่มเติมเกี่ยวกับข้อความที่คุณสามารถส่งได้
ตำแหน่งข้อมูล | การยืนยันตัวตน |
---|---|
(โปรดดูที่ เรียกดู ID หมายเลขโทรศัพท์) | Developers can authenticate their API calls with the access token generated in the App Dashboard > WhatsApp > API Setup.
Solution Partners must authenticate themselves with an access token with the |
ข้อความจะถูกระบุด้วย ID ที่ไม่ซ้ำกัน (WAMID) คุณสามารถติดตามสถานะข้อความได้ใน Webhooks โดยใช้ WAMID คุณยังสามารถทำเครื่องหมายข้อความขาเข้าว่า "อ่านแล้ว" ผ่านตำแหน่งข้อมูลข้อความได้อีกด้วย WAMID นี้มีความยาวได้สูงสุด 128 อักขระ
เมื่อใช้ API ระบบคลาวด์ คุณจะไม่มีวิธีที่ตรวจสอบได้อย่างชัดเจนอีกต่อไปว่าหมายเลขโทรศัพท์หนึ่งๆ มี WhatsApp ID หรือไม่ หากต้องการส่งข้อความถึงผู้ใช้ด้วย API ระบบคลาวด์ ให้ส่งข้อความไปยังหมายเลขโทรศัพท์ของลูกค้าโดยตรง หลังจากที่ลูกค้าได้แสดงความต้องการที่จะเลือกรับข้อความแล้ว โปรดดูตัวอย่างที่ข้อมูลอ้างอิง, ข้อความ
หากต้องการส่งข้อความ คุณต้องรวมอ็อบเจ็กต์ข้อความที่มีเนื้อหาที่คุณต้องการส่งก่อน พารามิเตอร์เหล่านี้คือพารามิเตอร์ที่ใช้ในอ็อบเจ็กต์ message
:
ชื่อ | คำอธิบาย (คลิกที่ลูกศรในคอลัมน์ด้านซ้ายเพื่อดูตัวเลือกที่รองรับ) |
---|---|
| จำเป็นต้องระบุเมื่อ อ็อบเจ็กต์ |
| ระบุหรือไม่ก็ได้ สตริงแบบกำหนดเองซึ่งมีประโยชน์สำหรับการติดตาม ตัวอย่างเช่น คุณสามารถส่ง ID เทมเพลตข้อความในช่องนี้เพื่อติดตามเส้นทางการคอนเวอร์ชั่นของลูกค้าโดยเริ่มจากข้อความแรกที่คุณส่ง จากนั้น คุณจะสามารถติดตาม ROI ของเทมเพลตข้อความประเภทต่างๆ เพื่อระบุประเภทที่มีประสิทธิภาพสูงสุด แอพที่สมัครรับข้อมูลจากช่อง Webhook API ระบบคลาวด์ไม่ได้ประมวลผลช่องนี้ เพียงแต่จะส่งคืนช่องโดยเป็นส่วนหนึ่งของ Webhooks ข้อความที่ส่ง/ได้รับ/อ่านแล้ว สูงสุด 512 อักขระ เฉพาะ API ระบบคลาวด์ |
| จำเป็นต้องระบุเมื่อ |
| จำเป็นต้องระบุหากตอบกลับข้อความในการสนทนา อ็อบเจ็กต์ที่มี ID ของข้อความก่อนหน้าที่คุณกำลังตอบกลับ ตัวอย่างเช่น:
เฉพาะ API ระบบคลาวด์ |
| จำเป็นต้องระบุเมื่อ อ็อบเจ็กต์ |
| ประกอบด้วยอ็อบเจ็กต์ เฉพาะ API ภายในองค์กร |
| จำเป็นต้องระบุเมื่อ อ็อบเจ็กต์ |
| จำเป็นต้องระบุเมื่อ อ็อบเจ็กต์ |
| จำเป็นต้องระบุเมื่อ |
| จำเป็นต้องระบุ บริการส่งข้อความที่ใช้สำหรับคำขอ ให้ใช้ เฉพาะ API ระบบคลาวด์ |
| จำเป็นต้องระบุหาก อนุญาตให้แสดงตัวอย่าง URL ในข้อความตัวอักษร โปรดดูการส่ง URL ในข้อความตัวอักษร ช่องนี้เป็นช่องที่จะระบุหรือไม่ก็ได้ หากไม่มี URL ในข้อความของคุณ ค่า: เฉพาะ API ภายในองค์กร ผู้ใช้ API ระบบคลาวด์สามารถใช้ฟังก์ชั่นเดียวกันนี้กับช่อง |
| ระบุหรือไม่ก็ได้ ขณะนี้คุณสามารถส่งข้อความถึงบุคคลได้เท่านั้น ตั้งค่าเป็น ค่าเริ่มต้น: |
| สถานะของข้อความ คุณสามารถใช้ช่องนี้เพื่อทำเครื่องหมายข้อความว่า
|
| จำเป็นต้องระบุเมื่อ อ็อบเจ็กต์ API ระบบคลาวด์: ระบบรองรับสติกเกอร์ขาออกของบุคคลที่สามแบบภาพนิ่งและแบบเคลื่อนไหว นอกเหนือจากสติกเกอร์ขาเข้าทุกประเภท สติกเกอร์แบบภาพนิ่งจะต้องมีความละเอียด 512x512 พิกเซล และต้องมีขนาดไม่เกิน 100 KB สติกเกอร์แบบเคลื่อนไหวจะต้องมีความละเอียด 512x512 พิกเซล และต้องมีขนาดไม่เกิน 500 KB API ภายในองค์กร: ระบบรองรับเฉพาะสติกเกอร์ขาออกของบุคคลที่สามแบบภาพนิ่ง นอกเหนือจากสติกเกอร์ขาเข้าทุกประเภท สติกเกอร์แบบภาพนิ่งจะต้องมีความละเอียด 512x512 พิกเซล และต้องมีขนาดไม่เกิน 100 KB ระบบไม่รองรับสติกเกอร์แบบเคลื่อนไหว |
| จำเป็นต้องระบุเมื่อ |
| จำเป็นต้องระบุสำหรับข้อความตัวอักษร |
| จำเป็นต้องระบุ WhatsApp ID หรือหมายเลขโทรศัพท์ของลูกค้าที่คุณต้องการจะส่งข้อความไปหา โปรดดูรูปแบบหมายเลขโทรศัพท์ หากจำเป็น ผู้ใช้ API ภายในองค์กรสามารถรับหมายเลขนี้ได้โดยการเรียกใช้ตำแหน่งข้อมูล |
| ระบุหรือไม่ก็ได้ ประเภทของข้อความที่คุณต้องการส่ง หากละไว้ ค่าเริ่มต้นจะเป็น |
อ็อบเจ็กต์ต่อไปนี้จะซ้อนอยู่ภายในอ็อบเจ็กต์ข้อความ:
Name | Description |
---|---|
| Optional. Full contact address(es) formatted as an
|
| Optional.
|
| Optional. Contact email address(es) formatted as an
|
| Required. Full contact name formatted as a
*At least one of the optional parameters needs to be included along with the |
| Optional. Contact organization information formatted as an
|
| Optional. Contact phone number(s) formatted as a
|
| Optional. Contact URL(s) formatted as a
|
ชื่อ | คำอธิบาย |
---|---|
| จำเป็นต้องระบุ การดำเนินการที่คุณต้องการให้ผู้ใช้กระทำหลังจากที่อ่านข้อความ |
| ระบุหรือไม่ก็ได้สำหรับประเภท อ็อบเจ็กต์ที่มีเนื้อหาของข้อความ อ็อบเจ็กต์
|
| ระบุหรือไม่ก็ได้ อ็อบเจ็กต์ที่มีส่วนท้ายของข้อความ อ็อบเจ็กต์
|
| จำเป็นต้องระบุสำหรับประเภท เนื้อหาส่วนหัวที่แสดงอยู่ด้านบนข้อความ ทั้งนี้ คุณจะไม่สามารถตั้งค่าส่วนหัวได้หากอ็อบเจ็กต์แบบอินเทอร์แอคทีฟของคุณเป็นประเภท |
| จำเป็นต้องระบุ ประเภทของข้อความแบบอินเทอร์แอคทีฟที่คุณต้องการส่ง ค่าที่รองรับ ได้แก่
|
อ็อบเจ็กต์ต่อไปนี้จะซ้อนอยู่ภายในอ็อบเจ็กต์ interactive
:
ชื่อ | คำอธิบาย |
---|---|
| จำเป็นต้องระบุสำหรับข้อความแบบรายการ เนื้อหาในปุ่ม สตริงนี้จะเว้นว่างไม่ได้และต้องไม่ซ้ำกันภายในข้อความ ระบบรองรับอีโมจิ แต่ไม่รองรับมาร์กดาวน์ ความยาวสูงสุด: 20 อักขระ |
| จำเป็นต้องระบุสำหรับปุ่มตอบกลับ อ็อบเจ็กต์ปุ่มสามารถมีพารามิเตอร์ต่อไปนี้ได้
คุณสามารถมีปุ่มได้สูงสุด 3 ปุ่ม คุณจะตั้งค่า ID โดยขึ้นต้นหรือลงท้ายด้วยการเว้นวรรคไม่ได้ |
| จำเป็นต้องระบุสำหรับข้อความที่มีผลิตภัณฑ์รายการเดียวและข้อความที่มีผลิตภัณฑ์หลายรายการ ตัวระบุที่ไม่ซ้ำกันของแค็ตตาล็อกบน Facebook ที่เชื่อมโยงไปยังบัญชี WhatsApp Business ของคุณ คุณสามารถดึง ID นี้ได้ผ่านทางตัวจัดการการค้าของ Meta |
| จำเป็นต้องระบุสำหรับข้อความที่มีผลิตภัณฑ์รายการเดียวและข้อความที่มีผลิตภัณฑ์หลายรายการ ตัวระบุที่ไม่ซ้ำกันของผลิตภัณฑ์ในแค็ตตาล็อก หากต้องการรับ ID นี้ ให้ไปที่ตัวจัดการการค้าของ Meta และเลือกบัญชีธุรกิจ Meta ของคุณ คุณจะเห็นรายชื่อร้านค้าที่เชื่อมต่อกับบัญชีของคุณ คลิกที่ร้านค้าที่คุณต้องการใช้ ในแผงด้านซ้าย ให้คลิกที่แค็ตตาล็อก > รายการ และค้นหารายการที่คุณต้องการกล่าวถึง ID สำหรับรายการดังกล่าวจะแสดงใต้ชื่อของรายการนั้น |
| จำเป็นต้องระบุสำหรับข้อความแบบรายการและข้อความที่มีผลิตภัณฑ์หลายรายการ อาร์เรย์ของอ็อบเจ็กต์ |
| ระบุหรือไม่ก็ได้สำหรับข้อความแบบขั้นตอน โหมดปัจจุบันของขั้นตอน โดยอาจเป็น ค่าเริ่มต้น: |
| จำเป็นต้องระบุสำหรับข้อความแบบขั้นตอน ต้องเป็น |
| จำเป็นต้องระบุสำหรับข้อความแบบขั้นตอน โทเค็นที่ธุรกิจสร้างขึ้นเพื่อใช้เป็นตัวระบุ |
| จำเป็นต้องระบุสำหรับข้อความแบบขั้นตอน ตัวระบุที่ไม่ซ้ำกันของขั้นตอนที่ได้มาจาก WhatsApp |
| จำเป็นต้องระบุสำหรับข้อความแบบขั้นตอน ข้อความบนปุ่ม CTA เช่น "สมัคร" ความยาวสูงสุด: 20 อักขระ (ไม่มีอีโมจิ) |
| ระบุหรือไม่ก็ได้สำหรับข้อความแบบขั้นตอน
ค่าเริ่มต้น: |
| ระบุหรือไม่ก็ได้สำหรับข้อความแบบขั้นตอน ต้องระบุก็ต่อเมื่อ
|
ชื่อ | คำอธิบาย |
---|---|
| จำเป็นต้องระบุ หากตั้งค่า ประกอบด้วยอ็อบเจ็กต์สื่อสำหรับเอกสารนี้ |
| จำเป็นต้องระบุ หากตั้งค่า ประกอบด้วยอ็อบเจ็กต์สื่อสำหรับรูปภาพนี้ |
| จำเป็นต้องระบุ หากตั้งค่า ข้อความสำหรับส่วนหัว การจัดรูปแบบอนุญาตให้ใช้อีโมจิได้ แต่ใช้มาร์กดาวน์ไม่ได้ ความยาวสูงสุด: 60 อักขระ |
| จำเป็นต้องระบุ ประเภทส่วนหัวที่คุณต้องการใช้ ค่าที่รองรับ ได้แก่
|
| จำเป็นต้องระบุ หากตั้งค่า ประกอบด้วยอ็อบเจ็กต์สื่อสำหรับวิดีโอนี้ |
ชื่อ | คำอธิบาย |
---|---|
| จำเป็นต้องระบุสำหรับข้อความที่มีผลิตภัณฑ์หลายรายการ อาร์เรย์ของอ็อบเจ็กต์ อ็อบเจ็กต์
|
| จำเป็นต้องระบุสำหรับข้อความแบบรายการ ประกอบด้วยรายชื่อแถว คุณสามารถมีแถวในส่วนต่างๆ ได้ทั้งหมด 10 แถว แต่ละแถวต้องมีชื่อ (ความยาวสูงสุด: 24 อักขระ) และ ID (ความยาวสูงสุด: 200 อักขระ) คุณสามารถเพิ่มคำอธิบายได้ (ความยาวสูงสุด: 72 อักขระ) แต่จะใส่หรือไม่ก็ได้ ตัวอย่าง: "rows": [ { "id":"unique-row-identifier-here", "title": "row-title-content-here", "description": "row-description-content-here", } ] |
| จำเป็นต้องระบุ หากข้อความมีมากกว่า 1 ส่วน ชื่อของส่วน ความยาวสูงสุด: 24 อักขระ |
Name | Description |
---|---|
| Required. Location latitude in decimal degrees. |
| Required. Location longitude in decimal degrees. |
| Required. Name of the location. |
| Required. Address of the location. |
โปรดดูข้อมูลเกี่ยวกับวิธีการรับ ID ของออบเจ็กต์สื่อของคุณได้ที่ "รับ ID สื่อ" โปรดดูข้อมูลเกี่ยวกับประเภทสื่อที่รองรับสำหรับ API ระบบคลาวด์ได้ที่ "ประเภทสื่อที่รองรับ"
Name | Description |
---|---|
| Required when The media object ID. Do not use this field when message |
| Required when The protocol and URL of the media to be sent. Use only with HTTP/HTTPS URLs. Do not use this field when message Cloud API users only:
|
| Optional. Media asset caption. Do not use with On-Premises API users:
|
| Optional. Describes the filename for the specific document. Use only with The extension of the filename will specify what format the document is displayed as in WhatsApp. |
| Optional. On-Premises API only. This path is optionally used with a |
มีการเปลี่ยนแปลงการกำหนดราคาตามการสนทนา เรียนรู้วิธีการทำงานของรูปแบบการกำหนดราคาตามการสนทนารูปแบบใหม่ของเราได้ที่หัวข้อ "การกำหนดราคา"
นอกจากนี้ยังมีการเปลี่ยนแปลงการแสดงผลของ metric_types
โดยเริ่มมีผลตั้งแต่วันที่ 1 กรกฎาคม 2023 โปรดดูรายละเอียดเพิ่มเติมได้ที่ "ตารางการวิเคราะห์การสนทนา"
Name | Description |
---|---|
| Required. Name of the template. |
| Required. Contains a The
|
| Optional. Array of |
| Optional. Only used for On-Premises API. Namespace of the template. |
อ็อบเจ็กต์ต่อไปนี้จะซ้อนอยู่ภายในอ็อบเจ็กต์ template
:
ชื่อ | คำอธิบาย (คลิกที่ลูกศรในคอลัมน์ด้านซ้ายเพื่อดูตัวเลือกที่รองรับ) |
---|---|
| จำเป็นต้องระบุ ระบุประเภทพารามิเตอร์ของปุ่ม |
| จำเป็นต้องระบุสำหรับปุ่ม ระบบจะส่งคืนเพย์โหลดที่ผู้พัฒนากำหนดเมื่อมีการคลิกปุ่ม นอกเหนือจากข้อความที่แสดงบนปุ่ม โปรดดูตัวอย่างได้ที่ "การเรียกกลับจากการคลิกปุ่มตอบกลับด่วน" |
| จำเป็นต้องระบุสำหรับปุ่ม URL คำต่อท้ายที่ได้จากผู้พัฒนาซึ่งจะต่อท้าย URL พรีฟิกซ์ที่กำหนดไว้ล่วงหน้าในเทมเพลต |
Name | Description (Click the arrow in the left column for supported options.) |
---|---|
| Required. Describes the Example of a "components": [{ "type": "body", "parameters": [{ "type": "text", "text": "name" }, { "type": "text", "text": "Hi there" }] }] |
| Required when Type of button to create. |
| Required when Array of For components of type=button, see the |
| Required when Position index of the button. You can have up to 10 buttons using index values of 0 to 9. |
ชื่อ | คำอธิบาย |
---|---|
| จำเป็นต้องระบุ ข้อความเริ่มต้น หากไม่สามารถแปลภาษาได้ |
| จำเป็นต้องระบุ รหัสสกุลเงินตามที่กำหนดไว้ใน |
| จำเป็นต้องระบุ จำนวนคูณด้วย 1000 |
ชื่อ | คำอธิบาย |
---|---|
| จำเป็นต้องระบุ ข้อความเริ่มต้น สำหรับ API ระบบคลาวด์ เราจะใช้ค่าสำรองเสมอ และเราจะไม่พยายามแปลภาษาโดยใช้ช่องอื่นๆ ที่จะระบุหรือไม่ก็ได้ |
ชื่อ | คำอธิบาย |
---|---|
| จำเป็นต้องระบุ อธิบายประเภทพารามิเตอร์ ค่าที่รองรับ ได้แก่
ประเภทพารามิเตอร์ที่รองรับสำหรับเทมเพลตแบบข้อความมีเพียง |
| จำเป็นต้องระบุเมื่อ ตัวอักษรของข้อความ จำนวนอักขระสูงสุดจะแตกต่างกันไปตามประเภทองค์ประกอบที่รวมอยู่ต่อไปนี้ สำหรับองค์ประกอบประเภท
สำหรับองค์ประกอบประเภท
|
| จำเป็นต้องระบุเมื่อ |
| จำเป็นต้องระบุเมื่อ |
| จำเป็นต้องระบุเมื่อ อ็อบเจ็กต์ |
| จำเป็นต้องระบุเมื่อ อ็อบเจ็กต์ |
| จำเป็นต้องระบุเมื่อ อ็อบเจ็กต์ |
ชื่อ | คำอธิบาย |
---|---|
| จำเป็นต้องระบุสำหรับข้อความตัวอักษร ข้อความของข้อความตัวอักษรที่สามารถมี URL ที่ขึ้นต้นด้วย http:// หรือ https:// และมีการจัดรูปแบบ โปรดดูตัวเลือกการจัดรูปแบบที่ใช้ได้ที่นี่ หากคุณใส่ URL ไว้ในข้อความและต้องการให้มีกล่องแสดงตัวอย่างในข้อความแบบตัวอักษร ( ความยาวสูงสุด: 4,096 อักขระ |
| ระบุหรือไม่ก็ได้ เฉพาะ API ระบบคลาวด์ ตั้งค่าเป็น หากระบบละเว้น สำหรับผู้ใช้ API ภายในองค์กร ให้ใช้ |
ชื่อ | คำอธิบาย |
---|---|
| จำเป็นต้องระบุ ID ข้อความ WhatsApp (wamid) ของข้อความที่ควรปรากฏการแสดงความรู้สึก ระบบจะไม่ส่งการแสดงความรู้สึกในกรณีดังต่อไปนี้
หาก ID เป็นของข้อความที่ถูกลบ ข้อความดังกล่าวจะไม่ถูกส่ง |
| จำเป็นต้องระบุ อีโมจิที่จะปรากฏในข้อความ
|
โปรดดูคู่มือต่อไปนี้เพื่อเรียนรู้ข้อมูลทั้งหมดเกี่ยวกับวิธีใช้ตำแหน่งข้อมูล /messages
เพื่อส่งข้อความ
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER_ID/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE_NUMBER",
"type": "text",
"text": { // the text object
"preview_url": false,
"body": "MESSAGE_CONTENT"
}
}'
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER_ID/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE_NUMBER",
"type": "reaction",
"reaction": {
"message_id": "wamid.HBgLM...",
"emoji": "\uD83D\uDE00"
}
}'
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM-PHONE-NUMBER-ID/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE-NUMBER",
"type": "image",
"image": {
"id" : "MEDIA-OBJECT-ID"
}
}'
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER_ID/messages' \
-H 'Authorization: ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"to": "PHONE_NUMBER",
"type": "location",
"location": {
"longitude": LONG_NUMBER,
"latitude": LAT_NUMBER,
"name": LOCATION_NAME,
"address": LOCATION_ADDRESS
}
}'
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER_ID/messages' \
-H 'Authorization: ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"to": "PHONE_NUMBER",
"type": "contacts",
"contacts": [{
"addresses": [{
"street": "STREET",
"city": "CITY",
"state": "STATE",
"zip": "ZIP",
"country": "COUNTRY",
"country_code": "COUNTRY_CODE",
"type": "HOME"
},
{
"street": "STREET",
"city": "CITY",
"state": "STATE",
"zip": "ZIP",
"country": "COUNTRY",
"country_code": "COUNTRY_CODE",
"type": "WORK"
}],
"birthday": "YEAR_MONTH_DAY",
"emails": [{
"email": "EMAIL",
"type": "WORK"
},
{
"email": "EMAIL",
"type": "HOME"
}],
"name": {
"formatted_name": "NAME",
"first_name": "FIRST_NAME",
"last_name": "LAST_NAME",
"middle_name": "MIDDLE_NAME",
"suffix": "SUFFIX",
"prefix": "PREFIX"
},
"org": {
"company": "COMPANY",
"department": "DEPARTMENT",
"title": "TITLE"
},
"phones": [{
"phone": "PHONE_NUMBER",
"type": "HOME"
},
{
"phone": "PHONE_NUMBER",
"type": "WORK",
"wa_id": "PHONE_OR_WA_ID"
}],
"urls": [{
"url": "URL",
"type": "WORK"
},
{
"url": "URL",
"type": "HOME"
}]
}]
}'
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE_NUMBER",
"type": "interactive",
"interactive": {
"type": "product",
"body": {
"text": "optional body text"
},
"footer": {
"text": "optional footer text"
},
"action": {
"catalog_id": "CATALOG_ID",
"product_retailer_id": "ID_TEST_ITEM_1"
}
}
}'
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE_NUMBER",
"type": "interactive",
"interactive": {
"type": "product_list",
"header":{
"type": "text",
"text": "header-content"
},
"body": {
"text": "body-content"
},
"footer": {
"text": "footer-content"
},
"action": {
"catalog_id": "CATALOG_ID",
"sections": [
{
"title": "section-title",
"product_items": [
{ "product_retailer_id": "product-SKU-in-catalog" },
{ "product_retailer_id": "product-SKU-in-catalog" },
...
]
},
{
"title": "section-title",
"product_items": [
{ "product_retailer_id": "product-SKU-in-catalog" },
{ "product_retailer_id": "product-SKU-in-catalog" },
...
]
}
]
}
}
}
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE_NUMBER",
"type": "interactive",
"interactive" : {
"type" : "catalog_message",
"body" : {
"text": "Thanks for your order! Tell us what address you’d like this order delivered to."
},
"action": {
"name": "catalog_message",
"parameters": {
"thumbnail_product_retailer_id": "<Product-retailer-id>"
}
}
}
}'
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE_NUMBER",
"type": "interactive",
"interactive" : {
"type": "flow",
"header": {
"type": "text",
"text": "Flow message header"
},
"body": {
"text": "Flow message body"
},
"footer": {
"text": "Flow message footer"
},
"action": {
"name": "flow",
"parameters": {
"flow_message_version": "3",
"flow_token": "AQAAAAACS5FpgQ_cAAAAAD0QI3s",
"flow_id": "<FLOW_ID>",
"flow_cta": "Book!",
"flow_action": "navigate",
"flow_action_payload": {
"screen": "<SCREEN_ID>",
"data": {
"user_name": "name",
"user_age": 25
}
}
}
}
}
}'
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER_ID/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE_NUMBER",
"type": "interactive",
"interactive": {
"type": "list",
"header": {
"type": "text",
"text": "HEADER_TEXT"
},
"body": {
"text": "BODY_TEXT"
},
"footer": {
"text": "FOOTER_TEXT"
},
"action": {
"button": "BUTTON_TEXT",
"sections": [
{
"title": "SECTION_1_TITLE",
"rows": [
{
"id": "SECTION_1_ROW_1_ID",
"title": "SECTION_1_ROW_1_TITLE",
"description": "SECTION_1_ROW_1_DESCRIPTION"
},
{
"id": "SECTION_1_ROW_2_ID",
"title": "SECTION_1_ROW_2_TITLE",
"description": "SECTION_1_ROW_2_DESCRIPTION"
}
]
},
{
"title": "SECTION_2_TITLE",
"rows": [
{
"id": "SECTION_2_ROW_1_ID",
"title": "SECTION_2_ROW_1_TITLE",
"description": "SECTION_2_ROW_1_DESCRIPTION"
},
{
"id": "SECTION_2_ROW_2_ID",
"title": "SECTION_2_ROW_2_TITLE",
"description": "SECTION_2_ROW_2_DESCRIPTION"
}
]
}
]
}
}
}'
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER_ID/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE_NUMBER",
"type": "interactive",
"interactive": {
"type": "button",
"body": {
"text": "BUTTON_TEXT"
},
"action": {
"buttons": [
{
"type": "reply",
"reply": {
"id": "UNIQUE_BUTTON_ID_1",
"title": "BUTTON_TITLE_1"
}
},
{
"type": "reply",
"reply": {
"id": "UNIQUE_BUTTON_ID_2",
"title": "BUTTON_TITLE_2"
}
}
]
}
}
}'
มีการเปลี่ยนแปลงการกำหนดราคาตามการสนทนา เรียนรู้วิธีการทำงานของรูปแบบการกำหนดราคาตามการสนทนารูปแบบใหม่ของเราได้ที่หัวข้อ "การกำหนดราคา"
นอกจากนี้ยังมีการเปลี่ยนแปลงการแสดงผลของ metric_types
โดยเริ่มมีผลตั้งแต่วันที่ 1 กรกฎาคม 2023 โปรดดูรายละเอียดเพิ่มเติมได้ที่ "ตารางการวิเคราะห์การสนทนา"
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER_ID/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE_NUMBER",
"type": "template",
"template": {
"name": "TEMPLATE_NAME",
"language": {
"code": "LANGUAGE_AND_LOCALE_CODE"
},
"components": [
{
"type": "header",
"parameters": [
{
"type": "image",
"image": {
"link": "http(s)://URL"
}
}
]
},
{
"type": "body",
"parameters": [
{
"type": "text",
"text": "TEXT_STRING"
},
{
"type": "currency",
"currency": {
"fallback_value": "VALUE",
"code": "USD",
"amount_1000": NUMBER
}
},
{
"type": "date_time",
"date_time": {
"fallback_value": "MONTH DAY, YEAR"
}
}
]
},
{
"type": "button",
"sub_type": "quick_reply",
"index": "0",
"parameters": [
{
"type": "payload",
"payload": "PAYLOAD"
}
]
},
{
"type": "button",
"sub_type": "quick_reply",
"index": "1",
"parameters": [
{
"type": "payload",
"payload": "PAYLOAD"
}
]
}
]
}
}'
curl -X POST \
'https://graph.facebook.com/v19.0
/FROM_PHONE_NUMBER/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"context": {
"message_id": "MESSAGE_ID"
},
"to": "PHONE_NUMBER",
"type": "text",
"text": {
"preview_url": false,
"body": "your-text-message-content"
}
}’
{ "messaging_product": "whatsapp", "contacts": [ { "input": "16505555555", "wa_id": "16505555555" } ], "messages": [ { "id": "wamid.HBgLMTY1MDUwNzY1MjAVAgARGBI5QTNDQTVCM0Q0Q0Q2RTY3RTcA" } ] }
Applies to businesses in Brazil, Colombia, and Singapore, starting September 12, 2023. Applies to all businesses starting October 12, 2023.
Messages will have one of the following statuses which will be returned in each of the messages
objects
"message_status":"accepted"
: means the message was sent to the intended recipient"message_status":"held_for_quality_assessment"
: means the message send was delayed until quality can be validated and it will either be sent or dropped at this point{ "messaging_product": "whatsapp", "contacts": [ { "input": "16505555555", "wa_id": "16505555555" } ], "messages": [ { "id": "wamid.HBgLMTY1MDUwNzY1MjAVAgARGBI5QTNDQTVCM0Q0Q0Q2RTY3RTcA", "message_status": "accepted", } ] }