Esta guía explica cómo conectar un chatbot de IA de ScoreApps con una página de Facebook para responder mensajes de Facebook Messenger.

Mapa rápido del proceso

Antes de empezar, quédate con esta idea: la conexión se hace entre tres piezas: tu página de Facebook, una app de Meta y tu chatbot de ScoreApps.

1. Crear o abrir una app en Meta: es el lugar donde Facebook permite configurar Messenger.
2. Conectar tu página de Facebook: eliges la página que recibirá los mensajes.
3. Copiar datos de Meta a ScoreApps: App ID, App Secret, Page Name y Access Token.
4. Copiar el webhook de ScoreApps a Meta: Meta necesita saber a qué URL enviar los mensajes.
5. Activar los eventos: como mínimo messages y messaging_postbacks.
6. Probar la conexión: primero con un administrador, desarrollador o tester.
7. Pasar a producción: si quieres que cualquier cliente pueda escribir a la página, tendrás que completar App Review en Meta.

Qué copiar y dónde pegarlo

Prueba interna o uso real con clientes

Antes de empezar

• Necesitas acceso de administrador a la página de Facebook.
• Necesitas acceso a Meta for Developers.
• Necesitas tener creado el chatbot en ScoreApps.
• La página debe pertenecer a un Business Portfolio verificado para producción.

1. Crear la app en Meta

1. Entra en Meta for Developers y pulsa Create App.
2. Elige un nombre para la app.
3. Selecciona Business messaging y después Engage with customers on Messenger from Meta.
4. Selecciona el Business Portfolio correspondiente.

Meta mostrará los requisitos de publicación: verificación de negocio, verificación de acceso y App Review.

2. Configurar Messenger API en Meta

1. Dentro de la app, entra en Use cases.
2. Abre Messenger from Meta.
3. Entra en Messenger API Settings.

Si no ves esas opciones, fíjate primero en el menú de la izquierda: debe estar seleccionado Use cases, luego Messenger from Meta y después Messenger API Settings.

Dentro de Messenger API Setup, Meta muestra bloques plegados. Para continuar, abre el bloque que necesites con See more o con la flecha del bloque.

3. Conectar la página de Facebook

1. En Generate access tokens, pulsa Connect.
2. Continúa con tu cuenta de Facebook.
3. Selecciona la página que quieres conectar.
4. Concede el permiso para gestionar y acceder a conversaciones de la página en Messenger.

4. Crear el canal Messenger en ScoreApps

1. En ScoreApps, entra en IA > Agentes de IA.
2. En el chatbot, abre Opciones de chatbot.
3. Selecciona Canal.
4. Elige Messenger.

En la lista de chatbots, localiza el chatbot que quieres conectar y pulsa Chatbot Options. En el menú desplegable, elige Channel. No uses Test & Embed; esa opción es para probar o incrustar el chatbot, no para conectar Messenger.

Rellena el formulario con App ID, App Secret, Page Name, Access Token y Verify token. El Access Token debe copiarse con el botón Copy de Meta; no uses el campo visual si aparece enmascarado.

¿De dónde sale cada dato que pide ScoreApps?

En el formulario de Messenger de ScoreApps hay cinco campos. Estos son los puntos exactos de Meta donde se obtiene cada valor:

• App ID: en Meta for Developers, dentro de la app, entra en Settings > Basic. Copia el valor de App ID.
• App Secret: en la misma pantalla, Settings > Basic, está junto a App secret. Pulsa Show solo si necesitas verlo y no lo compartas en capturas, vídeos ni tickets.
• Page Name: es el nombre exacto de la página conectada en Generate access tokens.
• Access Token: en Messenger API Settings > Generate access tokens, usa el botón Generate o Copy de la página conectada. No copies texto enmascarado.
• Verify token: no lo proporciona Meta. Lo defines tú en ScoreApps y después escribes exactamente el mismo valor en Meta, dentro de Configure webhooks.

5. Verificar el webhook en Meta

En la pantalla del canal Messenger de ScoreApps, usa el botón Copy Webhook. Ese botón copia la URL que después debes pegar en Meta como Callback URL.

1. En ScoreApps, pulsa Copy Webhook.
2. Vuelve a Meta > Messenger API Settings > Configure webhooks.
3. Pega la URL en Callback URL.
4. Introduce el mismo Verify token usado en ScoreApps.
5. Pulsa Verify and save.

6. Suscribir eventos del webhook

Después de verificar el webhook, activa al menos messages y messaging_postbacks.

7. Suscribir la página al webhook

En Generate access tokens, la página debe aparecer conectada. Revisa la columna Webhook Subscription: si aparece vacía o Meta indica que no hay campos suscritos, pulsa Add Subscriptions. Si ya ves messages y messaging_postbacks, esa parte está correcta.

8. Probar y pasar a producción

1. Añade como tester o administrador a la persona que hará la prueba si la app sigue en desarrollo.
2. Envía un mensaje a la página desde Messenger.
3. Comprueba que la conversación aparece en ScoreApps.
4. Para usuarios reales, solicita App Review para pages_messaging.

