Nền tảng Messenger

Tài liệu tham khảo về Webhooks messaging_postbacks

Tài liệu này giải thích về phần tải dữ liệu JSON mà máy chủ webhooks của bạn sẽ nhận được khi hệ thống kích hoạt sự kiện webhook yêu cầu đăng lại tin nhắn. Hệ thống sẽ kích hoạt sự kiện webhook yêu cầu đăng lại khi người dùng nhấp vào nút yêu cầu đăng lại, nút Bắt đầu hoặc mục menu cố định.

Thông báo mẫu

Dưới đây là ví dụ về phần tải dữ liệu JSON mà hệ thống sẽ gửi đến máy chủ webhooks của bạn.

{
  "field": "messaging_postbacks",
  "value": {
    "sender": {
      "user_ref": "USER-REF-ID"
    },
    "recipient": {
      "id": "PAGE-ID"
    },
    "timestamp": "1527459824",
    "postback": {
      "mid": "m_MESSAGE-ID",
      "title": "TITLE-FOR-THE-CTA",
      "payload": "USER-DEFINED-PAYLOAD",
      "referral": {
        "ref": "USER-DEFINED-REFERRAL-PARAM",
        "source": "SHORT-URL",
        "type": "OPEN_THREAD"
      }
    }
  }
}

Thuộc tính JSON

Tất cả thuộc tính JSON trong thông báo webhook đều ở dạng chuỗi.

Thuộc tínhMô tả

postback.mid

ID của tin nhắn

postback.payload

Thông tin được xác định trong thông số payload CTA. Thông tin này chỉ được đưa vào thông báo webhook gửi đến ứng dụng đã gửi tin nhắn cho người đó.

postback.referral

Thông tin về hành động mà người đó đã thực hiện để tham gia cuộc trò chuyện.

Thông tin thuộc tính referral chỉ được đưa vào thông báo webhook khi một người bắt đầu cuộc trò chuyện bằng một trong các phương thức dưới đây, sau đó nhấp vào nút CTA, chẳng hạn như nút Bắt đầu:

  • Plugin chat
  • Liên kết m.me
  • Quảng cáo click đến Messenger
  • Mã QR cho Messenger
  • Màn hình chào mừng

postback.referral.ref

Dữ liệu tùy ý được chuyển ban đầu qua thông số ref đã thêm vào liên kết m.me. Chỉ hỗ trợ các ký tự chữ và số, cũng như "-", "_" và "="

postback.referral.source

URL của tham chiếu này. Đối với liên kết m.me, giá trị của nguồn là “SHORTLINK”. Đối với tham chiếu từ Quảng cáo cuộc trò chuyện trên Messenger, giá trị của nguồn là "ADS"

postback.referral.type

Thông tin nhận dạng cho tham chiếu. Đối với tham chiếu xuất phát từ liên kết m.me, thông tin nhận dạng sẽ luôn là "OPEN_THREAD".

postback.title

Tiêu đề của nút Kêu gọi hành động (CTA) mà người dùng nhấp vào

recipient.id

ID Trang Facebook của bạn

sender.user_ref

ID tham chiếu của người dùng đã thực hiện một hành động - chẳng hạn như nhấp vào nút Bắt đầu, Plugin chat hoặc mục Menu cố định - và đã gửi tin nhắn

timestamp

Nhãn thời gian Unix của ngày mà hệ thống gửi thông báo webhook đến máy chủ của bạn

Xem thêm

Tài liệu khác dành cho nhà phát triển để hiểu rõ hơn về các khái niệm được nêu trong tài liệu hướng dẫn Webhooks yêu cầu đăng lại tin nhắn này.