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#
| Permiso | Para qué sirve | Tipo |
|---|---|---|
webhooks:leer | Ver los webhooks | lectura |
webhooks:gestionar | Crear y eliminar webhooks | escritura |
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)#
| Campo | Descripción |
|---|---|
nombre | obligatorio |
url | obligatorio: https://… |
eventos | obligatorio: lista de eventos (GET /webhooks → eventos_disponibles) |
canales | opcional: 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)#
| Campo | Descripción |
|---|---|
id | obligatorio |
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"}}.