Discord-webhooks
Meegeleverd met Macro DeckPlaats uitgebreide berichten met embeds en vermeldingen via webhooks in Discord-kanalen, met een live voorbeeld.
Het dialoogvenster Discord-webhook toevoegen met de velden Naam en Webhook-URL
- Sla webhooks op onder een naam, één per kanaal
- Visuele editor met een voorbeeld dat eruitziet als Discord
- Tot 10 embeds met velden, afbeeldingen, auteur en voettekst
- Vermeldingen geven niemand een melding, tenzij je dat toestaat
- Sjabloonvariabelen worden ingevuld wanneer de actie wordt uitgevoerd
Met een Discord-webhook kan alles wat de URL kent berichten in één Discord-kanaal plaatsen. De integratie Discord-webhooks slaat webhooks op onder een naam en geeft je één actie, Discord-webhookbericht versturen, met een visuele editor voor het bericht. Er is geen Discord-app of Discord-account nodig op de computer waarop Macro Deck draait.
Wat je kunt versturen
De editor heeft vier tabbladen:
- Bericht: de berichttekst met Discord-Markdown en regeleinden, plus knoppen die een vermelding van een gebruiker of rol,
@everyoneof@hereinvoegen. - Embeds: tot 10 embeds, elk met een titel en titellink, beschrijving, kleur, tijdstempel, auteur, voettekst, afbeelding, miniatuur en tot 25 velden die naast elkaar kunnen worden getoond.
- Profiel: een gebruikersnaam en avatar voor dit bericht in plaats van die van de webhook zelf.
- Vermeldingen: wie een melding mag krijgen door de vermeldingen in het bericht.
Standaard geeft een bericht niemand een melding, ook niet als het iemand, @everyone of @here vermeldt. De vermelding wordt in Discord wel getoond, alleen pingt ze niet. Alle tekstvelden accepteren sjabloonvariabelen, die worden ingevuld wanneer de actie wordt uitgevoerd, zodat een bericht de huidige scène, het nummer of het aantal kijkers kan bevatten.
Het voorbeeld onder de editor verandert terwijl je typt en toont het bericht zoals Discord het weergeeft. Het stuurt nooit iets naar Discord. Afbeeldingen worden als tijdelijke aanduidingen getoond, en variabelen verschijnen zoals je ze hebt geschreven. Testbericht versturen stuurt het bericht meteen naar Discord nadat je bevestigt met Nu versturen, zodat je kunt controleren hoe het er echt uitziet.
Een paar voorbeelden:
- Een knop Live gaan die een embed met je streamtitel en link in je aankondigingskanaal plaatst.
- Een knop die het nummer dat nu speelt in een muziekkanaal plaatst.
- Een automatisering die een bericht naar een moderatorkanaal stuurt wanneer er iets gebeurt in je stream.
Opgeslagen webhooks en eigen URL's
Voeg per kanaal één configuratie toe en kies de webhook daarna in elke actie op naam. Verandert de URL, dan wijzig je die op één plek. Voor een eenmalig bericht kun je Webhook ook op Eigen URL zetten en de URL in de actie plakken. Macro Deck slaat elke webhook-URL versleuteld op, toont hem nooit meer en schrijft hem nooit naar het logboek.
Macro Deck controleert de limieten van Discord voor het versturen, bijvoorbeeld 2000 tekens berichttekst en 6000 tekens in alle embeds samen, en toont eventuele problemen boven het voorbeeld terwijl je bewerkt. Als Discord beperkt hoe vaak een webhook mag posten, wacht Macro Deck en probeert het nog één keer als de wachttijd 5 seconden of minder is.
Wat je nodig hebt
- Macro Deck 3 op Windows, macOS of Linux
- Een internetverbinding op de computer waarop Macro Deck draait
- Een Discord-kanaal waarin je webhooks mag beheren, en de webhook-URL ervan
Instellen
Stap 1: Maak een webhook in Discord
Open in Discord de instellingen van het kanaal, ga naar Integraties en dan Webhooks, en maak een webhook of kies er een. Klik op Webhook-URL kopiëren. De URL begint met
https://discord.com/api/webhooks/. Iedereen die hem heeft, kan in het kanaal posten, dus behandel hem als een wachtwoord.Stap 2: Open Discord-webhooks in Macro Deck
Klik in Macro Deck in de zijbalk op Integraties en daarna op Discord-webhooks. Klik op het tabblad Overzicht in de sectie Configuratie op Configuratie toevoegen. De schakelaar rechtsboven aanzetten opent hetzelfde dialoogvenster.
Stap 3: Sla de webhook op
Vul het dialoogvenster Discord-webhook toevoegen in:
- Naam: getoond wanneer je de webhook in een actie kiest, bijvoorbeeld de kanaalnaam.
- Webhook-URL: de URL die je in Discord hebt gekopieerd.
Klik op Doorgaan. Voeg voor elk volgend kanaal een configuratie toe.
Stap 4: Zet de actie op een knop
Klik op de pagina Deck op de knop die je wilt gebruiken. Het deck moet ontgrendeld zijn: als de knop rechtsboven Vergrendelen toont, is het ontgrendeld. De editor opent met Kort indrukken geselecteerd. Klik op + Actie toevoegen, selecteer links in het dialoogvenster Actie toevoegen Discord-webhooks en kies Discord-webhookbericht versturen.
Stap 5: Schrijf het bericht
Kies de opgeslagen webhook onder Webhook. Schrijf de Berichttekst op het tabblad Bericht en voeg desgewenst embeds toe op het tabblad Embeds. Controleer het voorbeeld en klik dan op Testbericht versturen en Nu versturen om het bericht in Discord te zien.
Stap 6: Druk op de knop
Druk op de knop op je telefoon, tablet of in de webclient. Het bericht verschijnt in het Discord-kanaal, met eventuele variabelen ingevuld. Gebeurt dat niet, dan toont de actie de reden, bijvoorbeeld dat Discord het webhooktoken heeft geweigerd.
Acties1
Zet deze op een knop of voer ze uit vanuit een actiestroom.
- Discord-webhookbericht versturen
- Verstuurt een bericht met optionele embeds via een opgeslagen of eigen Discord-webhook, bewerkt met een live voorbeeld.
Veelgestelde vragen
Hoe vermeld ik een gebruiker of een rol?
Voor een vermelding is de Discord-ID nodig. Zet in Discord de Ontwikkelaarsmodus aan in de geavanceerde instellingen, klik dan met de rechtermuisknop op de gebruiker of rol en kies ID kopiëren. Kies op het tabblad Vermeldingen of niemand, iedereen die vermeld wordt of alleen de ID's die je opgeeft een melding krijgt.
Wat is het verschil met de integratie Discord?
De integratie Discord heeft een oudere actie Webhook uitvoeren met één embed en zonder voorbeeld. Die blijft werken. Discord-webhooks voegt meerdere embeds, controle over vermeldingen, een profiel per bericht en het live voorbeeld toe.
Waar wordt de webhook-URL opgeslagen?
Macro Deck slaat hem versleuteld op de computer op waarop Macro Deck draait. Hij wordt nooit meer getoond, nooit naar het logboek geschreven en is nooit deel van het voorbeeld. Voer hem opnieuw in om hem te wijzigen. Alleen Discord-webhookadressen op discord.com, discordapp.com, ptb.discord.com en canary.discord.com worden geaccepteerd.
Waarom wordt een variabele in mijn testbericht niet ingevuld?
Testbericht versturen verstuurt variabelen zoals ze geschreven zijn. Ze worden pas ingevuld wanneer de actie vanaf een knop, automatisering of script wordt uitgevoerd.
Waarom mislukt de actie?
De actie toont de reden, bijvoorbeeld dat het bericht leeg of te lang is, dat de webhook niet meer bestaat in Discord, dat Discord het webhooktoken heeft geweigerd of dat Discord de webhook afremt. Is het token geweigerd, kopieer de webhook-URL dan opnieuw en voer hem in de configuratie in.
Kan ik het bericht in de Companion-app bewerken?
De Companion-app en oudere desktop-apps tonen de eenvoudige instellingen van de actie, met het bericht als sleutels en waarden zoals content en embeds.0.title, en slaan geen wijzigingen uit de visuele editor op. Bewerk uitgebreide berichten in de huidige desktop-app.
