messaging_referrals Webhooks 이벤트 참고 자료

이 콜백은 사용자에게 이미 봇과의 스레드가 있고 사용자가 다음 경로에서 이 스레드로 이동하는 경우에 발생합니다.

• 리퍼럴 매개변수가 있는 m.me 링크를 따라가는 경우
• Messenger 대화 광고를 클릭하는 경우
• 고객 채팅 플러그인에서 대화를 시작하거나 재개하는 경우

새로운 스레드에서 리퍼럴을 추적하는 경우 Postback 이벤트를 참조하세요.

이러한 이벤트를 수신하기 시작하려면 앱의 Webhooks 설정에서 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 이벤트(2020년 11월 2일부터 그래프 API v7.0 이상 및 모든 그래프 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 v6.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