Preguntas frecuentes

Las aplicaciones se instalan desde sus respectivos sitios web mediante el inicio de sesión con Facebook al conceder el permiso “pages_messaging” a una página determinada. Las aplicaciones autorizadas aparecerán en la sección Configuración de la página que se encuentra en Mensajería avanzada.

Sí, una aplicación de Facebook puede estar suscrita a varias páginas. Tras someterse al proceso de revisión de la aplicación (como con el permiso “pages_messaging”), la aplicación puede suscribirse para recibir webhooks de más de una página. Tendrás que obtener el contexto de cada uno en función de la carga útil.

Sí, es posible vincular más de una aplicación a una página. Si varias aplicaciones gestionan la misma conversación, lo ideal es utilizar el protocolo de traspaso para administrar qué bot controla la cadena de mensajes en cada momento.

Visita la página La plataforma de Messenger y el Reglamento General de Protección de Datos para consultar las preguntas frecuentes sobre el RGPD y la plataforma de Messenger.

Si usas el plugin "Enviar a Messenger", puedes utilizar el parámetro data-ref como parámetro "pass-through" para enviar cualquier información relacionada con el contexto del clic.

Las páginas también se pueden descubrir a través de la búsqueda en Messenger. En estos casos, no dispondrás de ningún parámetro "pass-through". Para asociar una cadena de mensajes con una cuenta de usuario en tu sitio web, usa la función de vinculación de cuentas.

Cuando una aplicación está en modo de desarrollo, el plugin solo resulta visible para los administradores, desarrolladores y evaluadores de dicha aplicación. Una vez que la aplicación se revisa y aprueba, pasa a estar disponible para el público en la pestaña "Revisión de la aplicación" del panel de aplicaciones.

No. Unlike subscriptions where a business can send multiple messages to people on a recurring basis, the one-time notification API limits the business to a single message per user request. If the person engages with the message, the standard messaging window will reopen.

Yes. Pages interested in using the One-time Notification API need to apply for permission. Go to the Advanced Messaging section of your Page Settings and consent to the terms. A Page will be granted permission if the Page meets our criteria.

Common uses of the API include various promotional and non-promotional use cases where the User explicitly requested a follow-up. Examples include:

• Back in stock alerts
• Collection launches
• Concert tickets going on sale
• Price drop alerts
• Train tickets available for purchase
• CSAT surveys

Your Page is not allowed to send a notification on a topic for which the User has not agreed to receive a notification. Please see the Usage and Restrictions and Limitations sections of the One-time Notification guide for more information.

A Page can send multiple requests however, the 24-hour policy will be applied to all the requests being sent. We also have controls in place to prevent spamming users with multiple requests.

The 24 hour standard messaging window will open only if the user interacts with the opt-in message. The behavior is consistent with interactions with other elements in the Messenger experience.

Pages will need to subscribe to message_optins webhook to receive notifications about User consent.

Once a person asks to be notified, the Page will receive a token which is equivalent to a permission to send a single message to the person. The token can be used to send a message to the person outside the 24 hour window. The token can only be used once and unused tokens will expire within 1 year of creation.

Yes. However, while it is possible to send another notification request using an existing token, there is no clear benefit for the business to send these type of requests.

Token is for one-time use only. Once a token is used it can not be used again.

No. The API does not return tokens available to a Page.

Page level. Permissions for the One-time Notification API are given at the Page level.

No. The app does not need to specify any message tags when sending a message outside the 24-hour standard messaging window using this API.

Puede suceder por varias razones:

• Estás usando un identificador del inicio de sesión con Facebook. Los identificadores de usuario del inicio de sesión con Facebook no son compatibles con la API de envío y recepción. Solo pueden usarse en la plataforma de Messenger los identificadores de usuario obtenidos durante el proceso de autenticación en dicha plataforma.
• Estás usando un identificador con un identificador de acceso a la página incorrecto. Los identificadores de usuario de la plataforma de Messenger son específicos de una página. Si usas un identificador de usuario válido con un identificador de acceso a la página asociado a una página diferente, la llamada generará un error. Asegúrate de usar identificadores de usuario e identificadores de acceso a la página que estén asociados a la misma página.
• Estás enviando mensajes a un número de teléfono que no se ha verificado recientemente. Cuando se usa la API de envío con un número de teléfono, solo enviamos mensajes si dicho número se ha verificado recientemente. El envío tampoco se realizará correctamente si el número aparece como verificado, pero esta verificación no se ha realizado recientemente. Vuelve a verificar el número de teléfono y espera 24 horas para intentarlo de nuevo.

