Instagram y Facebook

Los mensajes de Instagram y Facebook Messenger usan los mismos contratos, permisos, bandeja y consumo que los demás canales de talkHero. Cada cuenta conserva su identidad; las reglas de Central no cambian de página o perfil al responder.

Conectar una cuenta

1. En Central → Proveedores → Nueva cuenta, selecciona Conectar Instagram o Facebook.
2. Selecciona el canal, su cliente, el ID numérico de la cuenta profesional de Instagram o página Facebook, el ID de la aplicación Meta y la versión Graph habilitada para tu aplicación.
3. Guarda access_token, app_secret y verify_token. Instagram requiere un token de Instagram Login con instagram_business_basic e instagram_business_manage_messages; Messenger usa un token de página con pages_messaging.
4. Comprueba la cuenta y habilítala. La comprobación consulta la identidad; no envía mensajes ni sustituye la aprobación de permisos y suscripciones de Meta.
5. Configura el webhook HTTPS mostrado en Central: /v1/social/events/{cuenta}. Su GET responde al desafío con el verify_token; su POST comprueba la firma SHA-256 del cuerpo original. Suscribe messages en Meta y activa la suscripción de la cuenta. Una aplicación puede compartir la URL entre sus cuentas registradas; cada destinatario se resuelve y verifica de forma independiente.
6. Habilita Instagram o Facebook Messenger en el contrato del cliente. Configura reglas y tarifas documentadas para ese servicio en Central.
7. En Panel → Canales, crea el canal con el mismo ID remitente, vincula la cuenta y verifica su conexión. Puedes asignarle un agente publicado o dejarlo para atención humana.

Recibir y responder

Los mensajes entrantes crean un contacto identificado dentro de su canal. Un mensaje repetido no crea otra conversación ni otra respuesta. El agente publicado responde cuando su contrato y configuración lo permiten; si el cliente pide una persona, la conversación pasa al equipo humano. Los adjuntos no procesados se señalan para revisión en el canal de origen.

En Bandeja puedes tomar la conversación, asignarla, responder y agregar notas internas. Las notas internas no se envían a Meta. Las respuestas extensas de la bandeja se dividen respetando caracteres y un máximo de 1000 bytes UTF-8 por mensaje. Cada parte aceptada cuenta como un mensaje del servicio.

Solo se envían respuestas durante las 24 horas posteriores al último mensaje entrante del cliente. Un consentimiento permanente no amplía esa ventana. Los mensajes antiguos, ecos y confirmaciones de lectura no la renuevan. Las bajas bloquean envíos hasta que exista autorización vigente.

API

Una clave con messages:read y messages:write permite consultar y enviar con /v1/messages. El cuerpo contiene channel_account_id, recipient_identity_id, purpose y content.text; el encabezado Idempotency-Key identifica el intento lógico. La API directa admite hasta 1000 bytes UTF-8 por mensaje social. El destinatario debe pertenecer a ese canal y tener una ventana de respuesta vigente.

El estado Aceptado confirma que Meta devolvió una referencia de mensaje; no confirma lectura ni entrega al destinatario. El consumo de talkHero corresponde a mensajes aceptados y utiliza las condiciones del contrato. El costo monetario del proveedor no se inventa a partir de esa aceptación. Si se pierde la respuesta del proveedor, el envío queda Incierto para revisión, sin reenviarlo automáticamente. Los rechazos se muestran en Mensajes y en las operaciones de Central.

Alcance de esta actualización

Incluye mensajes de texto, agentes, transferencia interna al equipo, respuestas humanas, API, errores y consumo. Publicaciones, comentarios, campañas sociales avanzadas, adjuntos procesados, etiquetas para responder fuera de ventana y transferencias a otras aplicaciones quedan fuera. Las credenciales y la aceptación con cuentas reales se verifican por separado de las pruebas locales.

Contratos oficiales: Instagram Messaging API, webhooks de Instagram y Messenger Send API.