Para qué sirve#
Registra una Página de Facebook (Messenger) o una cuenta profesional de Instagram para recibir y responder sus mensajes directos desde Connecto. Ambas redes usan el mismo tipo de token: el de la Página de Facebook.
Quién puede usarlo: administradores («Solo un administrador puede registrar canales.»).
Cómo llegar: Ajustes de sistema → Canales de mensajería → Agregar canal → Messenger o Instagram.
Lo que dice la ventana de selección:
- Messenger: «Conecta tu Página de Facebook para enviar y recibir mensajes de Messenger directamente desde Connecto GG.» Requisito: una Página de Facebook y tu aplicación de Meta con el producto Messenger activo.
- Instagram: «Conecta tu cuenta profesional de Instagram para recibir y responder mensajes directos desde Connecto GG.» Requisito: cuenta profesional de Instagram vinculada a una Página de Facebook.
Messenger: formulario «Conectar Messenger»#
| Campo | Qué hace | Obligatorio |
|---|---|---|
| Nombre del canal | Nombre en Connecto | Sí |
| ID de la Página de Facebook | Número de la Página (Meta → Página → Información). Es el que llega en cada mensaje del webhook | Sí (solo se guardan dígitos) |
| Page Access Token (opcional) | Token de la Página | No: si lo dejas vacío, Connecto lo pide a Meta con el token de la aplicación (la Página debe estar asignada a esa aplicación) |
Instagram: formulario «Conectar Instagram»#
| Campo | Qué hace | Obligatorio |
|---|---|---|
| Nombre del canal | Nombre en Connecto | Sí |
| ID de la cuenta de Instagram | Identificador de la cuenta profesional. No es el ID de la Página: es otro número, normalmente de 17 dígitos y que empieza por 17841… (Meta → Instagram → Configuración de la API) | Sí |
| ID de la Página de Facebook vinculada | La Página a la que está vinculada la cuenta | Sí |
| Page Access Token | El mismo token de Página que usa Messenger (Meta → Messenger/Instagram → Configuración de la API → Generar token) | Se recomienda; si se deja vacío se intenta obtener con el token de la aplicación |
En ambos formularios aparece la URL del webhook (https://tu-dominio/webhook/meta) que debes registrar en Meta.
Paso a paso#
- Pulsa Agregar canal y elige Messenger o Instagram.
- Completa los campos de la tabla y pulsa Guardar.
- Connecto valida el token y suscribe la Página al webhook automáticamente.
- Verás «Messenger registrado correctamente.» o «Instagram registrado correctamente.»
Si la suscripción automática falla, el registro se guarda igual y aparece este aviso adicional: «Aviso: no se pudo suscribir la Página al webhook; hazlo desde Meta (Webhooks → Página).» En ese caso entra a Meta y suscribe tú la Página al webhook.
Validaciones y mensajes de error#
| Mensaje | Cuándo aparece |
|---|---|
| «El nombre y el ID de la Página son obligatorios.» | Messenger sin nombre o sin ID |
| «El nombre, el ID de la Página y el ID de la cuenta de Instagram son obligatorios.» | Instagram con algún dato vacío |
| «El ID de la cuenta de Instagram no puede ser el mismo que el de la Página: son distintos (el de Instagram suele empezar por 17841…).» | Pusiste el mismo número en ambos campos |
| «Falta el Page Access Token.» | No hay token propio ni token de aplicación disponible |
| «No se pudo obtener el token de la Página con el token de la app (…). Pega el Page Access Token.» | Dejaste el token vacío y Meta no entregó el de la Página |
| «Meta dice que el token no es válido…» | El token es inválido o venció |
| «Ese token es de tipo … , no de una Página. Genera el Page Access Token de la Página…» | Pegaste un token de usuario u otro tipo |
| «El token pertenece a otra Página (ID …), no a la …» | El token no corresponde al ID de Página escrito |
| «No se pudo registrar Messenger: …» / «No se pudo registrar Instagram: …» | Mensaje general que acompaña al motivo |
Reglas y comportamientos#
- Si registras otra vez la misma Página (o la misma cuenta de Instagram), no se crea un canal nuevo: se actualiza el existente y queda Conectado.
- En Instagram, los mensajes entrantes se reconocen por el ID de la cuenta de Instagram, no por el de la Página.
- Se reciben texto, imágenes, videos, audios, archivos y ubicaciones. Los mensajes enviados por la propia Página (ecos) se ignoran. Las historias, los reels y los contenidos compartidos todavía no se procesan.
- Connecto lee el nombre y la foto del contacto desde Meta cuando llega un mensaje.
- Los mensajes libres se permiten 24 horas después del último mensaje del contacto; después hay que usar una plantilla.
- Messenger e Instagram admiten plantillas (de tipo utilidad). Para crearlas, la Página debe tener concedido el permiso
pages_utility_messaging. - Los mensajes automáticos (bienvenida, resolución, etc.) se envían a estas redes como texto plano: se quitan los símbolos de formato de WhatsApp.
Comentarios de las publicaciones (Facebook e Instagram)#
Además de los mensajes directos, Connecto puede recibir los comentarios de las publicaciones de tu Página de Facebook y de tu cuenta de Instagram (publicaciones, carruseles y reels; en Instagram también los directos) y responderlos desde el Chat. Está apagado por defecto: se activa en Detalle de canal › Comentarios del canal de Messenger o de Instagram, y exige leer y aceptar un aviso.
Qué pasa con cada comentario#
- Cada persona que comenta es un contacto. Si ya te había escrito por mensaje directo, el comentario cae en su misma conversación.
- Cada mensaje muestra de qué publicación viene (texto y enlace) y si es un comentario o una respuesta dentro de otro comentario.
- Solo entran los comentarios nuevos (los que lleguen desde que activas la función): Meta avisa de lo que ocurre, no entrega el historial.
- Si la persona edita o borra su comentario, el mensaje queda marcado como editado o eliminado (el texto se conserva para el asesor).
- A quien solo comentó no se le envían mensajes automáticos (bienvenida, cierre, encuestas, avisos de inactividad): no hay un mensaje directo al que mandarlos.
- Lo que comenta la propia Página o cuenta no se importa como mensaje de un cliente.
Responder#
Pulsa Responder sobre el comentario y elige:
| Modo | Qué hace | Límites |
|---|---|---|
| Respuesta pública | Se publica bajo el comentario y la ve todo el mundo. | Hasta 8.000 caracteres en Facebook y 2.200 en Instagram. En Instagram solo se responde a comentarios de primer nivel (si el comentario es una respuesta, se responde al principal). |
| Respuesta privada | Se envía por mensaje directo a quien comentó. | Una sola vez por comentario, dentro de los 7 días siguientes, hasta 2.000 caracteres. Si la persona contesta, la conversación sigue por mensaje directo con normalidad. |
Un mensaje que no responde a un comentario sigue yendo por mensaje directo, como siempre. Si Meta rechaza algo (token vencido, falta un permiso, el comentario se borró, ya se envió la respuesta privada), el mensaje queda marcado como fallido con el motivo.
Activarlo, paso a paso#
- En Meta, la aplicación debe estar en modo Live y tener aprobados los permisos de comentarios (para tu propia Página y tu propia cuenta basta el acceso estándar si eres administrador de la aplicación; para cuentas de clientes hace falta la revisión de Meta).
- En Detalle de canal › Comentarios revisa la lista de permisos del token: Connecto consulta a Meta cuáles tiene y cuáles faltan.
- Facebook:
pages_show_list,pages_manage_metadata,pages_read_engagement,pages_read_user_contentypages_manage_engagement. - Instagram:
instagram_basic,instagram_manage_comments,pages_read_engagementypages_show_list. - Para la respuesta privada:
pages_messaging(Facebook) oinstagram_manage_messages(Instagram).
- Facebook:
- Si falta alguno, genera un token nuevo de la Página en Meta (con una persona que tenga la tarea «Moderar» en la Página), pégalo en el campo y pulsa Guardar token. Connecto comprueba que sea de esa Página.
- Mueve el interruptor, marca «Entiendo el aviso» y pulsa Activar comentarios. Queda registrado quién lo aceptó y cuándo. Apagarlo no pide confirmación.
- Facebook: Connecto suscribe la Página al campo
feedsolo. Instagram: intenta suscribir la cuenta al campocomments; si Meta no lo permite por ese camino, te indica que lo marques en Meta › Webhooks › Instagram (comments, ylive_commentspara los directos).
Cosas que conviene saber#
- En Instagram la cuenta debe ser pública: de las privadas Meta no envía avisos de comentarios.
- Las respuestas a una story llegan como mensajes directos (ya funcionaba), no como comentarios.
- No está verificado si Meta avisa de los comentarios de los reels por el mismo campo; se confirma con un reel real.
- Los comentarios de una publicación patrocinada (anuncio) de Facebook sí llegan por el campo
feed. - Publicar contenido nuevo (publicaciones, reels) desde Connecto no está incluido.
Desconectar o eliminar#
Se hace desde el detalle del canal. Mira Canales de mensajería y Detalle de un canal.
<!-- Fuente: tenant-app/public/configuracion/index.php (acción channel_save tipo messenger/instagram, formularios), shared/src/Core/MetaChannelClient.php, node/src/channels/messenger.js, node/src/channels/instagram.js, node/src/channels/metaAttachments.js, node/src/metaHandler.js, node/src/autoMessages.js, tenant-app/views/partials/plantillas_canal.php -->