Chúng tôi sẽ ngừng cung cấp API Tại chỗ. Hãy tham khảo tài liệu về việc Ngừng cung cấp API Tại chỗ để biết chi tiết, đồng thời tìm hiểu cách chuyển sang API Đám mây thế hệ tiếp theo của chúng tôi.
Doanh nghiệp có thể chia sẻ sản phẩm với khách hàng theo nhiều cách sau đây:
Tin nhắn về danh mục là tin nhắn dạng tự do để bạn có thể giới thiệu toàn bộ danh mục sản phẩm trong WhatsApp.
Tin nhắn về danh mục hiển thị hình ảnh tiêu đề chứa hình thu nhỏ sản phẩm mà bạn chọn, văn bản nội dung tùy chỉnh, tiều đề văn bản cố định, tiêu đề phụ văn bản cố định và nút Xem danh mục.

Khi khách hàng nhấn vào nút Xem danh mục, danh mục sản phẩm của bạn sẽ hiển thị trong WhatsApp.

Bạn phải tải danh sách cung ứng lên Meta trong một danh mục thương mại điện tử được kết nối với Tài khoản WhatsApp Business của mình.
Sử dụng điểm cuối Số điện thoại WhatsApp Business > Tin nhắn để gửi tin nhắn về danh mục.
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>"
}
}| Phần giữ chỗ | Mô tả | Giá trị mẫu |
|---|---|---|
Chuỗi | Bắt buộc. Văn bản sẽ xuất hiện trong nội dung tin nhắn. Tối đa 1.024 ký tự. |
|
Chuỗi | Không bắt buộc. Văn bản sẽ xuất hiện ở chân trang tin nhắn. Tối đa 60 ký tự. |
|
Chuỗi | Bắt buộc. Số SKU của mặt hàng. Được gắn nhãn là ID nội dung trong Công cụ quản lý thương mại. Hình thu nhỏ của mặt hàng này sẽ được dùng làm hình ảnh tiêu đề của tin nhắn. Nếu đối tượng |
|
Chuỗi | Số điện thoại của khách hàng. |
|
{
"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"
}
]
}
Tin nhắn mẫu về danh mục là tin nhắn mẫu có chứa nút hiển thị danh mục sản phẩm của bạn trong WhatsApp khi được nhấn vào.

