Webhook Discord
Inclusa in Macro DeckPubblica messaggi ricchi con embed e menzioni nei canali Discord tramite webhook, con un'anteprima in tempo reale.
La finestra Aggiungi un webhook Discord con i campi Nome e URL del webhook
- Salva i webhook con un nome, uno per canale
- Editor visuale con un'anteprima che sembra Discord
- Fino a 10 embed con campi, immagini, autore e piè di pagina
- Le menzioni non notificano nessuno, a meno che tu non lo consenta
- Le variabili dei modelli vengono compilate quando l'azione viene eseguita
Un webhook Discord permette a chiunque ne conosca l'URL di pubblicare in un canale Discord. L'integrazione Webhook Discord salva i webhook con un nome e ti offre un'azione, Invia messaggio webhook Discord, con un editor visuale per il messaggio. Non servono l'app Discord né un account Discord sul computer su cui gira Macro Deck.
Cosa puoi inviare
L'editor ha quattro schede:
- Messaggio: il testo del messaggio con il Markdown di Discord e gli a capo, più pulsanti che inseriscono una menzione di utente o di ruolo,
@everyoneo@here. - Embed: fino a 10 embed, ognuno con titolo e link del titolo, descrizione, colore, data e ora, autore, piè di pagina, immagine, miniatura e fino a 25 campi che si possono mostrare affiancati.
- Profilo: un nome utente e un avatar per questo messaggio al posto di quelli del webhook.
- Menzioni: chi può essere notificato dalle menzioni nel messaggio.
Per impostazione predefinita un messaggio non notifica nessuno, anche quando menziona qualcuno, @everyone o @here. La menzione viene comunque mostrata in Discord, semplicemente non invia notifiche. Tutti i campi di testo accettano variabili dei modelli, che vengono compilate quando l'azione viene eseguita, così un messaggio può contenere la scena attuale, il brano o il numero di spettatori.
L'anteprima sotto l'editor cambia mentre scrivi e mostra il messaggio come lo disegna Discord. Non invia mai nulla a Discord. Le immagini sono mostrate come segnaposto e le variabili appaiono come le hai scritte. Invia messaggio di prova invia subito il messaggio a Discord dopo che hai confermato con Invia ora, così puoi controllare come appare davvero.
Alcuni esempi di configurazione:
- Un pulsante In diretta che pubblica un embed con il titolo e il link della tua live nel tuo canale degli annunci.
- Un pulsante che pubblica il brano in riproduzione in un canale di musica.
- Un'automazione che invia un messaggio a un canale dei moderatori quando succede qualcosa nella tua live.
Webhook salvati e URL personalizzati
Aggiungi una configurazione per ogni canale, poi scegli il webhook per nome in ogni azione. Quando l'URL cambia, lo cambi in un solo punto. Per un messaggio occasionale puoi anche impostare Webhook su URL personalizzato e incollare l'URL nell'azione. Macro Deck salva ogni URL di webhook cifrato, non lo mostra più e non lo scrive mai nel log.
Macro Deck controlla i limiti di Discord prima di inviare, per esempio 2000 caratteri di testo del messaggio e 6000 caratteri in tutti gli embed insieme, ed elenca eventuali problemi sopra l'anteprima mentre modifichi. Quando Discord limita la frequenza con cui un webhook può pubblicare, Macro Deck aspetta e riprova una volta se l'attesa è di 5 secondi o meno.
Cosa ti serve
- Macro Deck 3 su Windows, macOS o Linux
- Una connessione a internet sul computer su cui gira Macro Deck
- Un canale Discord in cui puoi gestire i webhook, e il suo URL del webhook
Configurala
Passaggio 1: Crea un webhook in Discord
In Discord apri le impostazioni del canale, vai su Integrazioni e poi su Webhook, e crea un webhook o scegline uno. Fai clic su Copia URL del webhook. L'URL inizia con
https://discord.com/api/webhooks/. Chiunque lo abbia può pubblicare nel canale, quindi trattalo come una password.Passaggio 2: Apri Webhook Discord in Macro Deck
In Macro Deck, fai clic su Integrazioni nella barra laterale e poi su Webhook Discord. Nella scheda Panoramica, fai clic su Aggiungi configurazione nella sezione Configurazione. Attivando l'interruttore in alto a destra si apre la stessa finestra.
Passaggio 3: Salva il webhook
Compila la finestra Aggiungi un webhook Discord:
- Nome: mostrato quando scegli il webhook in un'azione, per esempio il nome del canale.
- URL del webhook: l'URL che hai copiato in Discord.
Fai clic su Continua. Aggiungi una configurazione per ogni altro canale.
Passaggio 4: Aggiungi l'azione a un pulsante
Nella pagina Deck, fai clic sul pulsante che vuoi usare. Il deck deve essere sbloccato: quando il pulsante in alto a destra mostra Blocca, è sbloccato. L'editor si apre con Pressione Breve selezionata. Fai clic su + Aggiungi azione, seleziona Webhook Discord a sinistra nella finestra Aggiungi azione e scegli Invia messaggio webhook Discord.
Passaggio 5: Scrivi il messaggio
Scegli il webhook salvato in Webhook. Scrivi il Testo del messaggio nella scheda Messaggio e, se vuoi, aggiungi degli embed nella scheda Embed. Controlla l'anteprima, poi fai clic su Invia messaggio di prova e Invia ora per vedere il messaggio in Discord.
Passaggio 6: Premi il pulsante
Premi il pulsante sul tuo telefono, sul tablet o nel client web. Il messaggio compare nel canale Discord, con le variabili compilate. Se non compare, l'azione mostra il motivo, per esempio che Discord ha rifiutato il token del webhook.
Azioni1
Assegnale a un pulsante o eseguile da un flusso.
- Invia messaggio webhook Discord
- Invia un messaggio con embed facoltativi tramite un webhook Discord salvato o personalizzato, modificato con un'anteprima in tempo reale.
Domande frequenti
Come menziono un utente o un ruolo?
Una menzione richiede l'ID Discord. In Discord attiva la Modalità sviluppatore nelle impostazioni avanzate, poi fai clic con il tasto destro sull'utente o sul ruolo e scegli Copia ID. Nella scheda Menzioni, scegli se notificare nessuno, tutti i menzionati o solo gli ID che indichi.
Qual è la differenza rispetto all'integrazione Discord?
L'integrazione Discord ha un'azione più vecchia, Esegui webhook, con un solo embed e senza anteprima. Continua a funzionare. Webhook Discord aggiunge più embed, il controllo delle menzioni, un profilo per messaggio e l'anteprima in tempo reale.
Dove viene salvato l'URL del webhook?
Macro Deck lo salva cifrato sul computer su cui gira Macro Deck. Non viene più mostrato, non viene mai scritto nel log e non fa mai parte dell'anteprima. Per cambiarlo, inseriscilo di nuovo. Sono accettati solo indirizzi di webhook Discord su discord.com, discordapp.com, ptb.discord.com e canary.discord.com.
Perché una variabile non viene compilata nel mio messaggio di prova?
Invia messaggio di prova invia le variabili così come sono scritte. Vengono compilate solo quando l'azione viene eseguita da un pulsante, un'automazione o uno script.
Perché l'azione non riesce?
L'azione mostra il motivo, per esempio che il messaggio è vuoto o troppo lungo, che il webhook non esiste più in Discord, che Discord ha rifiutato il token del webhook o che Discord sta limitando la frequenza del webhook. Se il token è stato rifiutato, copia di nuovo l'URL del webhook e inseriscilo nella configurazione.
Posso modificare il messaggio nell'app Companion?
L'app Companion e le app desktop più vecchie mostrano le impostazioni semplici dell'azione, con il messaggio come chiavi e valori come content ed embeds.0.title, e non salvano le modifiche fatte nell'editor visuale. Modifica i messaggi ricchi nell'app desktop attuale.
