messaging_referrals Webhook 事件參考資料

這個回呼發生在用戶已經與 Bot 有對話串，然後用戶以下列方式回到對話串：

• 跟隨含轉介參數的 m.me 連結
• 點擊 Messenger 對話廣告
• 從顧客洽談外掛程式開始或繼續對話。

如需在新的對話串中追蹤轉介，請參閱回傳事件。

若要開始接收這些事件，您需要在應用程式的 Webhook 設定中訂閱 messaging_referrals。

內容

• 範例

  • m.me 連結
  • 廣告轉介
  • 顧客洽談外掛程式
• 屬性

範例

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

廣告轉介

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

顧客洽談外掛程式

新版轉介 Webhook 事件（圖形 API 7.0 以上版本和 2020 年 11 月 2 日起的所有圖形 API 版本）

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

舊版轉介 Webhook 事件（圖形 API 6.0 以下版本，支援至 2020 年 11 月 2 日）

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

屬性

sender

recipient

referral

ads_context_data