Collega Discord a Elido

Elido pubblica su Discord tramite un webhook in entrata: nessun account bot e nessun permesso sul server oltre alla creazione del webhook. Sei tu a decidere quale canale riceve i messaggi.

Prima di iniziare

Nel server Discord ti serve il permesso Manage Webhooks. Un amministratore del server lo ha per impostazione predefinita. Se non sei amministratore, chiedi a uno di loro di creare il webhook e di copiare l'URL per te.

Creare il webhook di Discord

1. In Discord, fai clic con il tasto destro sul canale in cui vuoi ricevere gli avvisi e scegli Edit Channel.
2. Vai su Integrations → Webhooks → New Webhook.
3. Dagli un nome ("Elido") e, se vuoi, un avatar.
4. Fai clic su Copy Webhook URL. Ha un aspetto simile a https://discord.com/api/webhooks/1234.../AbcD....

Aggiungere il webhook in Elido

1. Apri Settings → Notifications → Add channel → Discord.
2. Incolla l'URL del webhook.
3. Fai clic su Save. Elido pubblica subito un messaggio di prova: dovresti vederlo in Discord entro 2–3 secondi.

Scegliere quali eventi inoltrare

Dopo il salvataggio, fai clic su Configure events. Per ogni canale puoi abilitare o disabilitare ciascuno dei seguenti eventi:

• link.created - viene creato un link nel workspace.
• link.expired - un link ha raggiunto la data di scadenza.
• link.cap_reached - un link ha raggiunto il limite di clic.
• link.broken - il monitor dei link non funzionanti ha trovato una destinazione che non risponde più.
• domain.verified e domain.ssl_failed - verifica del dominio personalizzato e problemi del certificato.
• usage.threshold_80 e usage.threshold_100 - il workspace ha usato l'80% o il 100% della quota del piano.

L'elenco completo dei tipi di evento è nella guida ai webhook.

Ogni messaggio Discord arriva come embed con il tipo di evento, un titolo, i campi dell'evento e un colore in base alla gravità (verde per creato, blu per aggiornato, rosso per gli errori).

Il payload dell'embed ha questo aspetto:

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

Rimuovere l'integrazione

Elimina il webhook in Discord (Channel Settings → Integrations → Webhooks → Delete) oppure rimuovi il canale in Elido (Settings → Notifications → Discord → Remove). In entrambi i casi la consegna si interrompe.

Risoluzione dei problemi

Il messaggio di prova non è arrivato - Incolla l'URL del webhook nella barra degli indirizzi del browser. Discord restituisce {"message": "401: Unauthorized"} per gli URL non validi e la parola "OK" per quelli validi. Se l'URL è valido ma nessun messaggio è arrivato, controlla le impostazioni di notifica del canale: Discord può sopprimere i messaggi dei bot a livello di server o di canale.

I messaggi si sono interrotti dopo qualche giorno - Discord invalida in silenzio i webhook che restituiscono ripetutamente errori 4xx (ad esempio perché il canale è stato eliminato). Crea un nuovo webhook e aggiungilo di nuovo in Elido.

Errore "Unknown Webhook" nel log di consegna di Elido - Il webhook è stato eliminato in Discord. Creane uno nuovo.

Ricevi troppi messaggi - Apri Configure events e disattiva gli eventi che non ti servono. Discord limita inoltre i webhook a circa 30 messaggi al minuto per canale, quindi usa un canale dedicato agli avvisi.