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

Webhooks (suscribirse a eventos)

Un sistema externo se suscribe a los eventos de la cuenta (mensaje.recibido, mensaje.enviado, mensaje.estado, canal.conectado…), opcionalmente solo de ciertos canales, sin entrar a la pantalla de administración. Cada aviso va firmado con un secreto que se muestra una sola vez. Nace apagada.

Esta API nace apagada: actívala en Configuración → APIs antes de usarla.

Permisos#

PermisoPara qué sirveTipo
webhooks:leerVer los webhookslectura
webhooks:gestionarCrear y eliminar webhooksescritura

Endpoints#

GET /webhooks#

Lista los webhooks y los eventos disponibles.

Permiso: webhooks:leer · lectura

Ejemplo en curl
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/webhooks" \
  -H "Authorization: Bearer cnx_TU_LLAVE"
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/webhooks", {
  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/webhooks");
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);

POST /webhooks#

Crea un webhook. La dirección debe ser https y pública. Responde con el «secreto» de la firma (única vez).

Permiso: webhooks:gestionar · escritura

Cuerpo (JSON)#

CampoDescripción
nombreobligatorio
urlobligatorio: https://…
eventosobligatorio: lista de eventos (GET /webhooks → eventos_disponibles)
canalesopcional: ids de canal; vacío = todos
Ejemplo de cuerpo
{
  "nombre": "Mi aplicación",
  "url": "https://miapp.com/hooks/connecto",
  "eventos": [
    "mensaje.recibido",
    "mensaje.estado"
  ],
  "canales": [
    3
  ]
}
Ejemplo en curl
curl -X POST "https://TU_SUBDOMINIO.connecto.lat/api/v1/webhooks" \
  -H "Authorization: Bearer cnx_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Mi aplicación","url":"https://miapp.com/hooks/connecto","eventos":["mensaje.recibido","mensaje.estado"],"canales":[3]}'
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/webhooks", {
  method: "POST",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "nombre": "Mi aplicación",
    "url": "https://miapp.com/hooks/connecto",
    "eventos": [
        "mensaje.recibido",
        "mensaje.estado"
    ],
    "canales": [
        3
    ]
})
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/webhooks");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(array (
  'nombre' => 'Mi aplicación',
  'url' => 'https://miapp.com/hooks/connecto',
  'eventos' => 
  array (
    0 => 'mensaje.recibido',
    1 => 'mensaje.estado',
  ),
  'canales' => 
  array (
    0 => 3,
  ),
)),
]);
$datos = json_decode(curl_exec($ch), true);

POST /webhooks/eliminar#

Elimina un webhook.

Permiso: webhooks:gestionar · escritura

Cuerpo (JSON)#

CampoDescripción
idobligatorio
Ejemplo de cuerpo
{
  "id": 2
}
Ejemplo en curl
curl -X POST "https://TU_SUBDOMINIO.connecto.lat/api/v1/webhooks/eliminar" \
  -H "Authorization: Bearer cnx_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"id":2}'
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/webhooks/eliminar", {
  method: "POST",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "id": 2
})
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/webhooks/eliminar");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(array (
  'id' => 2,
)),
]);
$datos = json_decode(curl_exec($ch), true);

Respuesta#

crear: {"datos": {"id", "secreto"}}.

¿Te fue útil esta página?
Última actualización: 14/11/2026