Skip to main content

​
Por que este canal importa

Muita gente usa o Telegram para avisos, bots de suporte e comunidades. Ter esse canal na mesma plataforma que WhatsApp e SMS significa chegar onde o usuário já está, com mensagens rápidas e, no caso de bot, conversas que o seu backend pode acompanhar com webhooks.

​
O que você encontra no painel

  • Instâncias Telegram — cadastro do token do bot ou fluxo de conta (quando disponível e aplicável ao seu caso).
  • Organização por workspace — cada conexão fica associada ao seu ambiente, com API Keys controlando quem pode enviar ou ler.
  • Webhooks — URL para receber eventos; no Telegram os nomes sempre começam com telegram. (não confunda com message.* do WhatsApp).

​
O que você encontra na API

  • Uma instância = uma conexão — você escolhe a instância, define para quem (chat id em texto ou @usuario público, quando existir) e o tipo de conteúdo.
  • Tipos suportados hoje — texto; foto, vídeo, áudio ou arquivo por URL HTTPS pública; localização (nesta versão, apenas com bot).
  • Limitação honesta — listas com botões, cartão de contato e formatos extras ainda não entram neste canal; o foco é envio direto e confiável do que já está documentado na referência.

​
Duas formas de conectar

  1. Bot — Você cria o bot no Telegram, cola o token no Notifique. É o caminho mais comum para automação e atendimento.
  2. Conta (modo USER) — Sessão MTProto com aceite de termos; login por QR na API, SSE no dashboard ou session string. Use só quando fizer sentido; o fluxo é mais sensível às regras do Telegram.
Comparativo completo: Modo BOT e modo USER.
Detalhes de rotas e corpos estão no Quick Start e na API Reference do canal.

​
Webhooks

Quando algo importante acontece, o Notifique pode POSTar um JSON na URL que você cadastrou — por exemplo telegram.sent quando a mensagem foi aceita, ou telegram.received quando alguém escreve no bot. O formato do aviso (campos como workspaceId, instanceId, data) segue o mesmo estilo de Eventos dos Webhooks (WhatsApp); o que muda é o nome do evento (telegram.* em vez de message.*). Se você usa WhatsApp e Telegram, habilite os dois tipos de evento no painel.

​
O que não é esta documentação

O Telegram Gateway (SMS com código da Meta) é outro produto. Aqui falamos só de mensagens dentro do app Telegram.

​
Próximos passos