Canal, bot e conexão nas APIs
O que a documentação chama de canal aparece nas APIs como bot ou flow. E o que as APIs chamam de channel é a conexão. Este mapa evita gravar o identificador errado.
A documentação do NicoChat usa canal para o robô — onde vivem fluxos, gatilhos e contatos — e conexão para a conta ligada na plataforma externa. As APIs usam outras palavras para as mesmas duas coisas, e as palavras não coincidem.
Conceito
Na documentação
Nas APIs
O robô, com fluxos e contatos
canal
bot ou flowA conta na plataforma externa
conexão
channelCanal (bot / flow)
Conexão (channel)
Identificador
flow_ns
id
Formato
texto, como
f147815número, como
48213De onde vem
list-flows
list-channels/{type}
Aciona automação?
Sim
Não
list-channels devolve conexão, não canal
Apesar do nome,
list-channels lista as contas conectadas. Quem lê "channels" e grava o id numérico acaba com um identificador que não aciona fluxo nenhum — a gravação funciona e a automação simplesmente nunca dispara.- Se a operação dispara, escuta ou automatiza — gatilho, palavra-chave, webhook, disparo, inscrever contato — o identificador é o
flow_ns, vindo delist-flows. - Se a operação é verificar se a conta externa está ligada — mostrar estado de conexão, montar tela de "conecte um canal" — aí sim é a conexão, de
list-channels/{type}.
As ferramentas do MCP seguem a mesma separação, e o prefixo diz em qual das duas coisas elas operam:
Prefixo
Opera em
channel_*
o canal — recebe
flow_nschannel_connection_*
a conexão
Para a diferença entre os dois conceitos do ponto de vista de quem usa a plataforma, veja Qual a diferença entre canal e conexão?.