Pular para o conteúdo
SquadOS SquadOS Docs

Como obter o Chat ID do Telegram

Todo envio que o SquadOS faz para o Telegram por conta própria — sem estar respondendo a alguém — precisa de um Chat ID. Esse número identifica exatamente para onde a mensagem vai: 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

Section titled “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

Section titled “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)

Section titled “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 guarde: é o seu Chat ID.

Método 2 — Grupo

Section titled “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 — é o Chat ID do grupo.
  5. Depois pode remover o @userinfobot do grupo — mantenha só o bot do SquadOS.

Método 3 — Canal

Section titled “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 o -100 inclusive.
  4. Confirme que o bot do SquadOS é administrador do canal.

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

Section titled “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 o Chat ID

Section titled “Usando o Chat ID”

Com o Chat ID em mãos, cole-o no campo de destino de quem vai disparar a mensagem. Guarde o número: ele não muda enquanto o chat existir.

Problemas comuns

Section titled “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.