Webhook Discord: crearne uno e inviare messaggi

Guida ai webhook Discord

Webhook Discord: crearlo, payload JSON, embed | We.Inc

Crea un webhook Discord, componi il payload JSON (content, username, avatar_url, embeds) con i limiti di caratteri in tempo reale e copia codice curl, JavaScript e Python pronto all'uso.

Un webhook Discord è un URL segreto legato a un canale. Invia con POST un corpo JSON con content (fino a 2000 caratteri), embeds (fino a 10) o entrambi, e il messaggio compare in quel canale con il nome del webhook. Non servono bot né login, ed è anche per questo che chiunque abbia l'URL può pubblicare.

I campi di Execute Webhook che userai più spesso

Campo
Tipo
Note

Testo del messaggio, fino a 2000 caratteri

Sostituisce il nome del webhook per questo messaggio

Sostituisce l'avatar del webhook per questo messaggio

Fino a 10 oggetti embed

Limita quali @menzioni inviano davvero una notifica

thread_id (query)
Pubblica in un thread del canale

wait (query)
true restituisce il messaggio creato invece di 204

I webhook sono il modo più rapido per inviare avvisi, invii di moduli o notifiche di deploy in un canale Discord. Il generatore qui sotto scrive il JSON al posto tuo, conta i caratteri rispetto ai limiti di Discord mentre digiti e trasforma il risultato in curl, JavaScript e Python da incollare in uno script o in un server. Non invia nulla da solo, quindi l'URL del tuo webhook non lascia mai la tua macchina.

Nelle impostazioni del tuo server Discord, crea un webhook per il canale in cui vuoi pubblicare.
Scegli il canale, imposta un nome e un avatar, poi copia l'URL del webhook.
Compila il generatore qui sotto e copia il codice generato.
Eseguilo da un terminale o dal tuo server con l'URL in una variabile d'ambiente.

Tratta l'URL come una password. Tienilo in una variabile d'ambiente e fuori dal codice front-end e dai repository pubblici.
Se un URL trapela, elimina quel webhook nelle impostazioni del server e creane uno nuovo; il vecchio URL smette di funzionare.
Imposta allowed_mentions a { "parse": [] } quando il contenuto include input degli utenti, così nessuno può attivare @everyone.
Aggiungi ?wait=true quando ti serve l'id del messaggio, per esempio per modificarlo o eliminarlo in seguito.
Il colore dell'embed è un intero decimale, quindi il colore esadecimale 4F98FB si invia come 5216507.

Domande frequenti

Come ottengo l'URL di un webhook Discord?

Ti serve il permesso Gestisci webhook sul server o sul canale. Nelle impostazioni del tuo server Discord, crea un webhook per il canale e copia il suo URL.

Perché il mio webhook restituisce 400 Bad Request?

Di solito il corpo è vuoto o non valido. Devi inviare almeno uno tra content, embeds, components, un file o un sondaggio, e content deve avere al massimo 2000 caratteri. Invia anche l'header Content-Type: application/json, altrimenti il corpo non viene letto come JSON.

Posso chiamare un webhook Discord dal browser?

Non farlo. Qualsiasi pagina che lo fa espone l'URL a ogni visitatore, che a quel punto può pubblicare qualsiasi cosa nel tuo canale. Invia da un server, da una funzione serverless o da uno script, e fai chiamare quello dalla tua pagina.

Quali sono i limiti degli embed?

Discord indica un titolo fino a 256 caratteri, valori dei campi fino a 1024 caratteri e un totale complessivo di 6000 caratteri tra titolo, descrizione, nomi e valori dei campi, testo del footer e nome dell'autore in tutti gli embed di un messaggio.

Un webhook può leggere messaggi o rispondere agli utenti?

No. Un webhook può solo pubblicare (e modificare o eliminare i propri messaggi). Leggere i canali, reagire ai comandi o rispondere alle persone richiede un'applicazione bot.

Cosa contiene l'URL

L'URL di un webhook termina con due parti: l'id del webhook e il suo token. Il token è l'unica credenziale, ed è per questo che la documentazione di Discord precisa che eseguire un webhook non richiede altra autenticazione. Chiunque abbia l'URL completo ha il tuo stesso potere.

Content, embed o entrambi

Il semplice content è adatto ad avvisi brevi e supporta il markdown di Discord. Gli embed ti danno una barra laterale colorata, un titolo con link, campi disposti in colonne e un footer, più leggibili per dati strutturati come un ordine o un report di errore.
Puoi inviare entrambi in una sola chiamata. Il content compare sopra gli embed, e allowed_mentions decide se i nomi al suo interno notificano davvero le persone.

Inviare grandi volumi

Quando invii troppo velocemente, Discord risponde con uno stato 429 e un valore JSON retry_after in secondi. Rispettalo e metti i messaggi in coda, invece di ritentare in un ciclo stretto. Anche combinare più eventi in un solo messaggio con più embed riduce il numero di chiamate.

Richieste pronte all'uso

curl: un messaggio semplice

L'URL viene letto da una variabile d'ambiente, così non finisce mai nella cronologia della shell o in un commit.

Node.js: un embed con campi

Usa il fetch integrato in Node 18 e successivi. wait=true fa restituire a Discord il messaggio, così puoi registrarne l'id.

Python con requests

json= imposta l'header Content-Type al posto tuo. Uno stato 204 significa che il messaggio è stato pubblicato.

Generatore di payload per webhook Discord

Scrivi il messaggio e l'embed, tieni d'occhio il conteggio dei caratteri e copia il JSON o il codice. Da questa pagina non viene inviato nulla.

Contenuto del messaggio

Nome utente personalizzato

URL avatar personalizzato

Aggiungi un embed

Titolo dell'embed

Descrizione dell'embed

Colore dell'embed

Testo del footer

Blocca tutte le menzioni (allowed_mentions parse: [])

Caratteri dell'embed: {n} / 6000

Oltre il limite: Discord lo rifiuterà.

Vuoto: aggiungi un contenuto o un embed.

Formato di output

Anteprima approssimativa

Webhook

Inizia gratis · Nessuna carta di credito richiesta

Correlati: Guide

Prodotto

Per chi è

Funzionalità

Risorse

Azienda

Mappa del sito