Guia de configuração de notificações push do Telegram

Princípios de configuração e estrutura da interface

O envio de mensagens do Telegram é implementado com base na Telegram Bot API. A URL completa de envio é formada pela concatenação de Bot Token (chave de acesso do bot) e Chat ID (identificador único do destinatário).

Modelo padrão de concatenação:

[https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/sendMessage?chat_id=<CHAT_ID>

Etapas de obtenção

Etapa 1: crie um bot e obtenha o Bot Token

1. Abra o Telegram, digite e siga o bot oficial @BotFather na barra de pesquisa.
2. Envie o comando /newbot para @BotFather.
3. Insira as informações a seguir conforme solicitado:
   • Bot Name: o nome de exibição do bot (por exemplo: Assistente de notificações).
   • Bot Username: o nome de usuário exclusivo do bot (deve terminar com bot, por exemplo: my_notice_bot).
4. Após a criação bem-sucedida, @BotFather exibirá as credenciais de acesso à API. Copie a string HTTP API Token (formato como 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).

Etapa 2: obtenha o Chat ID do destinatário

De acordo com o tipo de destinatário da mensagem (pessoa ou grupo), escolha o método correspondente:

Opção A: receber notificações individualmente

• Método 1: por meio do bot oficial de consulta (recomendado)
  1. No Telegram, pesquise e siga @userinfobot.
  2. Envie qualquer mensagem para ele ou clique em /start.
  3. O bot retornará os metadados da conta pessoal; o número puro após Id é o seu Chat ID pessoal (por exemplo: 987654321).
• Método 2: consulta pela interface da API
  1. Envie proativamente uma mensagem para o bot que você acabou de criar (por exemplo: hello) para ativar a conversa.
  2. Abra o navegador e acesse o link a seguir (substitua <TOKEN> pela credencial obtida na Etapa 1):

      [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

  3. Na resposta JSON retornada, extraia o valor de "result" -> "message" -> "chat" -> "id".

Opção B: receber notificações em grupo/canal

1. Adicione o bot recém-criado ao grupo de destino no Telegram.
2. Envie qualquer mensagem no grupo (por exemplo: test) ou conceda permissões de administrador ao bot.
3. Acesse o link a seguir no navegador (substitua <TOKEN> pela credencial obtida na Etapa 1):

    [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

4. Na resposta JSON retornada, encontre o registro que contém o nome do grupo correspondente e extraia o campo "chat" -> "id".

   Observação: o Chat ID de um grupo geralmente é um número negativo que começa com - ou -100 (por exemplo: -100123456780); ao concatenar, é necessário manter integralmente o sinal de menos e o prefixo.

3. Exemplos de concatenação de URL

Após obter <TOKEN> e <CHAT_ID>, substitua-os no modelo padrão:

1. Exemplo de URL para notificação individual

• Token: 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID: 987654321
• Resultado final concatenado:

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321)

2. Exemplo de URL para notificação em grupo

• Token: 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID: -7
• Resultado final concatenado:

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780)