Ir al contenido

Beta privada · apertura 23 de diciembre

Lista los mensajes de una conversación

GET /v1/conecta/conversaciones/{id}/mensajes

Mensajes enviados y recibidos, del más reciente al más antiguo.

Dato Valor
Permiso conecta:leer
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP conversacion_mensajes (Próximamente)
Nombre En Requerido Tipo Descripción
id path Sí string Identificador que empieza con cnv_.
cursor query No string Cursor opaco que devolvió la página anterior en siguiente_cursor.
limite query No integer Cuántos elementos traer (1 a 100; por defecto 20).
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl "https://api-sandbox.opennexum.com/v1/conecta/conversaciones/cnv_8f2c1a7d9e/mensajes" \
-H "Authorization: Bearer onx_test_…"

Página de mensajes.

Campo Tipo Requerido Descripción
elementos object[] Sí
elementos[].id string Sí Identificador que empieza con msg_.
elementos[].conexion_id string Sí Identificador que empieza con con_.
elementos[].conversacion_id string Sí Identificador que empieza con cnv_.
elementos[].canal “whatsapp” | “instagram” | “messenger” Sí
elementos[].direccion “saliente” | “entrante” Sí
elementos[].tipo “texto” | “media” | “plantilla” | “interactivo” | “otro” Sí
elementos[].texto string | null Sí
elementos[].media object | null Sí En mensajes entrantes, la URL es nuestra y vence en unas horas.
elementos[].media.tipo “imagen” | “video” | “audio” | “documento” Sí
elementos[].media.url string (uri) Sí
elementos[].media.nombre_archivo string | null Sí
elementos[].media.leyenda string | null Sí
elementos[].plantilla object | null Sí
elementos[].plantilla.nombre string Sí
elementos[].plantilla.idioma string Sí
elementos[].estado “en_cola” | “enviado” | “entregado” | “leido” | “fallido” | “incierto” | “recibido” Sí incierto: el proveedor no confirmó; revisa antes de reenviar. recibido: mensaje entrante.
elementos[].error object | null Sí
elementos[].error.codigo string Sí
elementos[].error.mensaje string Sí
elementos[].creado_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
elementos[].actualizado_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
siguiente_cursor string | null Sí Pásalo como cursor para la página siguiente; null si ya no hay más.

Cada código tiene su explicación en Errores.