Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: 18 tháng 11

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

Bạn có nhiều cách để chia sẻ sản phẩm với khách hàng.

Tin nhắn về danh mục

Tin nhắn về danh mục là tin nhắn hỗ trợ bạn 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 object is optional */
      "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

Không 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

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": "+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.

Hãy xem bài viết Mẫu danh mục để tìm hiểu cách tạo và gửi những mẫu này.

Tin nhắn chứa liên kết danh mục

Bạn 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 mình 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, bạn 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 bạn 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 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

Mẫu có nút thanh toán

Với mẫu có nút thanh toán, các doanh nghiệp ở Ấn Độ có thể giới thiệu một hoặc nhiều sản phẩm để người dùng WhatsApp ở Ấn Độ (có mã vùng quốc gia Ấn Độ) có thể mua hàng mà không phải rời khỏi ứng dụng WhatsApp.

Hãy xem bài viết Mẫu có nút thanh toán để tìm hiểu cách tạo và gửi những mẫu này.

Tin nhắn mẫu có chứa phần quay vòng thẻ file phương tiện

Với tin nhắn mẫu có chứa phần quay vòng thẻ file phương tiện, bạn có thể gửi một tin nhắn văn bản, kèm theo một tập hợp gồm tối đa 10 thẻ ở chế độ xem có thể cuộn theo chiều ngang:

Hãy xem bài viết Mẫu có chứa phần quay vòng thẻ file phương tiện để tìm hiểu cách tạo và gửi những mẫu này.

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

Tin nhắn mẫu cho Tin nhắn về nhiều sản phẩm (MPM) giới thiệu 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 tùy chỉnh thành các phần.

Hãy xem bài viết Mẫu tin nhắn về nhiều sản phẩm để tìm hiểu cách tạo và gửi những mẫu MPM này.

Tin nhắn mẫu có chứa phần quay vòng thẻ sản phẩm

Với tin nhắn mẫu có chứa phần quay vòng thẻ sản phẩm, bạn có thể gửi một tin nhắn văn bản, kèm theo một tập hợp gồm tối đa 10 thẻ sản phẩm ở chế độ xem có thể cuộn theo chiều ngang.

Hãy xem bài viết Mẫu có chứa phần quay vòng thẻ sản phẩm để tìm hiểu cách tạo và gửi những mẫu này.

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 tương tác.

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

Khách hà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 khách hà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: 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 bạn và khách hàng cho đến khi giỏ hàng được gửi đến bạn - Hãy xem phần Trải nghiệm giỏ hàng để biết chi tiết.
  3. Gửi giỏ hàng cho bạn: 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 bạn. Sau đó, bạn 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 tài khoản của họ, 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 khách hàng 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 nguyên nhân không nhận được tin nhắn là do phiên bản WhatsApp họ đang dùng đã lỗi thời. Chúng tôi cũng sẽ gửi cho bạn một thông báo webhook cho biết rằng không thể phân phối tin nhắn do khách hàng đ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 khác.
  • Được một người dùng mở lại trong cùng một cuộc trò chuyện.

Tin nhắn về nhiều sản phẩm và Tin nhắn về một sản phẩm không được:

  • 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 cuộc trò chuyện hiện có.

Giới hạn

Khác với tin nhắn về sản phẩm được gửi qua ứng dụng WhatsApp Business, tin nhắn được gửi qua API Đám mây hiện không hiển thị biểu tượng giỏ hàng trong tiêu đề đoạn chat.

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

Bạn có thể cần phải cập nhật các thuộc tính của mặt hàng trong danh mục. 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 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. Bạn gửi Tin nhắn về nhiều/một sản phẩm có chứa sản phẩm A.
  2. Bạn cập nhật các thuộc tính của sản phẩm A trên danh mục.
  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. Bạn 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. Bạn bán hết đơn vị có sẵn của sản phẩm B. Sau đó, bạn cập nhật danh mục để cho biết sản phẩm B đã hết hàng
  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 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 bạn. Đối với mục đích thương mại trên WhatsApp, giỏ hàng:

  • Là duy nhất trong đoạn chat của khách hàng/doanh nghiệp trên một thiết bị cụ thể: Chỉ được tạo một giỏ hàng trên mỗi đoạn chat giữa bạn với khách hàng 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 bạn 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 cho bạn. Sau khi được gửi đi, giỏ hàng sẽ bị xóa.

