Mẫu sản phẩm dành cho tính năng Nhắn tin trên Instagram

Sử dụng mẫu sản phẩm để gửi tin nhắn trên Instagram có chứa thông tin sản phẩm mà bạn đã tải lên danh mục sản phẩm . Chi tiết sản phẩm (hình ảnh, tên, giá) sẽ tự động được lấy từ danh mục sản phẩm.

Bạn có thể sử dụng mẫu sản phẩm để tạo tin nhắn có chứa một sản phẩm hoặc một thẻ quay vòng gồm các sản phẩm có thể cuộn theo chiều ngang.

Trước khi bạn bắt đầu

Hướng dẫn này giả định rằng bạn đã đọc phần Tổng quan về nền tảng Messenger, cũng như triển khai các thành phần cần thiết để gửi/nhận tin nhắn và thông báo.

Bạn sẽ cần:

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

Để gửi tin nhắn về sản phẩm cho một người dùng, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages với thuộc tính recipient.id được đặt là ID trong Instagram của người nhận tin nhắn. Thêm các thuộc tính typepayload vào đối tượng message.attachment. Đặt typetemplate, đặt thuộc tính payload.template_typeproduct và thuộc tính payload.elements là danh sách cặp khóa-giá trị ID sản phẩm.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"INSTAGRAM-SCOPED-ID"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload": {
        "template_type": "product",
        "elements": [
          {
            "id": "PRODUCT-ID"
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-GRAPH-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"  

Gửi thẻ quay vòng

Để gửi thẻ quay vòng sản phẩm, hãy thêm các cặp khóa-giá trị sản phẩm khác vào thuộc tính payload.elements. Bạn có thể thêm tối đa 10 sản phẩm vào yêu cầu của mình.

...
      "payload": {
        "template_type": "product",
        "elements": [
          {
            "id": "PRODUCT-ID-1"
          },
          {
            "id": "PRODUCT-ID-2"
          },
          {
            "id": "PRODUCT-ID-3"
          }
        ]
      }
...

Khi thành công, ứng dụng của bạn sẽ nhận được đối tượng JSON dưới đây chứa ID người nhận và ID tin nhắn.

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}  

Gửi yêu cầu đồng ý

Để gửi yêu cầu đồng ý nhận tin nhắn marketing định kỳ cho một người dùng, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages với thuộc tính recipient.id được đặt là ID trong Instagram của người nhận tin nhắn. Trong thuộc tính messageattachment.payload, hãy đặt template_typenotification_messages. Trong thuộc tính payload.elements, hãy thêm image_url, title, payload, notification_message_frequencynotification_messages_cta_text.

curl -X POST -H "Content-Type:application/json" -d '{
  "recipient": {
    "id": "INSTAGRAM-SCOPED-ID"
  },
  "message": {
    "attachment": {
      "type": "template",
      "payload": {
        "template_type": "notification_messages",
        "elements": [
          {
            "image_url": "IMAGE-URL",
            "title": "TEXT-TO-DISPLAY",
            "payload": "INFORMATION-ABOUT-THIS-MESSAGE",
            "notification_messages_frequency": "DAILY",
            "notification_messages_cta_text": "GET_UPDATES"
          }
        ]
      }
    }
  }
}' "https://graph.intern.facebook.com/LATEST-GRAPH-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Tài liệu tham khảo về thành phần của tin nhắn thông báo

Thuộc tínhGiá trị

image_url

chuỗi

URL của hình ảnh sẽ hiển thị trong mẫu

notification_messages_cta_text

enum { ALLOW, FREQUENCY, GET, GET_UPDATES, OPT_IN, SIGN_UP }

Văn bản xuất hiện trên nút kêu gọi hành động được đặt bằng cách sử dụng một trong các giá trị sau:

  • ALLOW - đặt văn bản trên nút chọn nhận tin nhắn thành Cho phép nhắn tin
  • FREQUENCY - đặt văn bản trên nút chọn nhận tin nhắn thành Nhận tin nhắn hàng ngày
  • GET - đặt văn bản trên nút chọn nhận tin nhắn thành Nhận tin nhắn
  • GET_UPDATES - đặt văn bản trên nút chọn nhận tin nhắn thành Nhận thông tin mới. Đây cũng là cài đặt mặc định nếu bạn không đặt notification_messages_cta_text
  • OPT_IN - đặt văn bản trên nút chọn nhận tin nhắn thành Chọn nhận tin nhắn
  • SIGN_UP - đặt văn bản trên nút chọn nhận tin nhắn thành Đăng ký nhận tin nhắn

notification_messages_frequency

enum { DAILY, WEEKLY, MONTHLY }

Tần suất nhắn tin của yêu cầu đồng ý nhận thông báo định kỳ này.

  • DAILY - Chọn nhận 1 thông báo mỗi 24 giờ trong vòng 6 tháng
  • WEEKLY - Chọn nhận 1 thông báo mỗi tuần (7 ngày) trong vòng 9 tháng
  • MONTHLY - Chọn nhận 1 thông báo mỗi tháng trong vòng 12 tháng

payload

chuỗi

Loại thông báo định kỳ - chẳng hạn như tin nhắn quảng cáo hoặc tin nhắn về bản phát hành sản phẩm - dành cho yêu cầu đồng ý nhận thông báo định kỳ này

title

chuỗi

Tiêu đề sẽ hiển thị trong mẫu, không được vượt quá 65 ký tự. Nếu không có giá trị nào được chỉ định, giá trị này sẽ mặc định là "Thông tin mới và khuyến mãi"

Bước tiếp theo

Giờ đây, người dùng đã chọn nhận tin nhắn marketing định kỳ, hãy tìm hiểu cách gửi tin nhắn marketing.