Leer el historial de conversaciones de Messenger a través de la API
El historial de Messenger de una Página de Facebook se lee con GET /{page-id}/conversations?platform=messenger, que lista los IDs de conversación con su hora de última actualización; luego GET /{conversation-id}?fields=messages devuelve los IDs de los mensajes y GET /{message-id} devuelve el remitente, el destinatario, el texto y los adjuntos de cada mensaje. Meta devuelve el detalle de los 20 mensajes más recientes de una conversación, y las llamadas necesitan un token de Página con pages_messaging.
easyCoexistence reenvía a tu endpoint los mensajes nuevos de Messenger de una Página al llegar, y send_social_dm responde dentro de la ventana de 24 horas, desde Claude, ChatGPT o tu propio código.
Solo los 20 mensajes más recientes de una conversación devuelven detalle; los más antiguos devuelven un error que indica que el mensaje fue eliminado.
Llamadas a la Conversations API que una app puede hacer por Página de Facebook.
Conversaciones en la carpeta de Solicitudes que no han estado activas durante este tiempo se excluyen de los resultados de la API.
La tarea de la Página que la persona detrás del token debe poder realizar para leer conversaciones.
Error por demasiadas llamadas a la API de Messenger a una cuenta de Página; Meta indica esperar un poco y volver a intentarlo.
¿Cómo se listan las conversaciones de una Página?
Con GET /{page-id}/conversations, indicando platform como messenger. El resultado contiene un array data con los IDs de conversación, cada uno con updated_time, la hora en que se añadió el último mensaje, y un objeto paging; la referencia de Meta indica que la paginación basada en tiempo no está disponible en este endpoint, así que sigue el objeto paging para recorrer la lista.
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}¿Cómo se encuentra la conversación de una persona?
Añade user_id, con el ID con alcance de Página de la persona, a la misma petición. Meta responde con el ID de la conversación entre la Página y esa persona, que es el camino más corto desde un webhook de mensajes, donde el PSID llega como sender.id, hasta el historial que hay detrás:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }¿Cómo se leen los mensajes de una conversación?
En dos pasos. GET /{conversation-id} con fields=messages devuelve los IDs de los mensajes de la conversación, cada uno con created_time, del más reciente al más antiguo; después, GET /{message-id} con los campos que necesites, como id, created_time, from, to, message y reply_to, devuelve el contenido de un mensaje. Los campos predeterminados son id y created_time, y un campo sin datos se omite en la respuesta.
¿Qué campos se pueden leer?
Una conversación y un mensaje exponen campos distintos. Estos son los que las referencias de Meta enumeran para la mensajería de Página:
- Conversación: id,
updated_time, participants con su ID, nombre y correo electrónico, messages, eis_ownercuando Conversation Routing está activado. - Mensaje: id,
created_time, from y to, cada uno con un ID, nombre y correo electrónico, y message, el texto, vacío cuando no hay ninguno. - attachments: archivos, imágenes y videos con sus URL de CDN, e
is_unsupported, que solo se devuelve cuando un mensaje contiene contenido no compatible. - reactions,
reply_tocon el mid al que responde eis_self_reply, y shares para publicaciones y reels compartidos. - tags: la carpeta y el origen del mensaje, como inbox, read o source:chat.
¿Hasta dónde se puede leer hacia atrás?
Toda la conversación en cuanto a IDs, pero no en cuanto a contenido. La guía de Meta indica que el endpoint de conversación devuelve todos los IDs de mensajes de una conversación, mientras que los detalles solo llegan para los 20 mensajes más recientes; pedir uno más antiguo devuelve un error que indica que el mensaje fue eliminado. Las conversaciones de la carpeta de Solicitudes inactivas durante 30 días no se devuelven en absoluto.
¿Qué permisos y tareas necesita?
Un token de acceso de Página de alguien que pueda realizar la tarea MESSAGING o MODERATE en la Página, con los permisos pages_manage_metadata, pages_read_engagement y pages_messaging. Leer conversaciones con personas que no tienen ningún rol en la app, en la Página ni en el negocio requiere Advanced Access, que Meta concede mediante App Review.
¿Qué límites se aplican a las llamadas?
Los límites de tasa de Meta dan a la Conversations API 2 llamadas por segundo por Página, y las llamadas que superan un límite devuelven el código 613 o 80006, con el mensaje There have been too many messenger api calls to this Page account. Una Página que alcanza el límite de alto volumen de Meta, como enviar más de 40 mensajes por segundo, no puede listar sus conversaciones hasta que baje el volumen, aunque una sola conversación aún puede leerse para ver nuevos mensajes.
¿Cuándo conviene usar la API en lugar de los webhooks?
Para el pasado. Los webhooks entregan los mensajes nuevos a medida que llegan, y Meta señala que las notificaciones pasadas no se pueden consultar después, así que la Conversations API es la forma en que una integración lee lo que llegó antes de empezar a escuchar, o se pone al día tras una interrupción. Con Conversation Routing activado, el campo is_owner reduce la lista a las conversaciones que la app debe responder, lo que Meta sugiere para recuperarse tras una interrupción.
¿Cómo lee easyCoexistence el historial de Messenger?
No lee el historial. La Página se conecta con los permisos pages_messaging, pages_manage_metadata y pages_read_engagement, pero ninguna herramienta llama a la Conversations API, y los tokens de Página no se entregan. Los mensajes nuevos llegan a tu endpoint mediante set_social_webhook_destination a medida que se reciben, reenviados sin conservar una copia, de modo que tu propio sistema conserve el historial que necesita.
Errores comunes
- Esperar el contenido de los mensajes en la llamada de listado. El endpoint de conversación devuelve IDs de mensajes; lee los campos de cada mensaje desde /{message-id}.
- Contar con todo el historial. Los detalles se detienen en los 20 mensajes más recientes, así que guarda lo que necesites de los webhooks conforme llegan los mensajes.
- Sondear si hay mensajes nuevos. Con 2 llamadas por segundo por Página, un bucle de sondeo pronto alcanza el límite de tasa, mientras que el webhook de mensajes los entrega en cuanto ocurren.
- Paginar conversaciones por fecha con since y until. La paginación basada en tiempo no está disponible en el endpoint de conversaciones; sigue el objeto paging en su lugar.
No tiene una herramienta para la Conversations API, así que el historial anterior se lee en la bandeja de la Página. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, y con los primeros 3 días gratis.
Preguntas frecuentes
¿La Conversations API incluye los mensajes propios de la Página?
Sí. Los campos from y to de un mensaje indican la persona o la Página, así que los mensajes de una conversación incluyen ambos lados.
¿Puedo leer conversaciones de Messenger sin App Review?
Para personas con un rol en la app o en la Página, Standard Access es suficiente. Las conversaciones con cualquier otra persona necesitan Advanced Access, concedido mediante App Review.
¿La Conversations API puede enviar respuestas?
No. La referencia de conversaciones de Meta indica que el edge no puede publicar; las respuestas van por la Send API en /{page-id}/messages.
¿easyCoexistence guarda mis conversaciones de Messenger?
No por defecto. Los eventos reenviados se transmiten sin conservar copia; con una automatización activada, el texto de los mensajes se guarda durante 7 días y los registros de ejecución de automatizaciones durante 30 días.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el