Skip to main content

​
Para que serve

O Telegram é onde muita gente recebe avisos rápidos, usa bots de suporte ou participa de grupos e canais. Pelo Notifique você conecta um bot (ou, em casos específicos, uma conta) e passa a enviar mensagens a partir do seu sistema — texto, mídia por link, localização (conforme o modo), com fila, status e webhooks no mesmo estilo dos outros canais da plataforma.

​
Por que isso importa

  • Outro canal além do WhatsApp e SMS — você escolhe onde a pessoa prefere ser avisada.
  • Bots são comuns — fluxo típico: cria o bot no Telegram, cola o token no Notifique e integra envios e leitura pela API.
  • Acompanhamento — dá para listar o que foi enviado, o que chegou no bot e receber eventos na sua URL, sem ficar só “no escuro”.

​
O que você pode fazer no painel

Cadastrar instâncias (bot com token ou fluxo de conta quando aplicável), organizar por workspace, escolher webhooks com eventos que começam sempre com telegram. — assim você não mistura com o prefixo de outros canais.

​
O que você pode fazer por integração (API)

Uma instância = uma conexão. Você informa qual instância, para quem (identificador do chat ou @usuario público, quando existir) e o tipo de conteúdo. Hoje o foco da referência é envio direto e estável: texto; foto, vídeo, áudio ou arquivo por URL HTTPS pública; localização em modo bot, conforme documentado no OpenAPI.

​
Duas formas de conectar

  1. Bot — o caminho mais comum para automação e atendimento: você cria o bot no Telegram e cola o token no Notifique.
  2. Conta (modo USER) — sessão mais parecida com “usuário humano”; exige aceite de termos e fluxo de login (QR na API, SSE no painel ou string de sessão). Use só quando fizer sentido para o seu caso.
Comparativo: Modo BOT e modo USER. Detalhes de rotas: Quick Start do canal.

​
Webhooks

Quando algo importante acontece, o Notifique pode avisar seu sistema com um POST — por exemplo quando a mensagem foi aceita ou quando alguém escreveu no bot. O formato do corpo segue o mesmo estilo dos outros webhooks da casa; o que muda é o nome do evento (telegram.*). Se você usa WhatsApp e Telegram, marque os dois tipos de evento onde configurar webhooks.

​
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

​
Resumo em uma frase (para colar em outro lugar)

Telegram no Notifique liga bot ou conta ao seu workspace para enviar e acompanhar mensagens pela API, com webhooks telegram.* e o mesmo cuidado de instância + chave de API que nos outros canais.