Facebook Messenger
Facebook Messenger es una de las plataformas de mensajería instantánea más populares del mundo, utilizada por casi mil millones de usuarios activos mensuales. A través de esta plataforma, las marcas pueden crear chatbots atractivos para interactuar de forma inteligente y automática con sus clientes.
La integración de Braze y Facebook aprovecha las funciones de webhooks, segmentación, personalización y activación de Braze para enviar mensajes a tus usuarios en Facebook Messenger a través de la API de la plataforma Messenger. Nuestra plataforma incluye una plantilla de webhook personalizada para Facebook Messenger en Plantillas > Plantillas de webhook.
La plataforma Facebook Messenger está pensada para “mensajes no promocionales que faciliten una transacción preexistente, proporcionen otras acciones de atención al cliente o entreguen contenidos solicitados por una persona.” Para obtener más información, consulta las directrices de la plataforma de Facebook y ejemplos de casos de uso aceptables.
Requisitos previos
Acepte lo siguiente antes de proceder a la integración:
- Facebook no permite el uso de la plataforma Messenger para enviar mensajes de marketing.
- Necesitará el permiso explícito del usuario para recibir mensajes de su página.
- Para enviar mensajes a usuarios que no son usuarios de prueba de tu aplicación de Facebook, tu aplicación tendrá que pasar la revisión de aplicaciones de Facebook.
Requisito | Origin | Acceso | Descripción |
---|---|---|---|
Página de Facebook Messenger | https://www.facebook.com/pages/create | Se utilizará una página de Facebook como identidad de tu bot. Cuando la gente chatee con tu aplicación, verá el nombre de la página y la foto del perfil. | |
Aplicación Facebook Messenger | https://developers.facebook.com/apps | La aplicación de Facebook contiene la configuración de tu bot de Messenger, incluidos los tokens de acceso. | |
Revisión y aprobación del bot de la aplicación | https://developers.facebook.com/docs/messenger-platform/app-review | Cuando estés listo para lanzar tu bot al público, debes enviarlo a Facebook para su revisión y aprobación. Este proceso de revisión nos permite asegurarnos de que tu bot de Messenger cumple nuestras políticas y funciona como se espera antes de ponerlo a disposición de todo el mundo en Messenger. | |
ID de página (PSID) | https://developers.facebook.com/docs/messenger-platform/reference/webhook-events/messages | Necesitas tener PSIDs de usuarios para enviar mensajes en Facebook Messenger. Cuando un usuario interactúa con tu aplicación a través de Messenger, Facebook creará un PSID. Este PSID se puede enviar a Braze como un atributo personalizado de cadena. | |
Token de acceso a la página | https://developers.facebook.com/docs/messenger-platform/getting-started/app-setup#page_access_token | Estos tokens de acceso son similares a los tokens de acceso de usuario, salvo que proporcionan permiso a las API que leen, escriben o modifican los datos pertenecientes a una página de Facebook. Para obtener un token de acceso a una página, es necesario obtener un token de acceso de usuario y solicitar el manage_pagespermission . Cuando tengas el token de acceso de usuario, obtendrás el token de acceso a la página a través de la API Graph. |
Integración
A continuación se muestra cómo configurar un webhook Braze Facebook Messenger. Si necesitas más ayuda para configurar tu bot, en el repositorio GitHub de Braze encontrarás un tutorial completo sobre el bot de Messenger y un código de ejemplo.
Paso 1: Recoge tus PSID
Para enviar mensajes en Facebook Messenger, necesitas recopilar los identificadores específicos de página (PSID) de tus usuarios para identificarlos e interactuar con ellos de forma coherente. Los PSID no coinciden con el ID de Facebook del usuario. Facebook crea este identificador cada vez que envías un mensaje a un cliente o cuando un cliente te envía un mensaje a ti.
Los PSID se pueden encontrar utilizando uno de los diversos puntos de entrada que ofrece Facebook. Después de que el usuario envíe un mensaje a tu aplicación o realice una acción en una conversación, como pulsar un botón o enviar un mensaje, su PSID se incluirá en la propiedad sender.id
del evento webhook, para que tu bot pueda identificar quién realizó la acción.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"sender":{
"id":"<PSID>"
},
"recipient":{
"id":"<PAGE_ID>"
},
"timestamp":1458692752478,
"message":{
"mid":"mid.1457764197618:41d102a3e1ae206a38",
"text":"hello, world!",
"quick_reply": {
"payload": "<DEVELOPER_DEFINED_PAYLOAD>"
}
}
}
Cada vez que envíe un mensaje, su PSID se incluirá en la propiedad recipient.id
de la solicitud para identificar quién debe recibir el mensaje.
Paso 2: Enviar a Braze como atributo personalizado
Cuando esté seguro de que recibe PSID, coordínelo y compártalo con sus desarrolladores para enviar los PSID a Braze como atributo personalizado. Los PSID son cadenas a las que se puede acceder mediante una llamada a la API.
Paso 3: Configure su plantilla de webhook
En Plantillas y medios, ve a Plantillas de webhook y elige la Plantilla de webhook de Facebook Messenger.
- Proporcione un nombre de plantilla y añada equipos y etiquetas, según sea necesario.
- Escribe tu mensaje o elige una plantilla de mensaje de las que Facebook pone a tu disposición. También puedes elegir el tipo de mensaje o etiqueta.
- Incluir el PSID como atributo personalizado. Para ello, utilice el botón + azul y blanco situado en la esquina del cuadro Cuerpo de la solicitud.
- Añade tu token de acceso a la página en la URL del webhook sustituyendo
FACEBOOK_PAGE_ACCESS_TOKEN
por tu token.
Previsualizar y probar el webhook
Antes de enviar tu mensaje, prueba tu webhook. Asegúrate de que tu ID de Messenger está guardado en Braze (o búscalo y prueba como usuario personalizado), y utiliza la vista previa para enviar el mensaje de prueba:
Si recibe el mensaje correctamente, puede configurar sus opciones de entrega.
Mediante esta integración
Una vez configurada, utiliza esta integración para dirigirte a los usuarios de Facebook Messenger. Si no envías mensajes utilizando los números de teléfono de los usuarios y planeas enviar mensajes de Messenger repetidamente, debes crear un segmento para todos los usuarios para los que exista el ID de Messenger como atributo personalizado y activar el seguimiento de análisis para realizar un seguimiento de tus tasas de suscripción a Messenger a lo largo del tiempo.
Si decide no crear un segmento específico para los suscriptores de Messenger, asegúrese de incluir un filtro para el ID de Messenger existente para evitar errores.
También puede utilizar otra segmentación para orientar sus campañas de Messenger, y el resto del proceso de creación de campañas, como con cualquier otra campaña.