Chat ID do Telegram no SquadOS

O Chat ID é o identificador numérico que o Telegram atribui ao chat de destino. No fluxo suportado pelo SquadOS, você normalmente não precisa procurar nem colar esse número: ele é capturado quando uma mensagem entra pelo bot conectado.

Como o SquadOS registra o Chat ID

Ao receber uma mensagem comum, o SquadOS usa o Chat ID para localizar ou criar:

uma identidade Telegram vinculada a um contato;
uma conversa desse contato na caixa de entrada do bot.

Em chat privado, a identidade representa a conversa daquela pessoa com o bot. Em grupo, o Chat ID representa o grupo inteiro; todos os participantes entram na mesma identidade e conversa do grupo.

Preparar um contato para receber mensagens

Confirme que o bot está conectado a uma caixa de entrada. Veja Telegram.
No chat privado ou grupo de destino, envie uma mensagem comum para esse bot.
Em Conversas, abra a conversa recebida e confirme a caixa e o contato.

Esse primeiro recebimento registra a identidade do Telegram. Em conversa privada, /start pode ser usado para abrir o chat, mas qualquer mensagem comum entregue ao bot serve para a captura.

Usar a identidade em uma automação

Para enviar uma mensagem do Telegram dentro de uma automação:

Adicione Escolher contato.
Se escolher por identidade, selecione id do Telegram e informe o valor já associado ao contato. Esse passo apenas localiza um contato existente; ele não cria uma identidade nova.
Adicione Obter conversa do contato e selecione a caixa Telegram correta.
Adicione Enviar mensagem.
Teste o fluxo com um contato preparado pelo recebimento anterior.

O envio precisa das três referências existentes: contato com identidade Telegram, conversa na caixa e token válido do bot dessa caixa. Sem uma delas, a automação não tem um destino Telegram válido.

Veja também Ações de automação e Execuções e testes.

O que o editor não faz

O editor de automações não oferece um campo genérico para colar o número de qualquer pessoa, grupo ou canal e criar um envio do zero. Também não transforma um Chat ID digitado em um contato novo.

Se você recebeu um número por uma ferramenta externa, ele só será útil no fluxo documentado quando já existir como identidade de um contato e houver uma conversa associada à caixa correta.

Diagnóstico

Escolher contato não encontra o valor — confirme que esse chat já enviou uma mensagem ao bot e que a identidade está no contato esperado.
Obter conversa não encontra o destino — escolha a caixa Telegram que recebeu a mensagem inicial.
Enviar mensagem informa que falta uma conversa — coloque Obter conversa do contato antes de Enviar mensagem.
O grupo virou um único contato — esse é o comportamento atual: a identidade usa o Chat ID do grupo, não o ID individual de cada participante.
O bot foi bloqueado ou removido do grupo — restaure o acesso no Telegram e faça um teste real antes de reativar a automação.
O bot ou token mudou — valide novamente a conexão e o recebimento; a automação depende do token da caixa selecionada.