Referencia del evento del webhook messaging_referrals

Esta devolución de llamada se producirá cuando el usuario ya tenga una conversación iniciada con el bot y acceda a dicha conversación en las siguientes situaciones:

• Al seguir un enlace m.me con un parámetro de referencia.
• Al hacer clic en un anuncio de una conversación de Messenger.
• Al iniciar o reanudar una conversación desde el plugin de chat con clientes.

Para hacer un seguimiento de las referencias en conversaciones nuevas, consulta evento de postback.

Si deseas comenzar a recibir estos eventos, debes suscribirte a messaging_referrals en la configuración del webhook de tu app.

Índice

• Ejemplos

  • Enlaces m.me
  • Referencia de anuncios
  • Plugin de chat con clientes
• Propiedades

Ejemplos

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

Referencia de anuncios

{
  "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 de chat con clientes

Nuevo evento de webhook de referencia (versión 7.0 y posteriores de la API Graph, y todas las versiones de la API Graph a partir del 2 de noviembre de 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>"
  }
}

Evento anterior de webhook de referencia (versión 6.0 o anterior de la API Graph: disponible hasta el 2 de noviembre de 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>"
  }
}

Propiedades

sender

recipient

referral

ads_context_data