Conectar Telegram ao Elido

O Elido envia notificações do Telegram por meio de um bot que você cria. O bot envia mensagens para um chat específico — seja um DM privado com você mesmo ou um grupo. Você possui o token do bot; o Elido o armazena apenas de forma criptografada.

Etapa 1 — Criar um bot com BotFather#

1. Abra o Telegram e pesquise @BotFather, ou acesse https://t.me/BotFather.
2. Envie /newbot.
3. Siga as instruções: escolha um nome de exibição e depois um username (deve terminar em bot, ex: AcmeElidoBot).
4. O BotFather responde com seu token de API. Parece com 123456789:AABBccDD.... Copie agora — você pode recuperá-lo mais tarde em /mybots, mas é mais rápido copiar agora.

Etapa 2 — Encontrar seu chat ID#

Você precisa do ID numérico do chat para onde deseja que as mensagens sejam enviadas.

Para DMs (apenas você):

1. Envie qualquer mensagem para o seu novo bot.

2. Abra esta URL em um navegador, substituindo TOKEN pelo seu token:

   https://api.telegram.org/botTOKEN/getUpdates
   

3. Encontre "chat":{"id":...} na resposta. Esse número é seu chat ID. Geralmente é um inteiro positivo de 9 dígitos para chats pessoais.

Para um grupo:

1. Adicione o bot ao grupo.
2. Envie uma mensagem no grupo que @-mencione o bot (ex: @AcmeElidoBot hello).
3. Abra a mesma URL getUpdates acima. IDs de chat de grupos são números negativos (ex: -1001234567890).

Etapa 3 — Configurar o Elido#

1. Vá para Settings → Notifications → Telegram → Add channel.
2. Cole o token do bot e o chat ID.
3. Clique em Save. O Elido envia uma mensagem de teste. Espere-a no Telegram em 2 segundos.

Escolher eventos#

Após conectar, clique em Configure events para selecionar quais eventos acionam uma mensagem:

• threshold.exceeded — ponto de partida recomendado.
• scan.failed — imediatamente útil para qualquer link cujo destino você não controla.
• link.created — útil para workspaces compartilhados onde você quer visibilidade sobre novos links.

Remover a integração#

Vá para Settings → Notifications → Telegram → Remove. Isso exclui o token do bot do banco de dados do Elido. Opcionalmente, revogue o bot no BotFather com /revoke.

Solução de problemas#

"Unauthorized" no log de entrega — O token está incorreto. Verifique colando isto em um navegador:

https://api.telegram.org/botTOKEN/getMe

Se retornar {"ok":false,...}, o token é inválido.

"Chat not found" — O chat ID está incorreto, ou o bot nunca foi adicionado ao grupo. Para grupos, confirme que o bot é membro e envie uma mensagem mencionando-o antes de chamar getUpdates.

Nenhuma mensagem após clicar em Test — Verifique getUpdates para confirmar que o bot recebeu alguma interação. Se a resposta estiver vazia, o Telegram ainda não registrou nenhum contato entre o usuário/grupo e o bot.

Mensagens no grupo estão invisíveis — Alguns grupos do Telegram têm "modo lento" ou somente admins podem publicar. Torne o bot administrador com permissão "Post messages".