I webhook integrati di Discord funzionano come un modo semplice per ricevere messaggi automatici e aggiornamenti dei dati inviati a un canale di testo nel tuo server. Pensa a loro come a uno di quei fantasiosi tubi pneumatici in cui amavi inviare denaro in banca e guardare scomparire, ma invece di non vedere mai più i tuoi soldi, in realtà stai inviando messaggi a Discord da un'altra piattaforma.
Creando un endpoint webhook nel tuo server, genererai un URL webhook che potrai inserire in una serie di altri servizi diversi per collegarli.
Sebbene tutti adorino assolutamente i tubi pneumatici (vero al 100%), è importante notare che i webhook richiedono l'uso di un altro sito Web (sebbene gli utenti inclini alla programmazione possano creare da soli il proprio schoomper di tubi). Alcuni servizi e siti Web sono progettati per incorporare facilmente webhook e inviare messaggi verso l'esterno, ma altri no. Ecco un piccolo utile elenco di riferimento:
Può utilizzare i webhook: | Non può utilizzare i webhook: |
GitHub | Twitch / YouTube |
CircleCI | Nelly The Hamster |
DataDog |
COME REALIZZARE UN WEBHOOK
Con questo in mente, se vuoi aggiornare il tuo server Discord con commit GitHub e richieste pull o tenere traccia di analisi da DataDog o qualcosa di simile, ecco come puoi fare!
1. Apri la scheda Webhook delle impostazioni del server:
2. Clicca sul pulsante opaco per creare un nuovo webhook!
Avrai alcune opzioni qui. Puoi:
- Modificare l'avatar: cliccando su l'avatar accanto al nome in alto a sinistra
- Scegliere su quale canale pubblicare il webhook: selezionando il canale di testo desiderato dal menu a discesa.
- Assegnare un nome al tuo webhook: utile per distinguere più webhook per più servizi diversi.
Ora hai il tuo pratico URL Gli schoomp-er per tubi pneumatici che puoi collegare a più siti Web da cui potrai ricevere messaggi.
ESEMPIO RAPIDO: INTEGRAZIONE WEBHOOK GITHUB
Poiché i webhook non possono funzionare da soli e devono essere collegati a un altro sito Web per funzionare come previsto, abbiamo pensato che sarebbe stato meglio includere un'integrazione di esempio per tutti voi appassionati di GitHub e code-pusher. Puoi utilizzare i webhook di Discord per inviare qualsiasi fusione di codice o inviare aggiornamenti in un tuo repository in un canale di testo nel tuo server.
1. Ottieni l'URL del webhook per il server/canale in cui desideri ricevere i messaggi:
Nel mio server, ho creato un canale di testo etichettato #gitupdates. Voglio che i miei aggiornamenti del repository pubblichino messaggi qui, quindi prenderò l'URL del webhook per questo canale:
2. Aggiungi l'URL del webhook nelle impostazioni del repository GitHub
Scegli il repository da cui desideri ricevere gli aggiornamenti nel tuo server Discord. Dopo aver selezionato il repository, vai nelle impostazioni > menu webhook:
Perfetto. Clicca sul pulsante "Aggiungi webhook" e inserisci l'URL generato da Discord nello spazio vuoto "URL payload".
Per fare in modo che il webhook visualizzi correttamente i messaggi, è davvero davvero davvero davvero molto importante aggiungere "/github" alla fine di quest’ultimo.
Oltre all'URL, hai altre opzioni specifiche di GitHub tra cui scegliere. Per il tipo di contenuto, puoi utilizzare application/json. Al formato webhook di Discord piace molto JSON. Nella sezione successiva, puoi scegliere di personalizzare il tipo di eventi che attivano i messaggi webhook.
Clicca sull'ultimo pulsante "Aggiungi webhook" sotto l'opzione di personalizzazione delle notifiche degli eventi e il gioco è fatto! Il push di eventuali aggiornamenti nel repository (inclusa la modifica del file readme) verrà visualizzato nel tuo canale di testo:
E tutto è pronto! GitHub è solo un esempio di integrazione che può pubblicare messaggi tramite webhook. Se hai un talento per la creazione di applicazioni JSON o per le richieste HTTP POST e desideri personalizzare i tuoi webhook, puoi trovare ulteriori informazioni nella nostra documentazione per sviluppatori.