Enlaces m.me

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

m.me es un servicio de URL proporcionado por Meta que redirige a los usuarios a una persona, página o conversación en Messenger. Puedes utilizar estos enlaces en tu sitio web, tus boletines informativos por correo electrónico u otros medios.

Cómo funciona

El formato de un enlace m.me es el que mostramos a continuación. PAGE-NAME es la página de Facebook vinculada con tu app de mensajes.

Cuando una persona hace clic en el enlace m.me, se la redirige a una conversación nueva con tu negocio o a una conversación preexistente, en caso de que ya haya enviado algún mensaje a tu negocio. En la conversación, aparecerá el mensaje predeterminado: "Ingresaste en esta conversación siguiendo un enlace. Notificaremos a NOMBRE-DE-LA-PÁGINA que estás aquí".

Puedes agregar el parámetro text para incluir también un mensaje personalizado.

Las empresas pueden compartir enlaces que redirigen a sitios web o a otras conversaciones, algunos de los cuales pueden incluir texto precargado.

Cuando una persona haga clic en el botón "Empezar" para iniciar una conversación con tu empresa, se enviará una notificación de 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 una persona haga clic en un enlace m.me y ya exista una conversación entre ella y tu empresa, el enlace la dirigirá a esa conversación. Con esta acción, se restablecerá el intervalo de mensajes estándar de 24 horas, lo que le permitirá a tu app de mensajes responder a la persona y se enviará una notificación de webhook messaging_referrals a tu servidor de webhooks. En 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 la persona hace clic en el enlace, le proporciona a tu empresa más contexto sobre la conversación, como un enlace de tu sitio web en comparación con un enlace a una tienda. Estos tipos de enlaces también pueden dirigir a la persona hacia funciones o contenido específicos disponibles en tu experiencia de Messenger.

Códigos QR

Se pueden insertar enlaces m.me con parámetros ref en códigos QR. Se pueden escanear códigos QR compatibles con la cámara nativa del teléfono. Cuando se escaneen, se abrirá la app de Messenger y la conversación con la empresa.

Ejemplo de código QR El código QR de ejemplo tiene codificación http://m.me/OriginalCoastClothing?ref=summer_coupon, lo que activa un proceso de ejemplo sobre un cupón de descuento en Messenger.

Notificación de webhook

Las notificaciones de webhook que recibas contendrán información de una persona que inicia una conversación con tu empresa, o de una persona que ya tiene una conversación preexistente con la empresa.

Iniciar una conversación

Cuando una persona 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 de 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 preexistente

Si ya existe una conversación entre tu empresa y la persona que hizo clic en el enlace m.me, se enviará la notificación de 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:

• Acceso avanzado a la app que se vinculó a la página de Facebook de tu empresa.
• Un botón "Empezar" para las nuevas conversaciones en tu experiencia de Messenger.
• La app vinculada a la página de Facebook de tu empresa debe estar suscrita a los campos de webhooks messaging_postbacks y messaging_referrals.

Limitaciones

• Las apps que cuentan con acceso avanzado solo pueden obtener información de personas que tienen el rol de desarrollador, evaluador o administrador en tu app de mensajes.

Solicitudes de suscripción a mensajes de marketing

La URL m.me/rn te permite crear una solicitud de suscripción voluntaria de notificaciones periódicas con un enlace m.me. El formato de un enlace m.me/rn debe incluir el tema de la notificación periódica. El valor predeterminado de la frecuencia de la notificación periódica es "diariamente", pero puedes configurar la que desees.

Limitaciones

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

Enlace de ejemplo de mensajes de marketing

Registra tu tema

Antes de que puedas usar la URL m.me/rn con un nuevo tema, primero debes registrarlo.

Si usas un tema que ya utilizaste en un una URL m.me/rn anterior y las personas aceptaron voluntariamente recibir notificaciones periódicas, no es necesario volver a registrar el tema.

Para registrar un nuevo tema, sigue estos pasos:

Paso 1: Envía una solicitud de suscripción voluntaria a notificaciones recurrentes con el tema a una persona que tenga un rol en tu app. Te recomendamos agregar la carga para indicar que deseas registrar tu 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"

Si la operación se completa correctamente, la app recibirá la siguiente respuesta JSON:

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

Paso 2: Asegúrate de hacer clic en el botón de activar la suscripción voluntaria en el mensaje. Te enviaremos una notificación de webhook de suscripción. Ahora, tu tema está registrado y ya puedes usarlo con el 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"

Si la operación se completa correctamente, tu app recibirá la siguiente respuesta JSON:

{ "success": true }

Notificación de webhook messaging_optins

Las notificaciones de webhook que recibas contendrán información de una persona que inicia una conversación con tu empresa o de una persona que ya tiene una conversación preexistente con la empresa.

{
  "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 m.me

Próximos pasos

• Enviar una respuesta
• Enviar una notificación recurrente

Más información

• Consulta la página sobre parámetros de referencia en la guía de ejemplos de Original Coast Clothing.
• Visita la referencia 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.