Ir al contenido
Documentación de Connecto
connecto.lat
API para desarrolladoresReferencia

Conversaciones y mensajes

Lee las conversaciones (con su canal, estado y asesor) y los mensajes de cada una.

Permisos#

PermisoPara qué sirveTipo
conversaciones:leerLeer conversaciones y mensajeslectura

Endpoints#

GET /conversaciones#

Lista conversaciones. Filtros: estado (open, pending, resolved), contacto_id, actualizada_desde, limite, pagina.

Permiso: conversaciones:leer · lectura

Parámetros de la consulta#

ParámetroDescripción
estadoopen | pending | resolved
contacto_idid del contacto
actualizada_desdefecha
limite1 a 100
paginapágina
Ejemplo en curl
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/conversaciones?estado=valor" \
  -H "Authorization: Bearer cnx_TU_LLAVE"
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/conversaciones?estado=valor", {
  method: "GET",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY }
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/conversaciones?estado=valor");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY")],
]);
$datos = json_decode(curl_exec($ch), true);

GET /conversaciones/{id}#

Una conversación.

Permiso: conversaciones:leer · lectura

Ejemplo en curl
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/conversaciones/{id}" \
  -H "Authorization: Bearer cnx_TU_LLAVE"
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/conversaciones/{id}", {
  method: "GET",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY }
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/conversaciones/{id}");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY")],
]);
$datos = json_decode(curl_exec($ch), true);

GET /conversaciones/{id}/mensajes#

Mensajes de una conversación (los más recientes primero).

Permiso: conversaciones:leer · lectura

Parámetros de la consulta#

ParámetroDescripción
limite1 a 100
antes_de_idpara seguir con los más antiguos
Ejemplo en curl
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/conversaciones/{id}/mensajes?limite=valor" \
  -H "Authorization: Bearer cnx_TU_LLAVE"
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/conversaciones/{id}/mensajes?limite=valor", {
  method: "GET",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY }
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/conversaciones/{id}/mensajes?limite=valor");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY")],
]);
$datos = json_decode(curl_exec($ch), true);
¿Te fue útil esta página?
Última actualización: 14/11/2026