Obtiene los mensajes del contacto
Devuelve un array plano en orden cronológico, del mensaje más viejo al más nuevo.
Sin parámetros devuelve el hilo COMPLETO, como siempre. Es el comportamiento por defecto y no cambió: si ya integrabas contra este endpoint, no tienes que tocar nada.
Con limit (1–200) devuelve en cambio la ventana MÁS RECIENTE — los últimos N mensajes, igual en orden cronológico. Para seguir hacia atrás, manda before con el id del mensaje más viejo que ya tienes y recibes la ventana anterior.
No hay campo has_more: si volvieron menos de limit mensajes, llegaste al principio de la conversación.
Quién habló se lee en role (user = el contacto, operator = tu equipo, agent = el Met). No existe un campo direction.
Ojo con el scope: aunque la ruta cuelga de /contacts, este endpoint pide conversations:read, no contacts:read. Una key emitida solo con contacts:read / contacts:write lista contactos pero recibe 403 missing_scope acá. Es la causa más frecuente de error en este endpoint.
Un 404 Contacto no encontrado no distingue entre "no existe", "no es de tu workspace" y "tu usuario no lo tiene a la vista": se responde igual en los tres casos, a propósito, para no confirmar la existencia de contactos ajenos.
Request
- Base URL: https://api.met.meteor.com.co/api/v1
- URL: https://api.met.meteor.com.co/api/v1/contacts/{contactId}/messages
- Auth: one of:
- bearer (a scheme the document does not define)
- HTTP bearer
Path parameters
ID del contacto del CRM.
Query parameters
Devuelve solo los últimos N mensajes (1–200). Omítelo para el hilo completo.
Id del mensaje más viejo que ya tienes: devuelve la ventana anterior a ese. Requiere limit.
Devuelve solo el hilo de esa línea (el número, página o cuenta por la que pasó el mensaje). Los mensajes sin línea —los anteriores a que se guardara, y las notas— salen en todas las vistas: no se puede saber por dónde pasaron y esconderlos borraría historia. Sin este parámetro se devuelve el hilo completo.
Response
Example response
{
"data": [
{
"agent_id": 77,
"channel_id": 5,
"contact_id": 4821,
"content": "¿Todavía tienen disponibilidad para el viernes?",
"created_at": "2026-07-30T04:12:33.120385Z",
"id": 918273,
"message_type": "text",
"origin": "panel",
"role": "user",
"sent_by_name": "Ana Ruiz",
"sent_by_user_id": 42,
"source": "whatsapp"
}
]
}Changes
No recorded changes to this operation across all 2 revisions of this API.