Notificación única (beta)

Resumen

La API de notificación única de la plataforma de Messenger (beta) 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 solicite recibir notificaciones, la página recibirá un token que equivale a un permiso para enviar al usuario un único mensaje. El token solo se podrá usar una vez y caducará en el plazo de 1 año a partir de su creación.

Permisos

En el caso de las páginas interesadas en usar esta API, se debe solicitar un permiso de “notificación única” en la sección “Mensajería avanzada”. Se deberán aceptar los términos de la versión beta. Se otorgará el permiso si la página cumple con nuestros criterios.

Índice

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

Uso

• No debes confundir, engañar, defraudar, enviar spam ni tomar por sorpresa a nadie. Asegúrate de que exista una relación clara y evidente entre la invitación a compartir y el contenido del mensaje. El contenido de la solicitud de notificación única y el mensaje deben cumplir con los estándares de la comunidad.
• Se anulará el acceso a la API en el caso de las páginas que reciban un volumen importante de comentarios negativos por parte de los usuarios o que confundan, engañen, defrauden o causen sorpresas negativas a estos.

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

Con la API de envío, la página puede enviar un mensaje de solicitud de notificación como 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 contenido concretos para cada tipo de plantilla. Solo se permite personalizar el título y la carga 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, una vez que el usuario haga clic en el botón “Notificarme”, se entregará un webhook message_optins a tu backend y se podrá usar one_time_notif_token para enviar un mensaje único de seguimiento al usuario fuera del período de 24 horas.

Envío de un mensaje de seguimiento

Para enviar un mensaje de seguimiento, envía una solicitud POST a la API de envío, con one_time_notif_token obtenido mediante webhook y message.text definido 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 más completo, reemplaza el texto con contenido enriquecido. Para ver la lista completa de tipos de mensajes admitidos, consulta Referencia de la API de envío. one_time_notif_token solo se puede usar una vez y se invalidará una vez que el mensaje se envíe correctamente.

Eventos de webhook

Cuando el usuario acepte recibir una notificación sobre una actualización específica, recibirás un evento de webhook con payload y one_time_notif_token. Deberás almacenar la carga y el token para enviar un mensaje de seguimiento cuando la información esté disponible. Ten en cuenta que no habrá una API exclusiva para consultar una lista de one_time_notif_token. Por lo tanto, es importante que proceses y almacenes la información de webhook a medida que se reciba. Los tokens solo se podrán usar una vez y caducarán en el plazo de 1 año a partir 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 uses el campo de carga para enviar contraseñas, credenciales de usuario, información que identifique personalmente a los usuarios (es decir, información como el nombre o la dirección de correo electrónico que pueda usarse para contactar a una persona o definir su identidad) u otros datos confidenciales (como datos de salud, financieros, datos sobre pagos o titularidad de tarjetas, u otras categorías de información definidas como confidenciales conforme a la legislación vigente).
• El número de solicitudes de notificación única está sujeto a un límite de frecuencia para evitar generar una mala experiencia de usuario.

Preguntas frecuentes

Para obtener más información, consulta nuestra página de preguntas frecuentes.