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.

Chia sẻ sản phẩm với khách hàng

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 – Tin nhắn dạng tự do 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.
  • Tin nhắn mẫu về danh mục – 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.
  • Tin nhắn chứa liên kết danh mục – Tin nhắn có chứa hình thu nhỏ của danh mục và một liên kết dẫn đến toàn bộ danh mục sản phẩm.
  • Tin nhắn về sản phẩm – Tin nhắn có chứa thông tin về một sản phẩm hoặc tối đa 30 sản phẩm trong danh mục sản phẩm của bạn.
  • Tin nhắn mẫu về nhiều sản phẩm – Tin nhắn mẫu có chứa thông tin về tối đa 30 sản phẩm từ danh mục thương mại điện tử của bạn (được sắp xếp thành tối đa 10 phần) trong một tin nhắn.

Tin nhắn về danh mục

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.

Yêu cầu

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.

Cú pháp yêu cầu

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

Nội dung yêu cầu POST

{
  "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>"
  }
}

Thuộc tính

Phần giữ chỗMô tảGiá trị mẫu

<BODY_TEXT>

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ự.

Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase.

<FOOTER_TEXT>

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ự.

Best grocery deals on WhatsApp!

<THUMBNAIL_PRODUCT_RETAILER_ID>

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 parameters bị bỏ qua, hình ảnh sản phẩm của mặt hàng đầu tiên trong danh mục của bạn sẽ được sử dụng.

2lc20305pt

<TO>

Chuỗi

Số điện thoại của khách hàng.

16505551234

Yêu cầu mẫu

{
  "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!"
    }
  }
}'

Phản hồi mẫu

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
    }
  ]
}

Tin nhắn mẫu về danh mục

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.

Tin nhắn về liên kết danh mục

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

Tin nhắn về sản phẩm

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:

Tổng quan

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:

  1. Xem sản phẩm: Khách hàng có thể xem danh sách các sản phẩm hoặc chỉ một sản phẩm. Mỗi khi người dùng nhấp vào một mặt hàng cụ thể, chúng tôi sẽ tìm nạp thông tin mới nhất của sản phẩm và hiển thị sản phẩm đó theo định dạng Trang chi tiết sản phẩm (PDP). Hiện tại, PDP chỉ hỗ trợ hình ảnh sản phẩm - mọi video và/hoặc file GIF được thêm vào sản phẩm sẽ không hiển thị trên PDP.
  2. Thêm sản phẩm vào giỏ hàng: Người dùng có thể thêm sản phẩm vào giỏ hàng hoặc sửa số lượng ngay trong danh sách hay trên trang chi tiết sản phẩm. Mỗi khi người dùng thêm một sản phẩm vào giỏ hàng, chúng tôi sẽ tìm nạp thông tin mới nhất của mặt hàng đó. Nếu bất kỳ mặt hàng nào có trạng thái thay đổi, chúng tôi sẽ hiển thị hộp thoại với nội dung "Một hoặc nhiều mục trong giỏ hàng của bạn đã được cập nhật" - Hãy xem phần Thông tin mới về sản phẩm để biết thêm thông tin. Giỏ hàng vẫn tồn tại trong đoạn chat giữa doanh nghiệp và khách hàng cho đến khi giỏ hàng được gửi đến doanh nghiệp - Hãy xem phần Trải nghiệm giỏ hàng để biết chi tiết.
  3. Gửi giỏ hàng cho doanh nghiệp: Sau khi thêm tất cả những mặt hàng cần thiết, khách hàng có thể gửi giỏ hàng cho doanh nghiệp mà họ đang nhắn tin. Sau đó, doanh nghiệp có thể xác định các bước tiếp theo, chẳng hạn như yêu cầu thông tin giao hàng hoặc đưa ra các lựa chọn thanh toán.

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:

  • iOS: 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).
  • Android: 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).
  • Web: Ứng dụng web hỗ trợ những tính năng này đã ra mắt.

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.

Hành vi dự kiến đối với tin nhắn

Tin nhắn về nhiều sản phẩm và Tin nhắn về một sản phẩm có thể:

  • Được một người dùng chuyển tiếp cho người dùng khác.
  • Được một người dùng mở lại trong cùng một đoạn chat.

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:

  • Gửi dưới dạng thông báo. Chỉ có thể gửi các loại tin nhắn này trong đoạn chat hiện có.

Thông tin mới về sản phẩm

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ậtQuy trình cập nhật

Giá, tên, nội dung mô tả và hình ảnh của sản phẩm.

  1. Doanh nghiệp gửi Tin nhắn về nhiều/một sản phẩm có chứa sản phẩm A.
  2. Doanh nghiệp này cập nhật các thuộc tính của sản phẩm A trên danh mục của họ.
  3. Những màn hình hiển thị sản phẩm đó sẽ được cập nhật ngay khi ứng dụng của khách hàng biết về sự thay đổi từ máy chủ.

