Usar enlaces de m.me

m.me es un servicio de Facebook que permite acortar las URL y redirige a los usuarios a una persona, una página o un bot en Messenger. Puedes utilizar las URL acortadas en tu sitio web, en boletines de noticias enviados por correo electrónico, etcétera.

Si un usuario inicia una conversación nueva con el bot o retoma una existente a través de un enlace de m.me, aparecerá el siguiente mensaje en dicha conversación: “Has entrado en esta conversación siguiendo un enlace. Informaremos a [NOMBRE DE LA PÁGINA] de que estás aquí.”

Contenido

Formato del enlace de m.me

El formato del enlace es http://m.me/<PAGE_NAME>, donde PAGE_NAME es el identificador de la página de Facebook a la que está enlazado el bot.

Parámetros de referencia

Además de ofrecerte una forma de dirigir a los usuarios a tu bot, la plataforma de Messenger admite el paso de un parámetro arbitrario a través de estos enlaces.

Esto resulta útil de cara a distintos objetivos, como realizar un seguimiento de varios enlaces ubicados en diferentes canales o vincular a un usuario de Messenger con una sesión o cuenta en una aplicación externa. Asimismo, también puedes usar esta opción para dirigir al usuario a contenido específico o a funciones disponibles en el bot.

Un enlace de m.me al que se le ha añadido un parámetro tiene el siguiente aspecto:

http://m.me/<PAGE_NAME>?ref=<REF_PARAM>

El valor del parámetro ref se pasará al servidor mediante un webhook.

Requisitos

  • Los parámetros de referencia deben ser una cadena de hasta 2083 caracteres de longitud.

  • El bot debe tener un botón “Empezar” configurado para poder recibir el parámetro de referencia de conversaciones nuevas.

  • La página a la que está vinculada el bot debe estar publicada para poder recibir el parámetro de referencia de todos los usuarios, a excepción de aquellos que tienen asignado el rol de desarrollador, evaluador o administrador del bot.

  • El parámetro de referencia es compatible con el cliente web de Messenger y con la versión 92.0 y posteriores de la aplicación para iOS y Android de esta plataforma.

Leer el parámetro que se ha pasado

Cuando un enlace de m.me con un parámetro “ref” abre Messenger en tu bot, pueden darse dos situaciones:

1. Nuevo usuario

Si has configurado el botón “Empezar” en tu página, entregaremos el parámetro ref que se ha pasado como parte del evento “postback” que suele enviarse cuando se toca el botón.

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"<USER_DEFINED_PAYLOAD>",
    "referral": {
      "ref": "ref_data_in_m_dot_me_param",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

En la parte superior, USER_DEFINED_PAYLOAD hace referencia a la carga útil que has configurado anteriormente para que se envíe en el evento “postback”.

La parte referral siempre sigue este formato:

"referral": {
   "ref": "ref_data_in_m_dot_me_param",
   "source": "SHORTLINK",
   "type": "OPEN_THREAD",
  }
Valor del campoDescripción

ref

Datos arbitrarios que se pasaron originalmente en el parámetro ref añadido al enlace de m.me.

source

Origen de esta referencia. En el caso de los enlaces de m.me, el valor del origen es “SHORTLINK”. En el caso de las referencias de los anuncios de conversaciones de Messenger, el valor es "ADS".

type

Identificador de la referencia. En el caso de referencias procedentes de enlaces de m.me, será siempre "OPEN_THREAD".

2. Usuario ya existente

Si el usuario ya tiene una cadena de mensajes con tu bot, cuando siga tu enlace de m.me, Messenger no mostrará la pantalla “Empezar”; solo abrirá la cadena.

En este caso, tu webhook recibirá de inmediato un evento messaging_referrals. El webhook ya debe estar suscrito a este evento para que se le notifique la referencia en esta situación.

Ten en cuenta que el intervalo estándar de 24 horas para el envío de mensajes no se restablece cuando un usuario vuelve a tu bot al hacer clic en un enlace m.me.

El evento del webhook messaging_referrals siempre sigue este formato:

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