messaging_referrals Webhook Event Reference

This callback will occur when the user already has a thread with the bot and user comes to the thread from:

• Following an m.me link with a referral parameter
• Clicking on a Messenger Conversation Ad

For tracking referrals in new threads, refer to Postback Event.

To start receiving these events you need to subscribe to messaging_referrals in the webhook settings for your app.

Contents

• Examples
  • m.me Links
  • Ad Referral
• Properties

Examples

m.me Link

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

Ad Referral

{   "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>,       "flow_id": <ID_OF_THE_PARTNER_APP_WELCOME_MESSAGE_FLOW>     }   } }

For more information about the flow ID, please refer to Welcome Message Flows.

Properties

sender

recipient

referral

ads_context_data