Enlaces m.me

En este documento se indica cómo crear enlaces m.me para tu experiencia de Messenger.

m.me es un servicio de URL que proporciona Meta y que redirige a los usuarios a una persona, una página o una conversación en Messenger. Se pueden utilizar en el sitio web, en boletines de noticias enviados por correo electrónico, etc.

Funcionamiento

El formato de un enlace m.me es el siguiente, donde PAGE-NAME es la página de Facebook vinculada a la aplicación de mensajes.

Cuando un usuario haga clic en un enlace m.me, se le redirigirá a una conversación nueva con la empresa o a una conversación existente si el usuario ha intercambiado mensajes con la empresa en el pasado. En la conversación, aparecerá el siguiente mensaje predeterminado: “Has entrado en esta conversación siguiendo un enlace. Hemos informado a NOMBRE-PÁGINA de que estás aquí”.

También puedes añadir el parámetro text para incluir un mensaje personalizado.

Las empresas pueden compartir enlaces que redirijan a sitios web o a otros hilos, que pueden incluir texto rellenado previamente.

Cuando un usuario haga clic en el botón “Empezar” para iniciar una conversación con tu empresa, se enviará una notificación del webhook messaging_postbacks a tu servidor de webhooks. Como parte de esta notificación de webhook, el objeto postback contendrá un objeto referral con el parámetro ref.

Cuando un usuario haga clic en un enlace m.me y ya exista una conversación entre él y tu empresa, el enlace lo dirigirá a la conversación existente. Esta acción restablecerá el intervalo de mensajes estándar de 24 horas, de modo que la aplicación de mensajes podrá responder al usuario y el sistema enviará una notificación del webhook messaging_referrals al servidor de webhooks. Como parte de esta notificación de webhook, se incluirá un parámetro ref del enlace m.me.

Parámetros de referencia

Un enlace m.me puede contener un parámetro ref que, cuando un usuario hace clic en el enlace, proporciona a la empresa más contexto sobre la conversación, como un enlace al sitio web o un enlace a una tienda. Estos tipos de enlaces también pueden dirigir al usuario a funciones o contenidos determinados disponibles en la experiencia de Messenger.

Códigos QR

Los enlaces m.me con parámetros ref se pueden insertar en códigos QR. Los códigos QR compatibles se pueden escanear con la cámara nativa de un teléfono. Al escanearlos, se abrirán la aplicación de Messenger y la conversación de mensajes con la empresa.

Código QR de ejemplo El código QR de ejemplo tiene codificado el enlace http://m.me/OriginalCoastClothing?ref=summer_coupon, que activará un proceso de ejemplo sobre un cupón de descuento en Messenger.

Notificación de webhooks

Cuando recibas una notificación de webhook, contendrá información de un usuario que está iniciando una conversación con tu empresa o que ya tiene una conversación existente.

Iniciar una conversación

Cuando un usuario haga clic en el botón “Empezar” para iniciar una conversación con tu empresa, entregaremos el parámetro ref como parte de la notificación del webhook messaging_postbacks.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"POSTBACK-PAYLOAD-YOU-CONFIGURED",
    "referral": {
      "ref": "REF-PARAMETER-INFORMATION",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

Continuar en una conversación existente

Si ya existe una conversación entre tu empresa y el usuario que hizo clic en el enlace m.me, se enviará una notificación del webhook messaging_referrals.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "referral": {
    "ref": "REF-PARAMETER-INFORMATION",
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

Antes de empezar

Necesitarás lo siguiente:

• Advanced Access para la aplicación vinculada a la página de Facebook de la empresa.
• Un botón “Empezar” para la experiencia de Messenger con el que iniciar nuevas conversaciones.
• La aplicación vinculada a la página de Facebook de la empresa debe estar suscrita a los campos de los webhooks messaging_postbacks y messaging_referrals.

Limitaciones

• Las aplicaciones con acceso estándar solo pueden obtener información de los usuarios que tengan un rol de desarrollador, evaluador o administrador en la aplicación de mensajes.

Solicitudes de activación de mensajes de marketing

La URL m.me/rn te permite crear una solicitud de suscripción voluntaria a notificaciones recurrentes con un enlace m.me. El formato de un enlace m.me/rn debe incluir el tema de la notificación recurrente. Puedes establecer la frecuencia de la notificación recurrente; de lo contrario, adoptará la frecuencia diaria como valor predeterminado.

Limitaciones

• La versión 383 de iOS es obligatoria para que los enlaces m.me/rn funcionen correctamente. Al usuario que hizo clic en el enlace se le redirigirá a tu URL m.me base, http://m.me/PAGE-NAME.

Enlace de ejemplo de mensajes de marketing

Registrar el tema

Para poder usar tu URL m.me/rn con un nuevo tema, antes debes registrarlo.

Si vas a usar un tema que ya has utilizado en una URL m.me/rn anterior y los usuarios han activado las notificaciones recurrentes, no hace falta que vuelvas a registrar el tema.

Para registrar un nuevo tema, puedes seguir estos pasos:

Paso 1. Envía una solicitud de suscripción voluntaria a notificaciones recurrentes con el tema a un usuario que tenga un rol en tu aplicación. Te recomendamos añadir la carga útil para indicar que la finalidad es registrar el tema.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
          "title":"TITLE",
          "payload": "Registering a new topic: TOPIC-NAME",
          "notification_messages_frequency": MESSAGE-FREQUENCY,
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Cuando esta operación se completa correctamente, la aplicación recibe la respuesta JSON siguiente:

{ 
        "recipient": {
          "id":"PSID",
          "message_id":"MESSAGE-ID",
}

Paso 2. Asegúrate de hacer clic en el botón de activación en la conversación. Te enviaremos una notificación de webhook de activación. El tema ya está registrado y listo para el uso público.

Ejemplo de solicitud

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

Cuando esta operación se completa correctamente, la aplicación recibe la respuesta JSON siguiente:

{ "success": true }

Notificación del webhook messaging_optins

Cuando recibas una notificación de webhook, contendrá información de un usuario que está iniciando una conversación con tu empresa o que ya tiene una conversación existente.

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "title": "TITLE-FOR-NOTIFICATION-MESSAGE",
    "ref": "REF-PARAMETER-INFORMATION",
    "payload": "",
    "source":"SHORTLINK"
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_topic": "RECURRING-NOTIFICATION-TOPIC", 
    "notification_messages_frequency": "MESSAGE-FREQUENCY",
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS"
    }
}

Referencia de m.me

Siguientes pasos

• Enviar una respuesta
• Enviar una notificación recurrente

Más información

• Consulta la página de parámetros de referencia en la guía de ejemplo de Original Coast Clothing.
• Consulta la referencia de messaging_optins.
• Consulta la referencia de messaging_postbacks para obtener más información sobre los campos de este webhook.
• Consulta la referencia de messaging_referrals para obtener más información sobre los campos de este webhook.