Conectar o 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: uma mensagem direta privada com você ou um grupo. O token do bot é seu; o Elido apenas o armazena criptografado.

Passo 1: crie um bot com o BotFather

1. Abra o Telegram e procure por @BotFather, ou abra https://t.me/BotFather.
2. Envie /newbot.
3. Siga as instruções: escolha um nome de exibição e depois um nome de usuário (precisa terminar em bot, por exemplo AcmeElidoBot).
4. O BotFather responde com o seu token de API. Ele tem este formato: 123456789:AABBccDD.... Copie-o agora: você pode recuperá-lo depois em /mybots, mas é mais rápido copiar logo de início.

Passo 2: encontre o seu ID de chat

Você precisa do ID de chat numérico do lugar para onde quer enviar as mensagens.

Para mensagens diretas (só 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. Procure "chat":{"id":...} na resposta. Esse número é o seu ID de chat. Normalmente é 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 com @ (por exemplo @AcmeElidoBot hello).
3. Abra a mesma URL de getUpdates acima. Os IDs de chat de grupo são números negativos (por exemplo -1001234567890).

Passo 3: configure o Elido

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

Escolher eventos

Depois de conectado, clique em Configure events para selecionar quais eventos disparam uma mensagem:

• link.broken: ponto de partida recomendado; o monitor de links quebrados encontrou um destino que não funciona mais.
• usage.threshold_80 e usage.threshold_100: o workspace usou 80% ou 100% da cota do plano.
• link.expired e link.cap_reached: um link expirou ou atingiu o limite de cliques.
• link.created: útil em workspaces compartilhados em que você quer visibilidade dos novos links.
• domain.verified e domain.ssl_failed: status dos domínios personalizados.

A lista completa de tipos de evento está no guia de webhooks.

Remover a integração

Vá para Settings → Notifications → Telegram → Remove. Isso exclui o token do bot do banco de dados do Elido. Se quiser, revogue também o próprio bot no BotFather com /revoke.

Solução de problemas

"Unauthorized" no log de entregas: O token está errado. Confirme colando isto em um navegador:

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

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

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

Nenhuma mensagem depois de 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 ou grupo e o bot.

As mensagens no grupo não aparecem: Alguns grupos do Telegram têm "modo lento" ou permitem postar apenas aos administradores. Torne o bot administrador com a permissão "Post messages".