Beta privada · apertura 23 de diciembre
Consulta un mensaje
GET /v1/conecta/mensajes/{id}
Estado de entrega de un mensaje enviado o detalle de uno recibido.
| Dato | Valor |
|---|---|
| Permiso | conecta:leer |
| Cobro | No cobra. |
Idempotency-Key |
No aplica |
| Herramienta MCP | mensaje_ver (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
id |
path | Sí | string | Identificador que empieza con msg_. |
X-Request-Id |
header | No | string | Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl "https://api-sandbox.opennexum.com/v1/conecta/mensajes/msg_8f2c1a7d9e" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»Mensaje.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
id |
string | Sí | Identificador que empieza con msg_. |
conexion_id |
string | Sí | Identificador que empieza con con_. |
conversacion_id |
string | Sí | Identificador que empieza con cnv_. |
canal |
“whatsapp” | “instagram” | “messenger” | Sí | |
direccion |
“saliente” | “entrante” | Sí | |
tipo |
“texto” | “media” | “plantilla” | “interactivo” | “otro” | Sí | |
texto |
string | null | Sí | |
media |
object | null | Sí | En mensajes entrantes, la URL es nuestra y vence en unas horas. |
media.tipo |
“imagen” | “video” | “audio” | “documento” | Sí | |
media.url |
string (uri) | Sí | |
media.nombre_archivo |
string | null | Sí | |
media.leyenda |
string | null | Sí | |
plantilla |
object | null | Sí | |
plantilla.nombre |
string | Sí | |
plantilla.idioma |
string | Sí | |
estado |
“en_cola” | “enviado” | “entregado” | “leido” | “fallido” | “incierto” | “recibido” | Sí | incierto: el proveedor no confirmó; revisa antes de reenviar. recibido: mensaje entrante. |
error |
object | null | Sí | |
error.codigo |
string | Sí | |
error.mensaje |
string | Sí | |
creado_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
actualizado_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 404
no_encontrado - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible