Preguntas frecuentes

Las apps se instalan desde el sitio web de la app con el inicio de sesión con Facebook luego de otorgar el permiso "pages_messaging" (mensajería en páginas) a una página en particular. Las apps autorizadas aparecerán en la sección Configuración de la página de Mensajería avanzada.

Sí, es posible que una sola aplicación de Facebook esté suscrita a varias páginas. Una vez que se sujete a revisión (por ejemplo, para concederle el permiso pages_messaging), la app puede suscribirse para recibir webhooks en más de una página. Obtener el contexto de cada webhook en función de la carga dependerá de ti.

Sí, puede haber más de una app con suscripciones a la página. Si varias apps administran la misma conversación, es recomendable usar el protocolo de traspaso para administrar qué bot tiene la conversación 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.

Cuando utilices el plugin "Enviar a Messenger", puedes utilizar el parámetro data-ref como parámetro de salida para enviar cualquier información relacionada con el contexto del clic.

Las personas también pueden encontrar tu página a través de la búsqueda en Messenger. En estos casos, no tendrás un parámetro de salida. Puedes utilizar la función de vinculación de cuentas para asociar una conversación con una cuenta de usuario en tu sitio.

Mientras una aplicación esté en modo de desarrollo, solo los administradores, desarrolladores y evaluadores de la aplicación pueden ver el plugin. Una vez que la aplicación se revise y apruebe, puedes publicarla en la pestaña "Revisión de aplicaciones" 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.

Es posible que esto se deba a varias razones:

• Estás usando un identificador de inicio de sesión con Facebook. Los identificadores de usuario de inicio de sesión con Facebook no están destinados para funcionar con la API de envío y recepción. Solo los identificadores de usuario que se obtengan mediante autenticación con la plataforma de Messenger funcionarán con esta.
• Estás usando un identificador con el token de acceso de página incorrecto. Los identificadores de usuario para la plataforma de Messenger están delimitados a una página y, por consiguiente, son específicos de la página. Si usas un identificador de usuario válido pero con un token de acceso de página que esté asociado a una página diferente, la llamada no funcionará. Asegúrate entonces de utilizar el identificador de usuario y el token de acceso de página asociados con la misma página.
• Estás enviando un número de teléfono que no se verificó recientemente. Al usar la API de envío con un número de teléfono, solo enviaremos mensajes si dicho número se verificó recientemente. Incluso si el número de teléfono aparece verificado, pero no lo fue recientemente, el envío producirá un error. Verifica de nuevo tu número de teléfono y espera 24 horas para volver a probar.

Te ofrecemos esta solución alternativa para que utilices usuarios de prueba para tu integración de la plataforma de Messenger:

1. En la página de roles de tu aplicación, crea un nuevo usuario de prueba haciendo clic en el botón "Agregar".
2. Selecciona la opción ¿Autorizar usuarios de prueba para esta aplicación? y concede los permisos "manage_pages" y "page_messaging".
3. Utiliza el botón "Editar" y obtén un token de acceso para este usuario (usando la versión 2.6). Recuerda guardarlo para más tarde.
4. Utiliza el botón Editar para iniciar sesión como usuario de prueba.
5. Una vez que hayas iniciado sesión, crea una página como usuario de prueba.
6. Utiliza el token de acceso de usuario para el usuario de prueba con el fin de obtener el token de acceso de página para este. Puedes hacerlo con la siguiente llamada:

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

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

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

   (Documentación)
8. Luego de seguir estos pasos, recibirás actualizaciones en tiempo real (RTU) en tu página de prueba y podrás enviar mensajes a tu usuario de prueba desde ella. Además de esto, puedes reemplazar tu token de acceso con un token de larga duración en caso de que caduque demasiado pronto para tus pruebas. Puedes consultar la documentación aquí:

   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 los dos tipos de mensajería. Una persona tendrá que activar la mensajería de la plataforma estándar mediante uno de los activadores aprobados y tendrá que aceptar recibir mensajería por suscripción.

Técnicamente, los bots no podrán enviar mensajes a los usuarios más de una vez pasado el plazo de 24 horas (no se enviará el mensaje). Durante el período de transición para los bots existentes, estos mensajes se enviarán, pero si se encuentran se los marcará.

No, la plataforma de Messenger no ofrece una API que devuelva una lista de PSID de todas las personas que activaron la opción de recibir mensajes del bot.

Debes seguir dos pasos para recibir devoluciones de llamadas. En primer lugar, asegúrate de que tu webhook esté configurado correctamente (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). Verás un indicador cuando la configuración sea correcta.

En segundo lugar, debes suscribirte a cada página. Verás una lista de todas las páginas a las que estás suscrito.

Si las llamadas a tu webhook devuelven un mensaje de error durante mucho tiempo, se cancelará la suscripción de tu aplicación y tendrás que volver a agregar tu webhook y suscribir de nuevo tu página.

Las llamadas al webhook contienen un campo en el encabezado denominado X-Hub-Signature, que se puede utilizar para validar que la llamada provenga de Facebook.

Asegúrate de que tu webhook esté respondiendo con un código de estado de 200. Esto nos informa que se recibió correctamente el webhook. Si no devuelves un 200, volveremos a intentar la llamada hasta que se reciba satisfactoriamente. Además, si un webhook no devuelve un 200 durante un lapso de tiempo prolongado, mostraremos alertas para desarrolladores.

De igual manera, ten en cuenta que un código de estado correcto se devuelve de forma oportuna. Una llamada de webhook caducará después de 20 segundos. Asegúrate de diseñar tu código de tal manera que los webhooks se procesen de forma asincrónica, con el fin de que un código de estado correcto se pueda devolver inmediatamente y se procese por separado.

Hay una herramienta que muestra los errores recientes del wekbhook. Si no es posible entregar webhooks, los servidores de Facebook cancelarán la suscripción de tu URL. Para encontrar la herramienta, ingresa al Panel de aplicaciones > Messenger > Configuración; dentro de la tarjeta Webhooks hay un botón llamado Mostrar errores recientes.