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

เมื่อลูกค้าแตะปุ่มดูแค็ตตาล็อก แค็ตตาล็อกสินค้าจะปรากฏขึ้นใน WhatsApp
คุณต้องเชื่อมโยงสินค้าคงคลังที่อัพโหลดไปยัง Meta ในแค็ตตาล็อกอีคอมเมิร์ซกับบัญชี WhatsApp Business ของคุณ
ใช้ตำแหน่งข้อมูลหมายเลขโทรศัพท์ WhatsApp Business > ข้อความเพื่อส่งข้อความแค็ตตาล็อก
POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "<TO>",
"type": "interactive",
"interactive" : {
"type" : "catalog_message",
"body" : {
"text": "<BODY_TEXT>"
},
"action": {
"name": "catalog_message",
"parameters": {
"thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
}
},
/* Footer object is optional */
"footer": {
"text": "<FOOTER_TEXT>"
}
}| ตัวยึดตำแหน่ง | คำอธิบาย | ตัวอย่างค่า |
|---|---|---|
สตริง | จำเป็นต้องระบุ ข้อความที่จะปรากฏในเนื้อหาข้อความ สูงสุด 1,024 อักขระ |
|
สตริง | ระบุหรือไม่ก็ได้ ข้อความที่จะปรากฏในส่วนท้ายของข้อความ มีตัวอักษรได้ไม่เกิน 60 ตัว |
|
สตริง | ต้องระบุ หมายเลข SKU รายการสินค้า ติดป้ายกำกับเป็น ID เนื้อหาในตัวจัดการการค้า ภาพขนาดย่อของรายการสินค้านี้จะถูกนำไปใช้เป็นภาพส่วนหัวของข้อความ หากไม่มีอ็อบเจ็กต์ |
|
สตริง | หมายเลขโทรศัพท์ของลูกค้า |
|
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "16505551234",
"type": "interactive",
"interactive": {
"type": "catalog_message",
"body": {
"text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase."
},
"action": {
"name": "catalog_message",
"parameters": {
"thumbnail_product_retailer_id": "2lc20305pt"
}
},
"footer": {
"text": "Best grocery deals on WhatsApp!"
}
}
}'
{
"messaging_product": "whatsapp",
"contacts": [
{
"input": "16505551234",
"wa_id": "16505551234"
}
],
"messages": [
{
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
}
]
}
ข้อความเทมเพลตแค็ตตาล็อกเป็นข้อความเทมเพลตที่มีปุ่มสำหรับแตะเพื่อแสดงแค็ตตาล็อกสินค้าใน WhatsApp

