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

Canales (ver, crear chat web y conectar)

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.

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

Permisos#

PermisoPara qué sirveTipo
canales:leerVer los canaleslectura
canales:escribirCrear chats web, conectar canales y encenderlos o apagarlosescritura

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ámetroDescripción
tipofiltrar por tipo de canal
Ejemplo en curl
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/canales?tipo=valor" \
  -H "Authorization: Bearer cnx_TU_LLAVE"
Ejemplo en javascript
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();
Ejemplo en php
$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)#

CampoDescripción
nombreobligatorio
dominiosobligatorio: lista de sitios donde se mostrará (["tusitio.com"])
color#RRGGBB del botón y el encabezado
websitedirección del sitio
ancho260 a 600 (380)
alto360 a 800 (560)
boton{"modo": "icono" | "texto" | "ambos", "icono": "chat" | "soporte" | "ayuda" | "correo" | "telefono" | "estrella", "texto": "Soporte", "pos": "der" | "izq"}
form_activotrue para pedir datos antes de chatear
campos{"nombre": {"mostrar": true, "obligatorio": true}, "email": {...}, "telefono": {...}}
prechat_fieldscampos extra: [{"label": "Empresa", "type": "text", "required": false}]
asunto_modono | libre | lista | lista_otro
asuntoslista de asuntos (con modo lista)
Ejemplo de cuerpo
{
  "nombre": "Chat de mi sitio",
  "dominios": [
    "tusitio.com",
    "www.tusitio.com"
  ],
  "color": "#10B981",
  "boton": {
    "modo": "ambos",
    "icono": "soporte",
    "texto": "Soporte",
    "pos": "der"
  }
}
Ejemplo en curl
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"}}'
Ejemplo en javascript
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();
Ejemplo en php
$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)#

CampoDescripción
canal_idobligatorio: id del chat web
…los campos a cambiar
Ejemplo de cuerpo
{
  "canal_id": 7,
  "dominios": [
    "tusitio.com",
    "tienda.tusitio.com"
  ]
}
Ejemplo en curl
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"]}'
Ejemplo en javascript
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();
Ejemplo en php
$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)#

CampoDescripción
canalwhatsapp (por ahora)
Ejemplo de cuerpo
{
  "canal": "whatsapp"
}
Ejemplo en curl
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"}'
Ejemplo en javascript
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();
Ejemplo en php
$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)#

CampoDescripción
bot_tokenobligatorio: el token de @BotFather
nombreopcional
Ejemplo de cuerpo
{
  "bot_token": "123456789:ABC…",
  "nombre": "Soporte Telegram"
}
Ejemplo en curl
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"}'
Ejemplo en javascript
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();
Ejemplo en php
$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)#

CampoDescripción
canal_idobligatorio
activotrue o false
Ejemplo de cuerpo
{
  "canal_id": 3,
  "activo": false
}
Ejemplo en curl
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}'
Ejemplo en javascript
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();
Ejemplo en php
$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"}}.

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