Ir al contenido

Beta privada · apertura 23 de diciembre

Consulta una conversación

GET /v1/conecta/conversaciones/{id}

Contacto, ventana de atención y mensajes sin leer de una conversación.

Dato Valor
Permiso conecta:leer
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP conversacion_ver (Próximamente)
Nombre En Requerido Tipo Descripción
id path Sí string Identificador que empieza con cnv_.
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" \
-H "Authorization: Bearer onx_test_…"

Conversación.

Campo Tipo Requerido Descripción
id string Sí Identificador que empieza con cnv_.
conexion_id string Sí Identificador que empieza con con_.
canal “whatsapp” | “instagram” | “messenger” Sí
contacto object Sí
contacto.nombre string | null Sí
contacto.telefono string | null Sí
contacto.usuario string | null Sí Usuario de Instagram, si aplica.
ventana object Sí Ventana de atención: mientras está abierta puedes escribir libre; si no, solo plantillas.
ventana.abierta boolean Sí
ventana.cierra_en string (date-time) | null Sí
ventana.tipo “24h” | “72h” | null Sí 72h cuando el contacto llegó por un anuncio.
no_leidos integer Sí
ultimo_mensaje_en string (date-time) | null Sí
creada_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).

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