Integración con Meta (Facebook)
Conecta tu agent a Facebook Messenger a través de tu Page de Facebook.
Cada Page de Facebook conectada también incluye una Tienda dentro de la app que se abre desde el Persistent Menu de la Page — catálogo de productos multipágina, chat de IA por producto y toma de pedidos en un toque dentro de Messenger. Consulta Tienda Messenger.
Descripción General
La integración con Meta ofrece:
- Conversaciones en Facebook Messenger a través de tu Page
- Una Tienda Messenger integrada que se abre desde el Persistent Menu de la Page
- Procesamiento en segundo plano con indicadores de escritura
- División automática de mensajes para respuestas largas
- Cumplimiento de la ventana de mensajería de 24 horas
- Memoria de conversación dentro de las sesiones
Requisitos Previos
- Una Page de Facebook que administres
- Rol de Admin o Editor en la Page
- Cuenta de Cuneiform Chat con un agent activo
Pasos de Configuración
1. Iniciar la Configuración de la Integración
- Ve a Agents → Selecciona tu agent
- Navega a la pestaña Integrations
- Haz clic en Meta (Facebook)
- Haz clic en Connect Page
2. Autorizar con Facebook
- Selecciona qué Agent debe responder
- Haz clic en Connect with Facebook
- Inicia sesión en Facebook (si es necesario)
- Selecciona la Page que deseas conectar
- Otorga los permisos de Messenger
- Serás redirigido de vuelta con un mensaje de éxito
3. Verificar la Conexión
Una vez conectada, tu Page aparecerá en la lista de integraciones mostrando:
- Nombre y estado de la Page
- Page ID
- Marca temporal de la última actividad
Cómo Funciona
Cuando los usuarios envían mensajes a tu Page de Facebook a través de Messenger:
- El mensaje llega vía Facebook Messenger
- El bot muestra un indicador de escritura mientras procesa
- Tu agent procesa la pregunta
- La respuesta se envía de vuelta por Messenger
Los mensajes se procesan en segundo plano. El bot muestra un indicador de escritura mientras tu agent genera una respuesta.
Funcionalidades
Respuestas Automáticas
Tu agent responde automáticamente a las conversaciones entrantes de Messenger según tu contenido. Todos los mensajes de texto activan una respuesta — sin comandos ni prefijos.
Indicadores de Escritura
Mientras tu agent procesa un mensaje, los usuarios ven un indicador de escritura (”…”) en Messenger, lo que da una sensación natural de conversación.
División de Mensajes
Las respuestas de más de 2.000 caracteres se dividen automáticamente en varios mensajes, conservando los saltos de párrafo y los límites de oración para mejorar la legibilidad.
Memoria de Conversación
El bot recuerda el contexto dentro de una sesión, por lo que los usuarios pueden hacer preguntas de seguimiento sin tener que repetirse.
Cola de Mensajes
Si un usuario envía mensajes adicionales mientras el bot aún procesa, se ponen en cola y se incluyen en la siguiente respuesta.
Ventana de Mensajería de 24 Horas
La política de Facebook permite respuestas dentro de las 24 horas posteriores al último mensaje del usuario. Tu agent responde en tiempo real, muy dentro de esa ventana. Tras 24 horas de inactividad, el usuario debe enviar un nuevo mensaje para reiniciar la conversación.
Los usuarios deben enviar el mensaje primero a tu Page — no puedes enviar mensajes no solicitados. Si pasan más de 24 horas desde su último mensaje, el bot no podrá responder hasta que el usuario vuelva a escribir.
Gestionar Pages
Ver Pages Conectadas
Cada Page conectada muestra:
- Nombre de la Page y estado de la conexión
- Agent asociado
- Información de actividad
Acciones Disponibles
| Acción | Descripción |
|---|---|
| Test Connection | Verifica que la integración esté funcionando |
| Disconnect | Elimina la conexión de la Page |
Accede a estas opciones desde el menú de tres puntos en cada Page conectada.
Solución de Problemas
La Page No Aparece
- Verifica que tengas el rol de Admin o Editor en la Page
- Revisa que hayas otorgado todos los permisos solicitados
- Intenta desconectar y volver a conectar
Los Mensajes No Reciben Respuesta
- Usa “Test Connection” para verificar la integración
- Comprueba que tu agent esté configurado y funcionando (pruébalo en el Playground)
- Asegúrate de que se hayan otorgado los permisos de Messenger
- Verifica que el usuario haya enviado un mensaje en las últimas 24 horas (política de la ventana de mensajería)
Errores de Autorización
- Cierra la sesión de Facebook e inténtalo de nuevo
- Verifica que tu cuenta de Facebook tenga acceso a la Page
- Comprueba que la Page no esté restringida por Facebook
Seguridad
- Los OAuth tokens están cifrados y almacenados de forma segura
- Las firmas de webhook se verifican con HMAC-SHA256 en cada solicitud entrante
- No hay acceso al contenido de la Page más allá de las conversaciones de Messenger
- Cumple con las políticas de la plataforma de Facebook
Desconectar
Para eliminar la integración con Meta:
- Ve a Agents → Selecciona el agent → Integrations
- Haz clic en el menú de tres puntos de tu Page
- Selecciona Disconnect
Para revocar el acceso por completo:
- Ve a Configuración de Facebook → Integraciones de Empresas
- Elimina la app de Cuneiform Chat
Notas Importantes
- Un agent por Page: Cada Page de Facebook solo puede conectarse a un AI agent a la vez
- Solo Messenger: Esta integración funciona a través de Facebook Messenger, no con comentarios o publicaciones de la Page
- Límite de mensajes: Los mensajes individuales se limitan a 2.000 caracteres; las respuestas más largas se dividen automáticamente
- Para cambiar de agent: Desconecta primero la integración existente y luego vuelve a conectar con un agent diferente