9. Pasar la app a producción y solicitar App Review

La integración técnica anterior permite probar Messenger en modo desarrollo, pero no habilita automáticamente el uso con clientes normales. Para que cualquier usuario pueda escribir a la página y recibir respuesta del chatbot, la app de Meta debe publicarse y pasar revisión para los permisos de Messenger.

9.1 Completar los datos obligatorios de la app

Antes de enviar la revisión, entra en Settings > Basic y completa como mínimo:

• App icon: icono cuadrado de 1024 x 1024 px.
• Privacy policy URL: política de privacidad pública y accesible.
• Category: categoría de la app.
• Contact email: correo operativo.
• User data deletion: URL con instrucciones o endpoint de eliminación de datos.
• App domains: dominio desde el que opera la integración, por ejemplo el dominio de ScoreApps o el dominio propio si aplica.

Si estos datos faltan, Meta bloqueará el envío aunque el webhook esté funcionando.

9.2 Revisar los permisos incluidos en la solicitud

En Review > App Review, Meta muestra los permisos que se enviarán a revisión. Para Messenger suelen aparecer permisos como pages_messaging, pages_manage_metadata, pages_show_list, business_management y public_profile. El permiso crítico para recibir y responder mensajes reales es pages_messaging.

9.3 Completar los bloques de Submit for App Review

Al pulsar Next, Meta abre Submit for App Review. Ahí deben completarse estos bloques:

• Verification: confirma que el negocio y el acceso están verificados.
• App settings: comprueba que nombre, email, icono, categoría, privacidad y eliminación de datos están completos.
• Allowed usage: certifica que los permisos se usan solo para el caso permitido.
• Data handling: explica cómo se reciben, usan, almacenan, protegen y eliminan los datos de Messenger.
• Reviewer instructions: describe paso a paso cómo el revisor puede probar la integración.

9.4 Qué escribir en Allowed usage

La explicación debe ser concreta. Un texto válido para adaptar sería:

Usamos pages_messaging para recibir mensajes enviados por usuarios a la página de Facebook conectada y enviar respuestas automáticas generadas por el chatbot de IA configurado por el propietario de la página en ScoreApps. No usamos estos permisos para publicar contenido, leer mensajes fuera de la conversación de la página ni compartir datos con terceros.

Para pages_manage_metadata y pages_show_list, explica que se usan para listar las páginas administradas, conectar la página correcta y mantener la suscripción del webhook.

9.5 Qué explicar en Data handling

Indica de forma clara:

• Qué datos se reciben: identificador del usuario de Messenger, mensaje enviado, página de destino y metadatos técnicos del webhook.
• Para qué se usan: procesar la conversación y generar la respuesta del chatbot.
• Dónde se muestran: en la conversación del chatbot dentro de ScoreApps.
• Quién tiene acceso: el administrador de la cuenta/página y usuarios autorizados.
• Cómo se eliminan: mediante solicitud al responsable de la cuenta o el mecanismo de eliminación definido en la política de privacidad.

9.6 Qué debe contener el vídeo para Meta

Meta puede rechazar la revisión si no puede reproducir el caso de uso. Prepara un vídeo corto, sin contraseñas ni tokens visibles, con esta secuencia:

1. Mostrar la app en Meta y el permiso pages_messaging solicitado.
2. Mostrar la página de Facebook conectada.
3. Mostrar ScoreApps en IA > Agentes de IA > Canal > Messenger con el canal creado.
4. Enviar un mensaje a la página desde Messenger usando una cuenta de prueba.
5. Mostrar que el mensaje entra en ScoreApps.
6. Mostrar que el chatbot responde en Messenger.
7. Explicar que el objetivo es atención automatizada de mensajes iniciados por usuarios en la página.

9.7 Instrucciones para el revisor

En Reviewer instructions, incluye un texto operativo como este:

1. Open the Facebook Page connected to this app.
2. Send a Messenger message to the Page, for example: "Hola, necesito información".
3. The message is received by the ScoreApps chatbot through the configured webhook.
4. The chatbot generates a response and sends it back to Messenger.
5. The Page administrator can review the conversation inside ScoreApps.

Si la app sigue en desarrollo, añade al revisor como tester o proporciona una cuenta de prueba con instrucciones claras. No incluyas contraseñas, App Secret ni Page Access Token dentro del artículo ni del vídeo.

9.8 Publicar la app

Cuando Meta apruebe la revisión, entra en Publish y cambia la app de Unpublished / Development a Live. Después prueba con una cuenta que no sea administradora ni tester. Si esa cuenta puede escribir a la página y recibir respuesta del chatbot, la integración ya está operativa para clientes normales.

Errores frecuentes

• Webhook verificado, pero no responde: faltan eventos o la página no está suscrita.
• Token inválido: se copió un token enmascarado en vez de usar Copy.
• Solo funciona con administradores: la app sigue en desarrollo o falta App Review.
• Verify token incorrecto: Meta y ScoreApps no tienen exactamente el mismo valor.