Canal, bot y conexión en las APIs
Lo que la documentación llama canal aparece en las APIs como bot o flow. Y lo que las APIs llaman channel es la conexión. Este mapa evita guardar el identificador equivocado.
La documentación de NicoChat usa canal para el bot — donde viven los flujos, los disparadores y los contactos — y conexión para la cuenta vinculada en la plataforma externa. Las APIs usan otras palabras para esas mismas dos cosas, y las palabras no coinciden.
Concepto
En la documentación
En las APIs
El bot, con flujos y contactos
canal
bot o flowLa cuenta en la plataforma externa
conexión
channelCanal (bot / flow)
Conexión (channel)
Identificador
flow_ns
id
Formato
texto, como
f147815número, como
48213De dónde viene
list-flows
list-channels/{type}
¿Dispara automatización?
Sí
No
list-channels devuelve conexión, no canal
A pesar del nombre,
list-channels lista las cuentas conectadas. Quien lee "channels" y guarda el id numérico termina con un identificador que no dispara ningún flujo — el guardado funciona y la automatización simplemente nunca se activa.- Si la operación dispara, escucha o automatiza — disparador, palabra clave, webhook, envío masivo, suscribir contacto — el identificador es el
flow_ns, que viene delist-flows. - Si la operación es verificar si la cuenta externa está conectada — mostrar el estado de conexión, armar la pantalla de "conecta un canal" — entonces sí es la conexión, de
list-channels/{type}.
Las herramientas del MCP siguen la misma separación, y el prefijo indica sobre cuál de las dos cosas operan:
Prefijo
Opera en
channel_*
el canal — recibe
flow_nschannel_connection_*
la conexión
Para la diferencia entre los dos conceptos desde el punto de vista de quien usa la plataforma, consulta ¿Cuál es la diferencia entre canal y conexión?.