หากต้องการส่งข้อความเทมเพลตแค็ตตาล็อก คุณต้องมีเทมเพลตแค็ตตาล็อก ดูเอกสารเทมเพลตแค็ตตาล็อกของเราเพื่อเรียนรู้วิธีการสร้างเทมเพลตดังกล่าว รวมถึงวิธีการส่งเทมเพลตแค็ตตาล็อกในข้อความเทมเพลต
ธุรกิจสามารถส่งลิงก์ไปยังแค็ตตาล็อกสินค้าทั้งหมดของตนได้โดยรวมลิงก์ wa.me เข้าไปและใส่ไว้ในข้อความ SMS มาตรฐาน เมื่อส่งข้อความ SMS แล้ว ธุรกิจสามารถใช้ preview_url (ระบุหรือไม่ก็ได้) ซึ่งตั้งค่าเป็น true ได้ เพื่อให้ข้อความแสดงชุดภาพขนาดย่อสำหรับแค็ตตาล็อกสินค้าของ URL ในสตริง body ของข้อความ
โปรดทราบว่าหากธุรกิจปิดใช้งานแค็ตตาล็อก ลิงก์ wa.me และปุ่มดูแค็ตตาล็อกในข้อความที่มีลิงก์ไปยังแค็ตตาล็อกจะแสดงข้อความว่าลิงก์แค็ตตาล็อกไม่ถูกต้อง เมื่อแตะลงไป
หากต้องการรวมลิงก์ wa.me เข้าไปด้วย ให้นำหมายเลขโทรศัพท์ของธุรกิจพร้อมกับรหัสประเทศ มาต่อท้ายสตริงต่อไปนี้
https://wa.me/c/
ตัวอย่างเช่น
https://wa.me/c/15555455657
ทั้งข้อความที่มีสินค้าหลายรายการและข้อความที่มีสินค้ารายการเดียวเป็นข้อความประเภท interactive
ตัวอย่างข้อความที่มีสินค้าหลายรายการ: | ตัวอย่างข้อความที่มีสินค้ารายการเดียว: |
เมนูที่แสดงขึ้นมาเมื่อผู้ใช้คลิกที่ “เริ่มช้อปปิ้ง”: | ตัวอย่างหน้ารายละเอียดสินค้า: |
ผู้ใช้ที่ได้รับข้อความที่มีสินค้าหลายรายการและรายการเดียวสามารถดำเนินการหลักๆ ได้ 3 อย่างดังต่อไปนี้
หากลูกค้าใช้หลายอุปกรณ์เชื่อมโยงกับบัญชี WhatsApp เดียวกัน ข้อความที่มีสินค้าหลายรายการและรายการเดียวจะได้รับการซิงค์ระหว่างอุปกรณ์ต่างๆ แต่รถเข็นช้อปปิ้งจะเป็นของอุปกรณ์แต่ละเครื่องโดยเฉพาะ โปรดดูรายละเอียดที่ประสบการณ์การใช้รถเข็นช้อปปิ้ง
ปัจจุบันคุณสามารถรับข้อความประเภทเหล่านี้ได้ในแพลตฟอร์มต่อไปนี้
2.21.100 (ข้อความที่มีสินค้าหลายรายการ) และ 2.21.210 (ข้อความที่มีสินค้ารายการเดียว)2.21.9.15 (ข้อความที่มีสินค้าหลายรายการ) และ 2.21.19 (ข้อความที่มีสินค้ารายการเดียว)หากแอพของผู้รับเป็นเวอร์ชั่นที่ไม่รองรับข้อความที่มีสินค้าหลายรายการหรือรายการเดียว ผู้รับจะได้รับข้อความที่อธิบายว่าไม่สามารถรับข้อความได้เนื่องจากใช้ WhatsApp เวอร์ชั่นเก่าแทน นอกจากนี้ ธุรกิจจะได้รับการแจ้งเตือน Webhook ที่ระบุว่าไม่สามารถส่งข้อความถึงผู้รับได้เนื่องจากผู้รับใช้ WhatsApp เวอร์ชั่นเก่า
ข้อความที่มีสินค้าหลายรายการและข้อความที่มีสินค้ารายการเดียวอาจมีลักษณะการทำงานดังต่อไปนี้
ข้อความแค็ตตาล็อก ข้อความที่มีสินค้าหลายรายการ และข้อความที่มีสินค้ารายการเดียวต้องไม่มีลักษณะการทำงานดังต่อไปนี้
ธุรกิจอาจต้องอัพเดตคุณสมบัติสินค้าในแค็ตตาล็อกของตนเอง ต่อไปนี้คือวิธีการจัดการกับข้อความที่กล่าวถึงสินค้า ทั้งนี้ขึ้นอยู่กับคุณสมบัติที่อัพเดต
| คุณสมบัติที่อัพเดต | กระบวนการอัพเดต |
|---|---|
ราคา ชื่อ คำอธิบาย และรูปภาพของสินค้า |
|
การเปลี่ยนแปลงความพร้อมจำหน่าย |
|
หลังจากดูสินค้าแล้ว ลูกค้าสามารถหยิบสินค้าใส่รถเข็นช้อปปิ้งและส่งรถเข็นนั้นไปยังธุรกิจได้ เพื่อวัตถุประสงค์ทางการค้าบน WhatsApp รถเข็นช้อปปิ้งจะมีลักษณะดังต่อไปนี้
ลูกค้าสามารถหยิบสินค้าในแค็ตตาล็อกแต่ละรายการใส่รถเข็นช้อปปิ้งได้สูงสุด 99 ชิ้น และไม่มีการจำกัดจำนวนของสินค้าแต่ละอย่างที่สามารถหยิบใส่รถเข็นได้
เมื่อส่งรถเข็นไปแล้วจะไม่สามารถแก้ไขได้อีก ลูกค้าสามารถส่งรถเข็นใหม่ได้ หากต้องการสินค้าใหม่หรือต้องการจะเปลี่ยนคำสั่งซื้อของตนเอง ธุรกิจไม่สามารถส่งรถเข็นให้ลูกค้าได้
ทั้งข้อความที่มีสินค้าหลายรายการและรายการเดียวจะช่วยให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ไม่ซับซ้อนและเหมาะกับแต่ละบุคคลได้อย่างดีเยี่ยม ซึ่งการแนะนำลูกค้าให้ไปยังสินค้าบางส่วนที่เกี่ยวข้องกับลูกค้ารายนั้นๆ มากที่สุดจะทำให้ลูกค้าได้รับประสบการณ์ที่ดีกว่าการต้องไปเลือกดูจากสินค้าคงคลังทั้งหมดของธุรกิจ
การรวมฟีเจอร์ไว้กับเครื่องมือการนำทาง เช่น NLP, การค้นหาด้วยข้อความ หรือข้อความแบบรายการและปุ่มตอบกลับ เพื่อให้ทราบถึงสิ่งที่ลูกค้าต้องการได้อย่างรวดเร็ว
แสดงแบบไดนามิกเพื่อให้สามารถปรับให้เหมาะกับลูกค้าหรือสถานการณ์ได้ ตัวอย่างเช่น คุณสามารถแสดงข้อความที่มีสินค้าหลายรายการสำหรับสินค้าที่ลูกค้าสั่งซื้อบ่อยที่สุดได้
ช่องทางที่มีประสิทธิภาพในการเพิ่มจำนวนคำสั่งซื้อ โดยระหว่างการทดสอบ ธุรกิจมีคอนเวอร์ชั่นโดยเฉลี่ยที่ 7% สำหรับข้อความที่มีสินค้าหลายรายการที่ส่งไปยังรถเข็นที่ได้รับ
ข้อความแบบอินเทอร์แอคทีฟไม่ต้องใช้เทมเพลตหรือขออนุมัติล่วงหน้า ข้อความสร้างขึ้นมาแบบเรียลไทม์และจะแสดงรายละเอียดสินค้า ราคา และระดับสต็อกล่าสุดจากสินค้าคงคลังของคุณเสมอ
ข้อความที่มีสินค้าหลายรายการเหมาะที่สุดสำหรับใช้แนะนำลูกค้าให้ไปยังกลุ่มย่อยเฉพาะของสินค้าคงคลังของธุรกิจดังเช่นกรณีต่อไปนี้
ข้อความที่มีสินค้ารายการเดียวเหมาะที่สุดสำหรับใช้แนะนำลูกค้าให้ไปยังสินค้ารายการหนึ่งโดยเฉพาะในสินค้าคงคลังของธุรกิจ โดยสามารถตอบกลับอย่างรวดเร็วจากชุดตัวเลือกแบบจำกัดดังเช่นกรณีต่อไปนี้
นอกจากนี้ คุณยังสามารถใช้ฟีเจอร์ทั้ง 2 อย่างนี้เป็นส่วนหนึ่งในขั้นตอนสำหรับเจ้าหน้าที่ได้ แต่คุณต้องสร้างเครื่องมือเพื่อให้เจ้าหน้าที่สามารถสร้างข้อความที่มีสินค้าหลายรายการหรือข้อความที่มีสินค้ารายการเดียวในเธรดได้
ก่อนจะส่งแต่ละข้อความ คุณต้องเรียกดู WhatsApp ID ของผู้รับด้วยการเรียกใช้โหนด /contacts
เราแนะนำให้คุณตั้งค่า Webhooks เพื่อรับการแจ้งเตือนเมื่อมีข้อความเข้าและสถานะข้อความ เมื่อใช้วิธีนี้ คุณจะสามารถติดตามได้ว่าข้อความถูกส่งหรือไม่ รวมถึงติดตามคำตอบจากลูกค้าได้อีกด้วย
หากต้องการส่งข้อความที่มีสินค้ารายการเดียว ให้รวมอ็อบเจ็กต์ interactive ที่มีประเภทเป็น product ที่มีส่วนประกอบดังต่อไปนี้
| อ็อบเจ็กต์ | คำอธิบาย |
|---|---|
| ระบุหรือไม่ก็ได้ อ็อบเจ็กต์ body ดูตัวเลือกทั้งหมดสำหรับอ็อบเจ็กต์ |
| ระบุหรือไม่ก็ได้ อ็อบเจ็กต์ footer ดูตัวเลือกทั้งหมดสำหรับอ็อบเจ็กต์ |
| ต้องระบุ ช่อง action ต้องระบุข้อมูลต่อไปนี้
|
เมื่อถึงขั้นตอนสุดท้าย อ็อบเจ็กต์ interactive ควรมีลักษณะดังนี้
"interactive": {
"type": "product",
"body": {
"text": "text-body-content"
},
"footer": {
"text": "text-footer-content"
},
"action": {
"catalog_id": "catalog-id",
"product_retailer_id": "product-SKU-in-catalog"
}
}หากต้องการส่งข้อความที่มีสินค้าหลายรายการ ให้รวมอ็อบเจ็กต์ interactive ที่มีประเภทเป็น product_list ที่มีส่วนประกอบดังต่อไปนี้
| อ็อบเจ็กต์ | คำอธิบาย |
|---|---|
| ต้องระบุ จะต้องกำหนด |
| ต้องระบุ อ็อบเจ็กต์ |
| ระบุหรือไม่ก็ได้ อ็อบเจ็กต์ |
| ต้องระบุ ช่อง action ต้องระบุข้อมูลต่อไปนี้
คุณสามารถใส่ข้อมูลต่อไปนี้ลงในแต่ละส่วนได้
แต่ละอ็อบเจ็กต์สินค้าจะมี |
เมื่อถึงขั้นตอนสุดท้าย อ็อบเจ็กต์ interactive ควรมีลักษณะดังนี้
"interactive":
{
"type": "product_list",
"header":{
"type": "text",
"text": "text-header-content"
},
"body":{
"text": "text-body-content"
},
"footer":{
"text":"text-footer-content"
},
"action":{
"catalog_id":"catalog-id",
"sections": [
{
"title": "the-section-title",
"product_items": [
{ "product_retailer_id": "product-SKU-in-catalog" },
{ "product_retailer_id": "product-SKU-in-catalog" },
...
]},
{
"title": "the-section-title",
"product_items": [
{ "product_retailer_id": "product-SKU-in-catalog" }
...
]},
...
]
},
}
หากไม่มีสินค้าที่ระบุในการเรียกใช้ API ข้างต้นที่ตรงกับสินค้าจากแค็ตตาล็อกบน Facebook ของธุรกิจเลย ระบบจะส่งข้อความแสดงข้อผิดพลาด และจะไม่ส่งข้อความที่มีสินค้าหลายรายการหรือรายการเดียวให้ผู้ใช้
สำหรับข้อความที่มีสินค้าหลายรายการ จะต้องมีสินค้าจากรายการสินค้าอย่างน้อย 1 รายการที่ตรงกับสินค้าจากแค็ตตาล็อกบน Facebook ของธุรกิจ ในกรณีนี้
เมื่ออ็อบเจ็กต์แบบอินเทอร์แอคทีฟสมบูรณ์ ให้นำพารามิเตอร์อื่นๆ ที่ประกอบขึ้นเป็นข้อความ ได้แก่ recipient_type, to และ type มาต่อท้าย โปรดอย่าลืมตั้งค่า type เป็น interactive
{
"recipient_type": "individual",
"to" : "whatsapp-id", // WhatsApp ID of the recipient
"type": "interactive",
"interactive":{
// The interactive object
}
}ดูพารามิเตอร์ทั่วไปที่ใช้กับข้อความทุกประเภทที่นี่
POST ไปยัง /messagesเรียกใช้ POST ไปยังตำแหน่งข้อมูล /messages โดยมีอ็อบเจ็กต์ JSON ที่คุณรวมไว้ในขั้นตอนที่ 1 และ 2 หากส่งข้อความสำเร็จ คุณจะได้รับการตอบกลับต่อไปนี้
{
"messages": [{
"id": "{message-id}"
}]
}หากต้องการส่งข้อความเทมเพลตที่มีสินค้าหลายรายการ คุณต้องมีเทมเพลตข้อความที่มีสินค้าหลายรายการ ดูเอกสารเทมเพลตข้อความที่มีสินค้าหลายรายการของเราเพื่อเรียนรู้วิธีการสร้างเทมเพลตดังกล่าว รวมถึงวิธีการส่งเทมเพลตข้อความที่มีสินค้าหลายรายการในข้อความเทมเพลต