Un sistema externo ve los canales de la cuenta, crea y edita chats web con su código para insertar en un sitio, conecta una línea de WhatsApp por la ventana oficial de Meta, conecta un bot de Telegram y enciende o apaga canales. Nunca devuelve tokens. Nace apagada y sus permisos se dan de forma explícita.
Permisos#
| Permiso | Para qué sirve | Tipo |
|---|---|---|
canales:leer | Ver los canales | lectura |
canales:escribir | Crear chats web, conectar canales y encenderlos o apagarlos | escritura |
Endpoints#
GET /canales#
Lista los canales: id, nombre, tipo (whatsapp, messenger, instagram, telegram, helplive…), si están activos y sus datos públicos (número, página). Los chats web traen su «codigo» para insertar en el sitio.
Permiso: canales:leer · lectura
Parámetros de la consulta#
| Parámetro | Descripción |
|---|---|
tipo | filtrar por tipo de canal |
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/canales?tipo=valor" \
-H "Authorization: Bearer cnx_TU_LLAVE"const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales?tipo=valor", {
method: "GET",
headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY }
});
const datos = await respuesta.json();$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales?tipo=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);POST /canales/livechat#
Crea un chat web y devuelve el código <script> para pegarlo antes de </body> en el sitio. Se muestra solo en los «dominios» indicados.
Permiso: canales:escribir · escritura
Cuerpo (JSON)#
| Campo | Descripción |
|---|---|
nombre | obligatorio |
dominios | obligatorio: lista de sitios donde se mostrará (["tusitio.com"]) |
color | #RRGGBB del botón y el encabezado |
website | dirección del sitio |
ancho | 260 a 600 (380) |
alto | 360 a 800 (560) |
boton | {"modo": "icono" | "texto" | "ambos", "icono": "chat" | "soporte" | "ayuda" | "correo" | "telefono" | "estrella", "texto": "Soporte", "pos": "der" | "izq"} |
form_activo | true para pedir datos antes de chatear |
campos | {"nombre": {"mostrar": true, "obligatorio": true}, "email": {...}, "telefono": {...}} |
prechat_fields | campos extra: [{"label": "Empresa", "type": "text", "required": false}] |
asunto_modo | no | libre | lista | lista_otro |
asuntos | lista de asuntos (con modo lista) |
{
"nombre": "Chat de mi sitio",
"dominios": [
"tusitio.com",
"www.tusitio.com"
],
"color": "#10B981",
"boton": {
"modo": "ambos",
"icono": "soporte",
"texto": "Soporte",
"pos": "der"
}
}curl -X POST "https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/livechat" \
-H "Authorization: Bearer cnx_TU_LLAVE" \
-H "Content-Type: application/json" \
-d '{"nombre":"Chat de mi sitio","dominios":["tusitio.com","www.tusitio.com"],"color":"#10B981","boton":{"modo":"ambos","icono":"soporte","texto":"Soporte","pos":"der"}}'const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/livechat", {
method: "POST",
headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"nombre": "Chat de mi sitio",
"dominios": [
"tusitio.com",
"www.tusitio.com"
],
"color": "#10B981",
"boton": {
"modo": "ambos",
"icono": "soporte",
"texto": "Soporte",
"pos": "der"
}
})
});
const datos = await respuesta.json();$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/livechat");
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' => 'Chat de mi sitio',
'dominios' =>
array (
0 => 'tusitio.com',
1 => 'www.tusitio.com',
),
'color' => '#10B981',
'boton' =>
array (
'modo' => 'ambos',
'icono' => 'soporte',
'texto' => 'Soporte',
'pos' => 'der',
),
)),
]);
$datos = json_decode(curl_exec($ch), true);PATCH /canales/livechat#
Edita un chat web: solo cambian los campos que envíes (los mismos de la creación).
Permiso: canales:escribir · escritura
Cuerpo (JSON)#
| Campo | Descripción |
|---|---|
canal_id | obligatorio: id del chat web |
… | los campos a cambiar |
{
"canal_id": 7,
"dominios": [
"tusitio.com",
"tienda.tusitio.com"
]
}curl -X PATCH "https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/livechat" \
-H "Authorization: Bearer cnx_TU_LLAVE" \
-H "Content-Type: application/json" \
-d '{"canal_id":7,"dominios":["tusitio.com","tienda.tusitio.com"]}'const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/livechat", {
method: "PATCH",
headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"canal_id": 7,
"dominios": [
"tusitio.com",
"tienda.tusitio.com"
]
})
});
const datos = await respuesta.json();$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/livechat");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY"), "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(array (
'canal_id' => 7,
'dominios' =>
array (
0 => 'tusitio.com',
1 => 'tienda.tusitio.com',
),
)),
]);
$datos = json_decode(curl_exec($ch), true);POST /canales/conexion#
Genera el enlace de un solo uso (15 minutos) de la ventana oficial de Meta para conectar una línea de WhatsApp a esta cuenta. Ábrelo en una ventana emergente para la persona dueña del número. Al terminar el canal aparece en GET /canales y llega el webhook «canal.conectado».
Permiso: canales:escribir · escritura
Cuerpo (JSON)#
| Campo | Descripción |
|---|---|
canal | whatsapp (por ahora) |
{
"canal": "whatsapp"
}curl -X POST "https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/conexion" \
-H "Authorization: Bearer cnx_TU_LLAVE" \
-H "Content-Type: application/json" \
-d '{"canal":"whatsapp"}'const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/conexion", {
method: "POST",
headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"canal": "whatsapp"
})
});
const datos = await respuesta.json();$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/conexion");
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 (
'canal' => 'whatsapp',
)),
]);
$datos = json_decode(curl_exec($ch), true);POST /canales/telegram#
Conecta un bot de Telegram: valida el token, registra el webhook y crea el canal.
Permiso: canales:escribir · escritura
Cuerpo (JSON)#
| Campo | Descripción |
|---|---|
bot_token | obligatorio: el token de @BotFather |
nombre | opcional |
{
"bot_token": "123456789:ABC…",
"nombre": "Soporte Telegram"
}curl -X POST "https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/telegram" \
-H "Authorization: Bearer cnx_TU_LLAVE" \
-H "Content-Type: application/json" \
-d '{"bot_token":"123456789:ABC…","nombre":"Soporte Telegram"}'const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/telegram", {
method: "POST",
headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"bot_token": "123456789:ABC…",
"nombre": "Soporte Telegram"
})
});
const datos = await respuesta.json();$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/telegram");
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 (
'bot_token' => '123456789:ABC…',
'nombre' => 'Soporte Telegram',
)),
]);
$datos = json_decode(curl_exec($ch), true);POST /canales/estado#
Enciende o apaga un canal (apagado deja de recibir y enviar; las conversaciones se conservan).
Permiso: canales:escribir · escritura
Cuerpo (JSON)#
| Campo | Descripción |
|---|---|
canal_id | obligatorio |
activo | true o false |
{
"canal_id": 3,
"activo": false
}curl -X POST "https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/estado" \
-H "Authorization: Bearer cnx_TU_LLAVE" \
-H "Content-Type: application/json" \
-d '{"canal_id":3,"activo":false}'const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/estado", {
method: "POST",
headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"canal_id": 3,
"activo": false
})
});
const datos = await respuesta.json();$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/canales/estado");
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 (
'canal_id' => 3,
'activo' => false,
)),
]);
$datos = json_decode(curl_exec($ch), true);Respuesta#
listar: {"datos": [{"id", "nombre", "tipo", "activo", "datos", "codigo"?, "dominios"?}], "total"}. crear chat web: {"datos": {"id", "codigo", "dominios"}}. conexion: {"datos": {"url", "vence_en_segundos"}}.