Conectar o Discord ao Elido

O Elido publica no Discord por meio de um webhook de entrada: sem conta de bot e sem permissões no servidor além de criar o webhook. Você controla exatamente qual canal recebe as mensagens.

Antes de começar

Você precisa da permissão Manage Webhooks no servidor do Discord. Um administrador do servidor já tem essa permissão por padrão. Se você não for administrador, peça a um que crie o webhook e copie a URL para você.

Criar o webhook do Discord

1. No Discord, clique com o botão direito no canal em que você quer os alertas e clique em Edit Channel.
2. Vá para Integrations → Webhooks → New Webhook.
3. Dê um nome ("Elido") e, se quiser, um avatar.
4. Clique em Copy Webhook URL. Ela tem este formato: https://discord.com/api/webhooks/1234.../AbcD....

Adicionar o webhook no Elido

1. Abra Settings → Notifications → Add channel → Discord.
2. Cole a URL do webhook.
3. Clique em Save. O Elido publica uma mensagem de teste imediatamente: você deve vê-la no Discord em 2 a 3 segundos.

Escolher quais eventos encaminhar

Depois de salvar, clique em Configure events. Você pode ativar ou desativar cada um dos itens a seguir por canal:

• link.created: um link é criado no workspace.
• link.expired: um link chegou à data de expiração.
• link.cap_reached: um link atingiu o limite de cliques.
• link.broken: o monitor de links quebrados encontrou um destino que não funciona mais.
• domain.verified e domain.ssl_failed: verificação do domínio personalizado e problemas de certificado.
• usage.threshold_80 e usage.threshold_100: o workspace usou 80% ou 100% da cota do plano.

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

Cada mensagem do Discord chega como um embed com o tipo de evento, um título, os campos do evento e uma cor conforme a gravidade (verde para criado, azul para atualizado, vermelho para falhas).

O payload do embed tem este formato:

{
  "username": "Elido",
  "embeds": [
    {
      "title": "Link expired",
      "description": "elido.me/spring-2026",
      "color": 15680580
    }
  ]
}

Remover a integração

Exclua o webhook no Discord (Channel Settings → Integrations → Webhooks → Delete) ou remova o canal no Elido (Settings → Notifications → Discord → Remove). Qualquer uma das ações interrompe a entrega.

Solução de problemas

A mensagem de teste não chegou: Cole a URL do webhook na barra de endereços do navegador. O Discord retorna {"message": "401: Unauthorized"} para URLs inválidas e a palavra "OK" para as válidas. Se a URL for válida mas nenhuma mensagem chegou, verifique as configurações de notificação do canal: o Discord pode suprimir mensagens de bots no nível do servidor ou do canal.

As mensagens pararam depois de alguns dias: O Discord invalida webhooks silenciosamente se eles retornarem 4xx repetidamente (por exemplo, porque o canal foi excluído). Crie um novo webhook e adicione-o de novo no Elido.

Erro "Unknown Webhook" no log de entregas do Elido: O webhook foi excluído no Discord. Crie um novo.

Você está recebendo mensagens demais: Abra Configure events e desative os eventos de que você não precisa. O Discord também limita os webhooks a cerca de 30 mensagens por minuto por canal, então use um canal dedicado a alertas.