Skip to main content
No Telegram, o Notifique oferece duas formas de “uma conexão” por instância. Elas não são intercambiáveis: são produtos diferentes do ponto de vista do Telegram e das regras de uso.

​
Modo BOT (BOT)

O que é: um bot oficial criado no @BotFather, identificado por token (123456:ABC...). Como funciona no Notifique:
  • Você envia o token na criação da instância.
  • O Notifique configura o webhook do Telegram para receber atualizações (mensagens, etc.).
  • Mensagens recebidas no bot aparecem como inbound e disparam eventos como telegram.received quando aplicável.
  • O usuário final normalmente precisa iniciar conversa com o bot (/start) ou estar em um contexto onde o bot pode falar.
Bom para:
  • Atendimento, notificações transacionais, automações explícitas como “fale com o bot”.
  • Fluxos alinhados à API de Bots do Telegram (documentação oficial, previsível).
Limitações típicas:
  • Não é “sua conta pessoal”: é uma identidade de bot (nome de usuário @...bot).
  • Tipos de mensagem e recursos seguem o que o Bot API permite no Notifique (texto, mídia por URL, etc.).

​
Modo USER (USER)

O que é: uma sessão de usuário humana (conta normal do Telegram), conectada via MTProto (GramJS), equivalente a “estar logado” como no cliente oficial. Como funciona no Notifique:
  • Você aceita termos específicos (acceptUserTerms) na criação.
  • Conecta com QR (GET .../qr em polling) ou colando uma session string (POST .../session).
  • Não usa o mesmo modelo de webhook do Bot API para enviar; o envio passa pela sessão USER.
  • Leitura (ex.: marcação READ em alguns fluxos) pode ser sincronizada de forma diferente do bot — depende do recurso.
Bom para:
  • Casos em que você precisa agir como usuário (fluxos legados, grupos como pessoa, etc.) — somente se o uso for lícito e alinhado aos termos do Telegram e do Notifique.
Riscos e cuidados (leia de verdade):
  • Automatizar conta de usuário pode violar Termos de Serviço do Telegram se usado de forma abusiva (spam, scraping, etc.).
  • 2FA: o fluxo de QR documentado não cobre senha interativa; nesses casos use sessão manual ou outro fluxo aprovado.
  • Exige TELEGRAM_API_ID e TELEGRAM_API_HASH no servidor (credenciais de app em my.telegram.org) — são do ambiente, não do seu workspace.

​
Comparativo rápido

BOTUSER
CredencialToken do BotFatherSessão MTProto (QR ou string)
Identidade@meubotSua conta (número / perfil)
Entrada (inbound)Webhook do botConforme configuração do produto (bot webhook não aplica da mesma forma)
Primeiro envioDepois de ACTIVE na criaçãoSó depois de QR/sessão — status PENDING → ACTIVE
Webhooks de “pareamento”Não aplicável da mesma formatelegram.instance.* durante o login

​
O que o Notifique não mistura

  • Uma instância é ou BOT ou USER; não dá para “trocar o modo” da mesma linha sem recriar.
  • Eventos message.* no painel de webhooks são do WhatsApp. No Telegram, use telegram.* e telegram.instance.* conforme a lista de eventos.

​
Próximos passos