Để gửi tin nhắn mẫu về danh mục, bạn cần có mẫu danh mục. Hãy xem tài liệu về Mẫu danh mục của chúng tôi để tìm hiểu cách tạo những mẫu này và cách gửi chúng trong tin nhắn mẫu.
Doanh nghiệp có thể gửi một liên kết dẫn đến toàn bộ danh mục sản phẩm của họ bằng cách tạo liên kết wa.me rồi thêm liên kết đó vào một tin nhắn văn bản tiêu chuẩn. Khi gửi tin nhắn văn bản, doanh nghiệp có thể sử dụng preview_url không bắt buộc được đặt thành true để tin nhắn hiển thị một nhóm hình thu nhỏ danh mục sản phẩm của bất kỳ URL nào trong chuỗi body tin nhắn.
Lưu ý rằng nếu doanh nghiệp vô hiệu hóa danh mục, liên kết wa.me và nút Xem danh mục trong tin nhắn chứa liên kết danh mục sẽ hiển thị thông báo Liên kết danh mục không hợp lệ khi được nhấn vào.
Để tạo liên kết wa.me, hãy thêm số điện thoại của doanh nghiệp (bao gồm cả mã quốc gia) vào cuối chuỗi sau đây:
https://wa.me/c/
Ví dụ:
https://wa.me/c/15555455657
Cả Tin nhắn về nhiều sản phẩm lẫn Tin nhắn về một sản phẩm đều thuộc loại tin nhắn interactive.
Ví dụ cho Tin nhắn về nhiều sản phẩm: | Ví dụ cho Tin nhắn về một sản phẩm: |
Menu được kích hoạt khi người dùng nhấp vào Bắt đầu mua sắm: | Ví dụ cho Trang chi tiết sản phẩm: |
Người dùng nhận được Tin nhắn về nhiều sản phẩm và Tin nhắn về một sản phẩm có thể thực hiện 3 hành động chính sau đây:
Nếu khách hàng có Nhiều thiết bị liên kết với cùng một tài khoản WhatsApp, Tin nhắn về nhiều sản phẩm và Tin nhắn về một sản phẩm sẽ được đồng bộ giữa các thiết bị. Tuy nhiên, giỏ hàng sẽ có trên từng thiết bị cụ thể. Hãy xem phần Trải nghiệm giỏ hàng để biết chi tiết.
Hiện tại, các loại tin nhắn này có thể nhận được trên những nền tảng sau đây:
2.21.100 (Tin nhắn về nhiều sản phẩm) và 2.21.210 (Tin nhắn về một sản phẩm).2.21.9.15 (Tin nhắn về nhiều sản phẩm) và 2.21.19 (Tin nhắn về một sản phẩm).Nếu phiên bản ứng dụng của người nhận không hỗ trợ Tin nhắn về nhiều/một sản phẩm, họ sẽ nhận được tin nhắn giải thích rằng họ không nhận được tin nhắn vì đang dùng phiên bản WhatsApp đã lỗi thời. Doanh nghiệp cũng sẽ nhận được thông báo webhook cho biết không thể phân phối tin nhắn do người nhận đang dùng phiên bản WhatsApp đã lỗi thời.
Tin nhắn về nhiều sản phẩm và Tin nhắn về một sản phẩm có thể:
Tin nhắn về danh mục, Tin nhắn về nhiều sản phẩm và Tin nhắn về một sản phẩm không được phép:
Doanh nghiệp có thể cần cập nhật thuộc tính của các mặt hàng trong danh mục của họ. Tùy thuộc vào thuộc tính được cập nhật, sau đây là cách chúng tôi xử lý mọi tin nhắn nhắc đến sản phẩm đó:
| Thuộc tính đã cập nhật | Quy trình cập nhật |
|---|---|
Giá, tên, nội dung mô tả và hình ảnh của sản phẩm. |
|
Thay đổi về tình trạng hàng |
|
Khách hàng có thể thêm sản phẩm vào giỏ hàng của họ sau khi xem và gửi giỏ hàng đó cho doanh nghiệp. Đối với mục đích thương mại trên WhatsApp, giỏ hàng:
Với mỗi mặt hàng trong danh mục, khách hàng có thể thêm tối đa 99 đơn vị vào giỏ hàng. Tuy nhiên, khách hàng có thể thêm các mặt hàng khác nhau vào giỏ hàng với số lượng không giới hạn.
Sau khi gửi đi, khách hàng không thể chỉnh sửa giỏ hàng nữa. Nếu cần mặt hàng mới hay muốn thay đổi đơn đặt hàng, khách hàng có thể gửi giỏ hàng mới. Doanh nghiệp không thể gửi giỏ hàng cho khách hàng.
Cả Tin nhắn về nhiều sản phẩm lẫn Tin nhắn về một sản phẩm đều mang đến trải nghiệm tốt nhất cho người dùng. Trải nghiệm này đơn giản, dành riêng cho cá nhân và hiệu quả hơn khi dẫn khách hàng đến một nhóm nhỏ các mặt hàng phù hợp nhất với họ, thay vì lướt xem toàn bộ danh sách cung ứng của doanh nghiệp.
Kết hợp những tính năng này với các công cụ điều hướng - ví dụ như xử lý ngôn ngữ tự nhiên (NLP), tìm kiếm văn bản hoặc Tin nhắn có chứa danh sách và Nút Trả lời - để chuyển đến nội dung khách hàng đang tìm kiếm một cách nhanh chóng.
Được điền tự động để có thể cá nhân hóa theo khách hàng hoặc tình huống. Ví dụ: bạn có thể hiển thị Tin nhắn về nhiều sản phẩm chứa các mặt hàng mà một khách hàng đặt thường xuyên nhất.
Một kênh hiệu quả cao để tăng lượng đơn đặt hàng. Trong quá trình thử nghiệm, các doanh nghiệp có tỷ lệ chuyển đổi trung bình là 7% từ Tin nhắn về nhiều sản phẩm đã gửi sang giỏ hàng.
Tin nhắn tương tác không cần có mẫu hoặc phê duyệt trước. Tin nhắn được tạo trong thời gian thực và sẽ luôn phản ánh thông tin chi tiết, giá và mức tồn kho mới nhất của mặt hàng trong danh sách cung ứng của bạn.
Tin nhắn về nhiều sản phẩm phù hợp nhất để hướng khách hàng đến một nhóm nhỏ cụ thể trong danh sách cung ứng của doanh nghiệp, chẳng hạn như:
Tin nhắn về một sản phẩm phù hợp nhất để hướng khách hàng đến một mặt hàng cụ thể trong danh sách cung ứng của doanh nghiệp, cung cấp câu trả lời nhanh từ một nhóm tùy chọn giới hạn, chẳng hạn như:
Ngoài ra, bạn có thể sử dụng cả hai tính năng trong quy trình dành cho nhân viên. Tuy nhiên, bạn cần xây dựng công cụ để cho phép nhân viên tạo Tin nhắn về nhiều/một sản phẩm trong chuỗi trò chuyện.
Trước khi gửi mỗi tin nhắn, bạn cần lấy ID WhatsApp của người nhận bằng lệnh gọi đến nút /contacts.
Bạn nên thiết lập webhooks để nhận trạng thái tin nhắn và thông báo tin nhắn đến. Bằng cách này, bạn có thể theo dõi liệu tin nhắn đã được gửi đi hay chưa cũng như xem câu trả lời của khách hàng.
Để gửi Tin nhắn về một sản phẩm, hãy tạo một đối tượng interactive thuộc loại product có các thành phần sau đây:
| Đối tượng | Mô tả |
|---|---|
| Không bắt buộc. Đối tượng nội dung. Xem tất cả tùy chọn cho đối tượng |
| Không bắt buộc. Đối tượng chân trang. Xem tất cả tùy chọn cho đối tượng |
| Bắt buộc. Trường hành động phải bao gồm:
|
Cuối cùng, đối tượng tương tác sẽ có dạng như sau:
"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"
}
}Để gửi Tin nhắn về nhiều sản phẩm, hãy tạo một đối tượng interactive thuộc loại product_list có các thành phần sau đây:
| Đối tượng | Mô tả |
|---|---|
| Bắt buộc.
|
| Bắt buộc. Đối tượng |
| Không bắt buộc. Đối tượng |
| Bắt buộc. Trường hành động phải bao gồm:
Trong mỗi phần, bạn có thể bao gồm những thông tin sau đây:
Mỗi đối tượng sản phẩm chứa một |
Cuối cùng, đối tượng interactive sẽ có dạng như sau:
"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" }
...
]},
...
]
},
}
Nếu các mặt hàng được cung cấp trong lệnh gọi API phía trên không khớp với sản phẩm nào trong danh mục trên Facebook của doanh nghiệp, hệ thống sẽ gửi cho người dùng thông báo lỗi chứ không gửi Tin nhắn về nhiều/một sản phẩm.
Đối với Tin nhắn về nhiều sản phẩm, ít nhất một mặt hàng trong danh sách sản phẩm phải khớp với một mặt hàng trong Danh mục trên Facebook của doanh nghiệp. Trong trường hợp này:
Sau khi đối tượng tương tác hoàn tất, hãy thêm các thông số khác của tin nhắn: recipient_type, to và type. Hãy nhớ đặt type thành interactive.
{
"recipient_type": "individual",
"to" : "whatsapp-id", // WhatsApp ID of the recipient
"type": "interactive",
"interactive":{
// The interactive object
}
}Xem các thông số chung cho mọi loại tin nhắn tại đây.
POST đến /messagesThực hiện lệnh gọi POST đến điểm cuối /messages kèm theo đối tượng JSON bạn đã tạo ở bước 1 và 2. Nếu tin nhắn được gửi thành công, bạn sẽ nhận được phản hồi sau đây:
{
"messages": [{
"id": "{message-id}"
}]
}Để gửi tin nhắn mẫu về nhiều sản phẩm, bạn cần có mẫu tin nhắn về nhiều sản phẩm. Hãy xem tài liệu của chúng tôi liên quan đến Mẫu tin nhắn về nhiều sản phẩm để tìm hiểu cách tạo những mẫu này và cách gửi chúng trong tin nhắn mẫu.