Referencia de eventos del webhook `messaging_referrals`

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

Siguiendo un enlace m.me con un parámetro de referencia.
Haciendo clic en un anuncio de conversación de Messenger.
Iniciando o reanudando una conversación desde el plugin de chat con clientes.

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

Para empezar a recibir estos eventos, tienes que suscribirte a messaging_referrals en la configuración de webhooks de tu aplicación.

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 anuncio

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

Cambio de última hora (5 de mayo de 2020)

El evento de webhook messaging_referrals de la API Graph v7.0 o una posterior del plugin de chat no devolverá el campo sender.id. Devolverá el nuevo campo sender.user_ref. Estos cambios se aplicarán a todas las versiones de la API Graph anteriores a partir del 2 de noviembre de 2020.

Nuevo evento del webhook de referencia (API Graph 7.0 o posterior y todas las versiones de la API Graph disponibles 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 del webhook de referencia anterior (API Graph 6.0 o anterior, 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`

Propiedad	Tipo	Descripción
`id`	Cadena	PSID del usuario que activó el evento del webhook.
`user_ref`	Cadena	Valor user_ref del usuario que activó el evento del webhook. Solo está disponible para eventos del webhook del plugin de chat.

`recipient`

Propiedad	Tipo	Descripción
`id`	Cadena	Identificador de la página.

`referral`

Propiedad	Tipo	Descripción
`source`	Cadena	Origen de la referencia. Valores admitidos: `ADS` `SHORTLINK` `CUSTOMER_CHAT_PLUGIN`
`type`	Cadena	Tipo de referencia. Actualmente admite `OPEN_THREAD`.
`ref`	Cadena	Atributo opcional `ref` establecido en la referencia. Solo se admiten caracteres alfanuméricos, “=”, “-” y “_”.
`referer_uri`	Cadena	URI del sitio donde se ha enviado el mensaje en el plugin de chat de Facebook.
`is_guest_user`	Cadena	Una marca que indica si el usuario es un usuario invitado procedente del plugin de chat de Facebook.
`ads_context_data`	Objeto	Datos con información sobre el anuncio de clic a Messenger desde el que el usuario ha iniciado la conversación.

`ads_context_data`

Property	Type	Description
`ad_title`	String	Title of the Ad.
`photo_url`	String	[Optional] Url of the image from the Ad the user is interested.
`video_url`	String	[Optional] Thumbnail url of the the video from the ad.
`post_id`	String	ID of the post.
`product_id`	String	[Optional] Product ID from the Ad the user is interested.

Referencia de eventos del webhook messaging_referrals