Leer el historial de DM de Instagram: la API de conversaciones
La API de conversaciones de Instagram lee el historial de DM de una cuenta profesional en graph.instagram.com. GET /me/conversations?platform=instagram lista las conversaciones con su updated_time, GET /<CONVERSATION_ID>?fields=messages lista los mensajes de una conversación por ID y hora, y GET /<MESSAGE_ID>?fields=id,created_time,from,to,message devuelve un mensaje. Los detalles están disponibles para los 20 mensajes más recientes de cada conversación.
easyCoexistence reenvía los DM nuevos de Instagram a tu endpoint conforme llegan y responde con send_social_dm dentro de la ventana de atención de 24 horas, desde Claude, ChatGPT o tu propio código, con la API oficial de Meta; no tiene herramienta para el historial de la Conversations API.
Los mensajes más recientes de cada conversación cuyos detalles devuelve la API; los más antiguos responden con un error que indica que fueron eliminados.
Inactividad tras la cual las conversaciones de la carpeta de Solicitudes ya no se devuelven.
Llamadas a la API de conversaciones que una app puede hacer por segundo para cada cuenta profesional de Instagram.
instagram_business_basic e instagram_business_manage_messages, con un token de alguien que puede gestionar los mensajes de la cuenta.
¿Cómo se listan las conversaciones de una cuenta?
Con GET /me/conversations, o /<IG_ID>/conversations, y platform=instagram, usando un token de acceso de usuario de Instagram de alguien que pueda gestionar los mensajes de la cuenta. Cada entrada del array data es una conversación, con su id y su updated_time.
GET https://graph.instagram.com/me/conversations
?platform=instagram
&access_token=<ACCESS_TOKEN>
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
]
}¿Cómo se encuentra la conversación con una persona?
Se añade user_id con el ID con alcance de Instagram de la persona, el IGSID que llega como sender.id cuando escribe a la cuenta, y la respuesta devuelve el id de esa conversación. Convierte un evento de webhook en su hilo sin recorrer toda la lista.
GET https://graph.instagram.com/me/conversations
?user_id=<IGSID>
&access_token=<ACCESS_TOKEN>¿Cómo se leen los mensajes?
En dos pasos. GET /<CONVERSATION_ID>?fields=messages lista los mensajes de la conversación por id y created_time, que son los campos por defecto. Después, GET /<MESSAGE_ID> con fields=id,created_time,from,to,message devuelve un mensaje: quién lo envió y a quién, cada uno con un nombre de usuario y un ID, y su texto.
GET https://graph.instagram.com/<CONVERSATION_ID>
?fields=messages
&access_token=<ACCESS_TOKEN>
GET https://graph.instagram.com/<MESSAGE_ID>
?fields=id,created_time,from,to,message
&access_token=<ACCESS_TOKEN>¿Hasta qué punto se puede leer hacia atrás?
La guía y la visión general de Meta establecen cuatro límites sobre lo que se devuelve:
- Detalles de mensajes: los 20 mensajes más recientes de cada conversación; pedir uno más antiguo devuelve un error que indica que ha sido eliminado.
- Solicitudes: las conversaciones de la carpeta de Solicitudes sin actividad durante 30 días no se devuelven.
- Compartidos: una publicación o Reel compartido solo se devuelve como URL de su imagen o video.
- Límite de tasa: 2 llamadas por segundo para cada cuenta profesional de Instagram.
¿Qué necesita?
Con Instagram Login, los permisos instagram_business_basic e instagram_business_manage_messages y un token de alguien que pueda gestionar los mensajes de la cuenta. El Acceso estándar basta para las cuentas que posees o gestionas y que has añadido a la app; atender otras cuentas requiere el Acceso avanzado. Además, la cuenta debe tener activada la opción Permitir acceso a los mensajes en la configuración de su app de Instagram.
¿Por qué guardar un registro desde los webhooks?
Como la API devuelve detalles solo de los 20 últimos mensajes de cada conversación, el historial completo debe guardarse a medida que ocurre. El webhook de mensajes entrega los DM conforme llegan, con el IGSID de la persona como sender.id, y los mensajes que envía la cuenta también llegan, con los IDs en sentido contrario, de modo que se pueden registrar ambos lados de una conversación.
¿Cómo se lee el historial de DM a través de easyCoexistence?
Reenvía los DM en lugar de leer el historial. Los DM nuevos llegan a tu endpoint conforme se reciben, una vez configurado con set_social_webhook_destination, y se reenvían sin guardar copia; send_social_dm responde dentro de la ventana de atención de 24 horas, desde Claude, ChatGPT o tu propio código. Ninguna herramienta llama a me/conversations, así que los mensajes anteriores se leen en la app de Instagram, o los guarda tu propio sistema conforme llegan.
Errores comunes
- Esperar el hilo completo desde la API. Los detalles se detienen en los 20 mensajes más recientes, así que guarda los DM del webhook de mensajes conforme llegan.
- Consultar en bucle las conversaciones para buscar DM nuevos. La API permite 2 llamadas por segundo por cuenta, mientras que el webhook de mensajes entrega cada DM en cuanto llega.
- Buscar una solicitud de mensaje antigua. Las conversaciones de Solicitudes con 30 días de inactividad ya no se devuelven.
- Leer el error de eliminado como si la persona hubiera borrado el mensaje. Meta responde así a cualquier mensaje anterior a los 20 más recientes.
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, y los primeros 3 días gratis.
Preguntas frecuentes
¿Puedo exportar el historial completo de DM de una cuenta de Instagram?
No completo a través de la API: lista las conversaciones, pero devuelve detalles solo de los 20 mensajes más recientes de cada una. Un registro completo se obtiene guardando los DM conforme los entrega el webhook.
¿Leer mensajes a través de la API los marca como leídos?
No. Meta indica que los mensajes entregados a través de la API no se marcan como leídos en la app de Instagram hasta que se envía una respuesta.
¿La API de conversaciones funciona con Instagram Login?
Sí. La guía de Meta para ella está escrita para Instagram Login, con llamadas a graph.instagram.com y los permisos instagram_business_*.
¿Cómo obtengo el nombre de usuario de una persona desde una conversación?
Pide from en un mensaje, que devuelve el nombre de usuario y el ID del remitente. La API de perfil de usuario devuelve más, como el nombre, a partir de su IGSID una vez que han escrito a la cuenta.
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