Với mỗi mặt hàng trong một 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. Bạn 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 bạn.

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

Lý do bạn nên sử dụng

Tin nhắn về nhiều sản phẩm phù hợp nhất để dẫn khách hàng đến một nhóm nhỏ cụ thể trong danh sách cung ứng của bạn, 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 để cho phép 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 để dẫn khách hàng đến một mặt hàng cụ thể trong danh sách cung ứng của bạn, đưa ra 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.

Gửi tin nhắn về sản phẩm

Trước khi gửi tin nhắn về sản phẩm, hãy làm theo hướng dẫn bắt đầu phù hợp nhất với nhu cầu của bạn:

Mọi lệnh gọi API được đề cập trong hướng dẫn này đều phải được xác thực bằng mã truy cập. Nhà phát triển có thể xác thực lệnh gọi API bằng mã truy cập được tạo trong Bảng điều khiển ứng dụng > WhatsApp > bảng điều khiển Thiết lập API. Đối tác giải pháp phải tự xác thực bằng mã truy cập cùng với quyền whatsapp_business_messaging.

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:

Thành phần bắt buộcThành phần không bắt buộc
  • Đối tượng hành động - Phải chứa cả catalog_id và product_retailer_id.
  • Đối tượng nội dung
  • Đối tượng chân trang

Hãy xem phần Tin nhắn, Đối tượng tương tác để biết đầy đủ thông tin. Đến cuối quy trình, đối tượng tương tác sẽ có dạng như sau:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product",
    "body": {
      "text": "BODY_TEXT"
    },
    "footer": {
      "text": "FOOTER_TEXT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "product_retailer_id": "ID_TEST_ITEM_1"
    }
  }
}

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:

Thành phần bắt buộcThành phần không bắt buộc
  • Đối tượng tiêu đề - Loại tiêu đề phải được đặt là văn bản. Hãy nhớ thêm đối tượng văn bản kèm theo nội dung mong muốn.
  • Đối tượng nội dung
  • Đối tượng hành động - Phải chứa catalog_id và sections.
    • Sections phải là một mảng đối tượng mô tả từng phần thông qua title và product_items.
      • Giá trị product_items của mỗi phần phải là một mảng mô tả từng sản phẩm trong phần đó thông qua product_retailer_id và số SKU của sản phẩm.
  • Đối tượng chân trang

Hãy xem phần Tin nhắn, Đối tượng tương tác để biết đầy đủ thông tin. Đến cuối quy trình, đối tượng tương tác sẽ có dạng như sau:

{
  "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" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]

        },
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]
        }
      ]
    }
  }
}

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 sản phẩm của bạn, 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 sản phẩm của bạn. 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ỏ
  • Bạn 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, to, messaging_producttype. Hãy nhớ đặt type thành interactive.

curl -X  POST https://graph.facebook.com/v21.0/FROM_PHONE_NUMBER/messages \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 - d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
  // INTERACTIVE OBJECT GOES HERE    
}'

Để biết tất cả thông số có sẵn, hãy xem Tài liệu tham khảo, Tin nhắn.

Bước 3: Gửi yêu cầu đến điểm cuối tin nhắn

Gửi yêu cầu POST đến điểm cuối /PHONE_NUMBER_ID/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:

{
  "messaging_product": "whatsapp",
  "contacts": [{
      "input": "PHONE_NUMBER",
      "wa_id": "WHATSAPP_ID",
    }]
  "messages": [{
      "id": "wamid.ID",
    }]
}

Tin nhắn mẫu cho tin nhắn về một sản phẩm

Tin nhắn mẫu cho Tin nhắn về một sản phẩm (SPM) giới thiệu một sản phẩm từ danh mục thương mại điện tử của bạn, kèm theo hình ảnh sản phẩm, tên sản phẩm và giá sản phẩm (tất cả được lấy từ sản phẩm trong danh mục của bạn) kết hợp với nội dung văn bản có thể tùy chỉnh, nội dung chân trang không bắt buộc và một nút Xem tương tác.

Hãy xem bài viết Mẫu tin nhắn về một sản phẩm để tìm hiểu cách tạo và gửi những mẫu SPM này.