Tài liệu tham khảo về sự kiện webhook messaging_referrals

Lệnh gọi lại này sẽ diễn ra khi người dùng đã có chuỗi trò chuyện với bot và người dùng tham gia chuỗi trò chuyện do:

• Truy cập liên kết m.me có thông số giới thiệu
• Nhấp vào Quảng cáo mở ra cuộc trò chuyện trên Messenger
• Bắt đầu hoặc tiếp tục cuộc trò chuyện từ plugin chat với khách hàng.

Để theo dõi lượt giới thiệu trong chuỗi trò chuyện mới, hãy tham khảo Sự kiện đăng lại.

Để bắt đầu nhận các sự kiện này, bạn cần đăng ký messaging_referrals trong phần cài đặt webhook cho ứng dụng của mình.

Nội dung

• Ví dụ

  • Liên kết m.me
  • Lượt giới thiệu quảng cáo
  • Plugin chat với khách hàng
• Thuộc tính

Ví dụ

Liên kết m.me

{
  "sender": {
    "id": "<PSID>"
  },
  "recipient": {
    "id": "<PAGE_ID>"
  },
  "timestamp": 1458692752478,
  "referral": {
    "ref": <REF_DATA_PASSED_IN_M.ME_PARAM>,
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

Lượt giới thiệu quảng cáo

{
  "sender": {
    "id": "<PSID>"
  },
  "recipient": {
    "id": "<PAGE_ID>"
  },
  "timestamp": 1458692752478,
  "referral": {
    "ref": <REF_DATA_IF_SPECIFIED_IN_THE_AD>,
    "ad_id": <ID_OF_THE_AD>,
    "source": "ADS",
    "type": "OPEN_THREAD",
    "ads_context_data": {
      "ad_title": <TITLE_OF_THE_AD>,
      "photo_url": <URL_OF_THE_IMAGE_FROM_AD_THE_USER_IS_INTERESTED_IN>,
      "video_url": <THUMBNAIL_URL_OF_THE_VIDEO_FROM_THE_AD>,
      "post_id": <ID_OF_THE_POST>,
      "product_id": <PRODUCT_ID>
    }
  }
}

Plugin chat với khách hàng

Sự kiện webhook giới thiệu mới (API Đồ thị phiên bản 7.0 trở lên và mọi phiên bản API Đồ thị kể từ ngày 02/11/2020)

{
  "sender":{
    "user_ref":"<USER_REF>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp": 1458692752478,
  "referral": {
     "ref": "<REF_DATA_PASSED_IN_CODE>",
     "source": "CUSTOMER_CHAT_PLUGIN",
     "type": "OPEN_THREAD",
     "referer_uri": "<WEBSITE_URL>"
  }
}

Sự kiện webhook giới thiệu cũ (API Đồ thị phiên bản 6.0 trở xuống – Hoạt động cho đến ngày 02/11/2020)

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp": 1458692752478,
  "referral": {
     "ref": "<REF_DATA_PASSED_IN_CODE>",
     "source": "CUSTOMER_CHAT_PLUGIN",
     "type": "OPEN_THREAD",
     "referer_uri": "<WEBSITE_URL>"
  }
}

Thuộc tính

sender

recipient

referral

ads_context_data