Como obter o Chat ID do Telegram

Quando você cria um agendamento no SquadOS e escolhe Telegram como canal de destino, o sistema pede um Chat ID. Esse número identifica exatamente para onde a resposta do agente vai ser enviada: seu chat pessoal com o bot, um grupo, ou um canal.

Este guia mostra como descobrir esse ID em poucos minutos.

O que é o Chat ID

Todo chat no Telegram tem um identificador numérico único:

• Chat pessoal (você conversando com o bot): número positivo, ex: 123456789
• Grupo: número negativo, ex: -987654321
• Supergrupo ou canal: número negativo longo, ex: -1001234567890

O SquadOS aceita qualquer um dos três — basta colar o número exato.

Pré-requisito

Antes de tudo, o bot que o SquadOS usa precisa ter acesso ao chat de destino:

• Chat pessoal: você precisa ter iniciado uma conversa com o bot (mandar /start pelo menos uma vez).
• Grupo: adicione o bot ao grupo.
• Canal: adicione o bot como administrador do canal.

Sem isso, mesmo com o Chat ID correto, o Telegram bloqueia o envio.

Método 1 — Chat pessoal (mais comum)

A forma mais rápida é usar um bot público de diagnóstico.

1. No Telegram, abra uma conversa com @userinfobot.

2. Envie qualquer mensagem (pode ser /start).

3. O bot responde com seus dados, incluindo uma linha como:

   Id: 123456789

4. Esse número é o seu Chat ID. Copie e cole no campo Chat ID do Telegram do agendamento.

Método 2 — Grupo

1. Adicione o bot @userinfobot ao grupo (temporariamente).
2. Envie qualquer mensagem no grupo.
3. O bot responde com os dados do grupo, incluindo o Id (número negativo).
4. Copie esse número e cole no agendamento.
5. Depois pode remover o @userinfobot do grupo — mantenha só o bot do SquadOS.

Cuidado

IDs de grupo são negativos. Cole exatamente como aparece, com o sinal - na frente.

Método 3 — Canal

Canais não aceitam mensagens de usuários comuns, então o método é um pouco diferente:

1. Encaminhe qualquer mensagem do canal para @userinfobot em conversa privada.
2. O bot mostra os dados do canal original, incluindo o Id (começa com -100).
3. Copie o número completo (com -100 inclusive) e cole no agendamento.
4. Confirme que o bot do SquadOS é administrador do canal.

Método 4 — Telegram Web (alternativa rápida)

Se preferir não usar bot externo:

1. Acesse web.telegram.org e abra o chat alvo.
2. Olhe a URL na barra do navegador. Exemplos:
   • #123456789 → chat pessoal, ID 123456789
   • #-987654321 → grupo, ID -987654321
   • Para supergrupos/canais, prefira o Método 3 (a URL do Web nem sempre mostra o -100 completo).

Usando no agendamento

Com o Chat ID em mãos:

1. No SquadOS, abra o agente que quer agendar.
2. Vá em Gatilhos → Agendamentos → Adicionar Agendamento.
3. Em Canal de destino, escolha Telegram.
4. Cole o Chat ID no campo indicado.
5. Salve.

Pronto. Quando o agendamento disparar, a resposta do agente vai direto para aquele chat.

Problemas comuns

• “chat not found”: o bot ainda não tem acesso ao chat. Mande /start (pessoal) ou adicione o bot ao grupo/canal.
• “bot was blocked by the user”: você bloqueou o bot. Desbloqueie e mande /start de novo.
• Não chega nada, mas também não dá erro: confirme que colou o ID completo, incluindo o - e o -100 se for supergrupo/canal.