Thay đổi về tình trạng hàng

  1. Doanh nghiệp gửi cho khách hàng Tin nhắn về nhiều/một sản phẩm có chứa sản phẩm B.
  2. Doanh nghiệp này bán hết đơn vị có sẵn của sản phẩm B. Sau đó, doanh nghiệp này cập nhật danh mục của họ để cho biết rằng sản phẩm B không còn nữa
  3. Nếu khách hàng đã thêm sản phẩm B vào giỏ hàng, mặt hàng đó sẽ bị gỡ khỏi giỏ hàng. Giỏ hàng hiển thị hộp thoại với nội dung "Một hoặc nhiều mục trong giỏ hàng của bạn đã được cập nhật".
  4. Nếu khách hàng chưa thêm sản phẩm B vào giỏ hàng, Tin nhắn về nhiều/một sản phẩm hiện sẽ hiển thị mặt hàng đó là không có sẵn.

Trải nghiệm giỏ 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:

  • Chỉ có trong đoạn chat của một người/doanh nghiệp trên một thiết bị cụ thể: Chỉ một giỏ hàng được tạo trên mỗi đoạn chat giữa khách hàng với doanh nghiệp và giỏ hàng không tồn tại trên nhiều thiết bị. Sau khi giỏ hàng được gửi đi, khách hàng có thể mở một giỏ hàng khác với doanh nghiệp và bắt đầu lại quy trình.
  • Không có ngày hết hạn: Giỏ hàng tồn tại trong đoạn chat cho đến khi được gửi đến doanh nghiệp. Sau khi được gửi đi, giỏ hàng sẽ bị xóa.

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.

Ví dụ về trải nghiệm giỏ hàng và hành vi dự kiến liên quan đến thay đổi về trạng thái mặt hàng.

Lý do bạn nên sử dụ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.

Đơn giản và hiệu quả

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á nhân

Đượ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.

Kết quả kinh doanh

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.

Không có mẫu

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.

Khi nào bạn nên sử dụng

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ư:

  • Mua sắm qua hình thức trò chuyện. Ví dụ: sử dụng chức năng tìm kiếm để hỗ trợ khách hàng nhập danh sách mua sắm và gửi phản hồi bằng Tin nhắn về nhiều sản phẩm.
  • Điều hướng đến một hạng mục cụ thể. Ví dụ: quần áo thể thao.
  • Ưu đãi hoặc đề xuất dành riêng cho từng người.
  • Đặt lại các mặt hàng đã đặt trước đây. Ví dụ: người dùng có thể đặt lại đơn đặt hàng mang đi thông thường có dưới 30 mặt hàng.

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ư:

  • Trả lời yêu cầu cụ thể của khách hàng.
  • Cung cấp đề xuất.
  • Đặt lại một mặt hàng trước đây.

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.

Bắt đầu

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.

Bước 1: Tạo đối tượng tương tác

Tin nhắn về một sản phẩm

Để 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ượngMô tả

body

Không bắt buộc.

Đối tượng nội dung. Xem tất cả tùy chọn cho đối tượng body.

footer

Không bắt buộc.

Đối tượng chân trang. Xem tất cả tùy chọn cho đối tượng footer.

action

Bắt buộc.

Trường hành động phải bao gồm:

  • catalog_id: ID của danh mục bạn muốn sử dụng cho tin nhắn này. Hãy truy xuất ID này qua Công cụ quản lý thương mại.
  • product_retailer_id: Mã nhận dạng duy nhất của sản phẩm.

Xem tất cả tùy chọn cho đối tượng action.

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"
    }
}

Tin nhắn về nhiều sản phẩm

Để 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ượngMô tả

header

Bắt buộc.

type của tiêu đề phải được đặt là text. Hãy nhớ thêm đối tượng text kèm theo nội dung mong muốn. Xem tất cả trường header có sẵn.

body

Bắt buộc.

Đối tượng body. Xem tất cả tùy chọn cho đối tượng body.

footer

Không bắt buộc.

Đối tượng footer. Xem tất cả tùy chọn cho đối tượng footer.

action

Bắt buộc.

Trường hành động phải bao gồm:

  • catalog_id: ID của danh mục bạn muốn sử dụng cho tin nhắn này. Hãy truy xuất ID này qua Công cụ quản lý thương mại.
  • sections: Mảng đối tượng phần. Bạn phải có ít nhất một phần.

Trong mỗi phần, bạn có thể bao gồm những thông tin sau đây:

  • title: Thêm tiêu đề cho mỗi phần nếu bạn định sử dụng nhiều phần.
  • product_items: Mảng đối tượng sản phẩm sẽ hiển thị.

Mỗi đối tượng sản phẩm chứa một product_retailer_id tương ứng với mã nhận dạng duy nhất của sản phẩm. Hãy truy xuất ID này qua Công cụ quản lý thương mại. Xem tất cả tùy chọn cho đối tượng action.

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" }
                           ...
              ]},
               ...
       ]
     },  
    }

Mặt hàng bị thiếu

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:

  • Tin nhắn được gửi thành công,
  • Các mặt hàng không khớp sẽ bị bỏ và
  • Doanh nghiệp nhận được thông báo lỗi yêu cầu cập nhật danh mục.

Bước 2: Thêm thông số tin nhắn chung

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, totype. 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.

Bước 3: Thực hiện lệnh gọi POST đến /messages

Thự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}"
  }]
  }

Tin nhắn mẫu về nhiều sản phẩm

Để 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.