Ajuda e guiasAlertas Telegram › Como obter Chat ID

Como obter Chat ID

3 min de leitura · Alertas Telegram

Para que serve: O token do bot não basta - o bot precisa saber para qual chat enviar as mensagens. Cada chat do Telegram tem um número único - o Chat ID. Neste guia mostramos como obtê-lo em 2 minutos.

Pré-requisito: Você tem um bot criado através do BotFather (se não, crie-o primeiro) e conhece o seu token.

Passo 1: Inicie o chat com o seu bot

  1. Abra o Telegram
  2. Na busca digite o username do seu bot (por exemplo meus_alertas_monitoramento_bot)
  3. Clique nele e o chat abre
  4. Clique no botão Start (azul grande, se for a primeira vez) ou digite /start

O bot por enquanto não te responde - está tudo certo. Basta que o chat exista.

Passo 2: Obtenha o Chat ID através do @userinfobot

A forma mais simples é usar um bot auxiliar que te dá o seu próprio Chat ID.

  1. Na busca do Telegram digite @userinfobot
  2. Abra o chat com ele e clique em Start
  3. Ele envia imediatamente uma mensagem com os seus dados, incluindo o Id

Exemplo de resposta do userinfobot:

Your info:
Id: 123456789
First: João
Last: Silva
Username: @joao_silva
Lang: pt
Resposta do @userinfobot com Chat ID
O @userinfobot envia o seu Chat ID logo após /start

O número em Id é o seu Chat ID. Copie-o.

Alternativa: via endpoint da API

Se você não quer usar um bot auxiliar, pode descobrir o Chat ID via Telegram API. No navegador abra a URL (substitua o token):

https://api.telegram.org/bot<SEU_TOKEN>/getUpdates

Você recebe uma resposta JSON. Nela procure por:

{
  "result": [
    {
      "message": {
        "chat": {
          "id": 123456789,
          ...

Este número é o seu Chat ID.

Dica: Se getUpdates retornar uma lista vazia "result": [], significa que o seu bot ainda não recebeu nenhuma mensagem. Envie a ele pelo Telegram /start ou qualquer outra mensagem e tente novamente.

Chat ID para chat de grupo (opcional)

Se você quer que o bot envie mensagens para um chat de grupo (por exemplo todo o time vê os alertas), faça assim:

  1. Crie um chat de grupo no Telegram (ou use um existente)
  2. Adicione o seu bot como membro do grupo (Add member -> buscar pelo username do bot)
  3. No grupo digite o comando /start@seu_bot_username
  4. Use o endpoint getUpdates mencionado acima - na resposta você encontra o chat ID do grupo (é negativo, por exemplo -987654321)

O Chat ID de grupo começa com menos. O bot vai enviar mensagens para o grupo, onde todos os membros veem.

Pronto. Você tem o token e o Chat ID.

Estes dois valores são tudo o que você precisa:

  • Token do bot - identifica o seu bot
  • Chat ID - para onde o bot deve enviar as mensagens

Agora insira-os nas configurações do ePulz.io.

Próximo passo:

Conectar o token e o Chat ID à conta ePulz.io para que os alertas funcionem.

Conexão com ePulz.io