Chat id do Telegram: como pegar o ID de usuário, grupo, canal e tópico com o seu bot

Atualizado em: 29 de outubro de 2026 · 6 min de leitura

Para pegar o chat id no Telegram, mande uma mensagem para o seu bot e chame o método getUpdates: o número em message.chat.id é o chat id. Usuários têm ids positivos, grupos básicos têm ids negativos, e supergrupos e canais começam com -100. Veja como fazer em cada tipo de chat e o que fazer quando a resposta vem vazia.

O que é o chat_id e quais os formatos

O chat_id diz à Bot API para onde enviar a mensagem. Ele aparece em todo update dentro do objeto chat, junto com o type:

Guarde o id como inteiro de 64 bits: ele pode passar de 32 bits (no máximo 52 bits significativos), e um int comum pode corromper o valor.

Chat id do usuário com getUpdates

1. Abra o chat com o seu bot e envie /start ou qualquer texto.
2. Chame getUpdates no navegador, com curl ou no Bot API Tester (getUpdates).
3. Procure message.chat.id na resposta.

curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/getUpdates"

{
  "ok": true,
  "result": [
    {
      "update_id": 100000001,
      "message": {
        "message_id": 1,
        "from": {"id": 123456789, "is_bot": false, "first_name": "Ana"},
        "chat": {"id": 123456789, "first_name": "Ana", "type": "private"},
        "date": 1793280000,
        "text": "/start"
      }
    }
  ]
}

Tem vários chats? Este script em Python lista o id, o tipo e o nome de cada chat que aparece nos updates (mensagens e posts de canal):

import os
import requests

token = os.environ["TELEGRAM_BOT_TOKEN"]
data = requests.get(f"https://api.telegram.org/bot{token}/getUpdates", timeout=10).json()

for update in data.get("result", []):
    msg = update.get("message") or update.get("channel_post") or {}
    chat = msg.get("chat")
    if chat:
        print(chat["id"], chat["type"], chat.get("title") or chat.get("first_name"))

Ainda não tem bot? Comece pelo guia como criar um bot no Telegram.

Chat id de grupo e supergrupo

1. Adicione o bot ao grupo.
2. No grupo, envie /start@seu_bot (troque pelo username do seu bot).
3. Chame getUpdates e copie message.chat.id — um número negativo.

Dica: assim que o bot entra no grupo, o Telegram já gera updates — a mensagem de serviço com new_chat_members e o update my_chat_member —, e ambos trazem o chat.id.

Por que o @seu_bot? Por padrão os bots rodam em modo de privacidade: no grupo, recebem só comandos destinados a eles, respostas às suas mensagens e mensagens de serviço. Texto comum não chega. Para receber tudo, desative o modo com /setprivacy no @BotFather (e adicione o bot de novo ao grupo) ou torne o bot administrador.

Atenção: quando um grupo básico vira supergrupo, o id muda. Enviar para o id antigo gera erro, e a resposta traz o novo id em parameters.migrate_to_chat_id.

Chat id de canal

• Canal público: não precisa descobrir o número — use @nomedocanal como chat_id.
• Canal privado: adicione o bot como administrador com permissão para publicar, faça um post no canal e chame getUpdates. O post chega como channel_post, não como message; o id está em channel_post.chat.id e começa com -100.

Tópicos de fórum: message_thread_id

Em supergrupos com tópicos, o chat_id é o do supergrupo; o tópico é identificado pelo message_thread_id que vem na mensagem. Para escrever num tópico, envie os dois:

{"chat_id": -1001234567890, "message_thread_id": 42, "text": "Olá, tópico!"}

getUpdates vazio ou 409 Conflict: soluções

• {"ok":true,"result":[]}: não há updates novos. Envie outra mensagem ao bot e chame de novo. Updates ficam guardados por no máximo 24 horas.
• Outro programa consumiu os updates: se o código do bot ou uma automação estiver fazendo polling, os updates já foram confirmados. Pare o programa e teste de novo.
• 409 Conflict: Conflict: can't use getUpdates method while webhook is active; use deleteWebhook to delete the webhook first. Chame deleteWebhook — lembrando que isso desliga a integração que usava o webhook. Detalhes no guia webhook do bot do Telegram.
• Grupo sem updates: mensagens comuns não chegam no modo de privacidade. Use /start@seu_bot.

Onde usar o chat id

Com o id em mãos, você envia mensagens com sendMessage. É o que pedem as automações como o n8n, os scripts de notificação (deploy, monitoramento, pedidos de loja) e os assistentes de IA que se conectam ao Telegram — normalmente junto com o token do bot.

curl -X POST "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 123456789, "text": "Deploy concluído"}'

Lembre: o bot só consegue escrever para quem já iniciou uma conversa com ele. Formatação, botões e erros como chat not found estão no guia como enviar mensagens pela API do Telegram.