Sigue este procedimiento alternativo para utilizar un usuario de prueba de la plataforma en la integración de la plataforma de Messenger:

1. En la página de roles de tu aplicación, haz clic en el botón "Añadir" para crear un nuevo usuario de prueba.
2. Activa la opción ¿Quieres autorizar usuarios de prueba para esta aplicación? y concede los permisos "manage_pages" y "page_messaging".
3. Haz clic en el botón "Editar" y obtén un identificador de acceso para este usuario (v2.6). Guárdalo para usarlo más adelante.
4. Haz clic en el botón Editar para iniciar sesión en nombre del usuario de prueba.
5. A continuación, crea una página en nombre de este usuario.
6. Usa el identificador de acceso del usuario de prueba para obtener el identificador de acceso a la página correspondiente. Puedes obtenerlo con la siguiente llamada:

   https://graph.facebook.com/v2.6/me/accounts?access_token=[IDENTIFICADOR_DE_ACCESO_DE_USUARIO_DE_PRUEBA]

   (Documentación)
7. Utiliza este identificador de acceso a la página para vincular tu aplicación de Facebook a tu página:

   https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[IDENTIFICADOR_DE_ACCESO_A_LA_PÁGINA_DE_USUARIO_DE_PRUEBA]
           

   (Documentación)
8. Tras realizar este proceso, recibirás actualizaciones en tiempo real (RTU) para la página de prueba y podrás enviar mensajes al usuario de prueba desde dicha página. Además de lo descrito anteriormente, puedes reemplazar el identificador de acceso por otro de larga duración si crees que la fecha de caducidad te va a impedir realizar las pruebas. Para obtener más información, consulta esta documentación:

   GET /oauth/access_token?  
       grant_type=fb_exchange_token&           
       client_id={app-id}&
       client_secret={app-secret}&
       fb_exchange_token={short-lived-token} 
           

Sí, un bot puede incluir ambos tipos de mensajes. La persona tendrá que iniciar los mensajes estándar de la plataforma mediante una de las acciones válidas y dar su consentimiento para recibir mensajes sujetos a suscripción.

Técnicamente, los bots no pueden enviar a un usuario más de un mensaje transcurrido el período de 24 horas (es decir, el mensaje no se enviará). Durante el período de transición de los bots ya existentes, estos mensajes se enviarán pero, si se detectan, se marcarán.

No. La plataforma de Messenger no ofrece una API que devuelva una lista de PSID de las personas que han habilitado la opción de recibir mensajes de tu bot.

Para recibir devoluciones de llamada, debes llevar a cabo dos pasos. En primer lugar, asegúrate de que el webhook está configurado correctamente (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). Cuando la configuración del webhook es correcta, se notifica con un indicador.

A continuación, suscríbete a las distintas páginas. Se mostrarán en una lista todas las páginas a las que te hayas suscrito.

Si las llamadas al webhook generan errores durante un período de tiempo prolongado, se cancelará la suscripción de tu aplicación. En este caso, deberás añadir el webhook de nuevo y volver a configurar las suscripciones de tu página.

Las llamadas al webhook contienen el campo X-Hub-Signature en el encabezado, con el que se puede comprobar que la llamada procede de Facebook.

Asegúrate de que el webhook responde con el código de estado "200", que nos indica que el webhook se ha recibido correctamente. Si no devuelve este código, volveremos a intentar la llamada hasta que nos conste que se ha completado correctamente; si continúa sin hacerlo tras un período de tiempo significativo, emitiremos las alertas para desarrolladores.

Por otra parte, ten en cuenta que también se devuelve puntualmente un código de estado correcto. Las llamadas al webhook tienen un tiempo de espera de 20 segundos. Asegúrate de estructurar el código para que los webhooks se procesen de forma asíncrona. Así, el código de estado correcto podrá devolverse de forma inmediata y procesarse por separado.

Existe una herramienta que muestra los errores recientes del webhook. Si los webhooks no se pueden entregar, los servidores de Facebook cancelarán la suscripción de la URL. Para encontrar la herramienta, dirígete al panel de aplicaciones > Messenger > Configuración y, en la tarjeta Webhooks, verás un botón denominado Mostrar errores recientes.