Notificación única (beta)

Resumen

La API de notificación única (beta) de la plataforma de Messenger permite que una página solicite a un usuario el envío de un mensaje de seguimiento una vez transcurrido un intervalo de 24 horas. Se ofrecerá al usuario la posibilidad de recibir una notificación futura. Una vez que el usuario haya solicitado recibir una notificación, la página recibirá un identificador de acceso que equivale a un permiso para enviar un único mensaje al usuario. El identificador solo se podrá utilizar una vez y caducará un año después de su creación.

Permisos

Las páginas interesadas en utilizar esta API deben solicitar el permiso “Notificación única” en la sección “Mensajería avanzada” de la configuración de la página. La página deberá aceptar las condiciones del programa beta y, si cumple nuestros criterios, obtendrá el permiso.

Contenido

• Uso
• Envío de una solicitud de notificación única
• Envío de un mensaje de seguimiento
• Eventos de webhook
• Restricciones y limitaciones

Uso

• No debes confundir, defraudar, engañar, sorprender ni enviar spam a ninguna persona. Asegúrate de que existe una relación clara y evidente entre el tema y el contenido del mensaje. El contenido de la solicitud de notificación única y del mensaje debe cumplir con las Normas comunitarias.
• Las páginas que reciban grandes volúmenes de comentarios negativos de los usuarios, o que confundan, engañen, defrauden o sorprendan negativamente a estos perderán el acceso a la API.

Envío de una solicitud de notificación única

Mediante la API de envío, la página puede enviar un mensaje de solicitud de notificación como una plantilla. El tipo de plantilla debe ser one_time_notif_req. El cuerpo de la solicitud sigue un formato estándar para todos los tipos de plantilla, donde la propiedad message.attachment.payload contiene los detalles del tipo y el contenido específicos de cada uno de ellos. Solo tienes permiso para personalizar el título y la carga útil de la solicitud. El campo title tiene un límite de 65 caracteres.

{
  "recipient": {
    "id":"

Se mostrará la plantilla de solicitud de notificación única y, cuando el usuario haga clic en el botón Notificarme, se entregará un webhook message_optins a tu backend y el elemento one_time_notif_token se podrá utilizar para enviar un mensaje de seguimiento único al usuario fuera del periodo de 24 horas.

Envío de un mensaje de seguimiento

Para enviar un mensaje de seguimiento, manda una solicitud POST a Send API, con el elemento one_time_notif_token obtenido a través del webhook y el elemento message.text establecido en el cuerpo de la solicitud:

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "one_time_notif_token":"<ONE_TIME_TOKEN>"
  },
  "message": {
    "text":"<MESSAGE_CONTENT>"
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Para enviar un mensaje enriquecido, reemplaza el texto por contenido enriquecido. Consulta la referencia de Send API para obtener la lista completa de los tipos de mensajes admitidos. El elemento one_time_notif_token solo se puede utilizar una vez y se invalidará cuando el mensaje se envíe correctamente.

Eventos de webhook

Si el usuario da su consentimiento para recibir notificaciones sobre una actualización específica, obtendrás un evento de webhook con los elementos payload y one_time_notif_token. Deberás almacenar la carga útil y el identificador para poder enviar un mensaje de seguimiento cuando la información esté disponible. Ten presente que no habrá ninguna API independiente para consultar una lista de elementos one_time_notif_token, por lo que es importante que proceses y almacenes la información del webhook a medida que la recibes. Cada identificador solo se puede utilizar una vez y caducará un año después de su creación.

{
   "sender": {
     "id":"<PSID>"
   },
   "recipient": {
     "id":"<PAGE_ID>"
   },
   "timestamp":1458692752478,
   "optin": {
     "type": "one_time_notif_req",
     "payload": "<USER_DEFINED_PAYLOAD>",
     "one_time_notif_token":"<ONE_TIME_TOKEN>",
   }
}

Restricciones y limitaciones

• No utilices el campo de carga útil para enviar contraseñas, credenciales de usuario, información personal de los usuarios (es decir, datos como el nombre o la dirección de correo electrónico que se puedan utilizar para contactar con una persona o identificarla) ni otra información confidencial (como datos médicos, financieros, de pago o de tarjeta de crédito, u otras categorías de datos definidos como confidenciales en virtud de la legislación aplicable).
• El número de solicitudes de notificación única está sujeto al límite de frecuencia, a fin de impedir que se cree una experiencia de usuario insatisfactoria.

Preguntas frecuentes

Puedes encontrar más información en nuestra página de preguntas frecuentes.