Webhooks Discord
Incluse avec Macro DeckPubliez des messages enrichis avec des embeds et des mentions dans des salons Discord via des webhooks, avec un aperçu en direct.
La boîte de dialogue Ajouter un webhook Discord avec les champs Nom et URL du webhook
- Enregistrez des webhooks sous un nom, un par salon
- Un éditeur visuel avec un aperçu qui ressemble à Discord
- Jusqu'à 10 embeds avec champs, images, auteur et pied de page
- Les mentions ne notifient personne, sauf si vous l'autorisez
- Les variables de modèle sont remplies quand l'action s'exécute
Un webhook Discord permet à tout ce qui connaît son URL de publier dans un salon Discord. L'intégration Webhooks Discord enregistre des webhooks sous un nom et vous propose une action, Envoyer un message par webhook Discord, avec un éditeur visuel pour le message. Elle n'a besoin ni de l'application Discord ni d'un compte Discord sur l'ordinateur qui exécute Macro Deck.
Ce que vous pouvez envoyer
L'éditeur comporte quatre onglets :
- Message : le texte du message avec le Markdown de Discord et des retours à la ligne, ainsi que des boutons qui insèrent une mention d'utilisateur ou de rôle,
@everyoneou@here. - Embeds : jusqu'à 10 embeds, chacun avec un titre et un lien de titre, une description, une couleur, un horodatage, un auteur, un pied de page, une image, une miniature et jusqu'à 25 champs pouvant s'afficher côte à côte.
- Profil : un nom d'utilisateur et un avatar pour ce message à la place de ceux du webhook.
- Mentions : qui peut être notifié par les mentions du message.
Par défaut, un message ne notifie personne, même quand il mentionne quelqu'un, @everyone ou @here. La mention reste affichée dans Discord, elle n'envoie simplement pas de notification. Tous les champs de texte acceptent des variables de modèle, remplies au moment où l'action s'exécute : un message peut ainsi contenir la scène actuelle, le morceau en cours ou le nombre de spectateurs.
L'aperçu sous l'éditeur change pendant que vous tapez et montre le message tel que Discord l'affiche. Il n'envoie jamais rien à Discord. Les images apparaissent sous forme d'espaces réservés, et les variables telles que vous les avez écrites. Envoyer un message de test envoie immédiatement le message à Discord après confirmation avec Envoyer maintenant, pour que vous puissiez vérifier son vrai rendu.
Quelques exemples de configuration :
- Un bouton En direct qui publie un embed avec le titre et le lien de votre stream dans votre salon d'annonces.
- Un bouton qui publie le morceau en cours de lecture dans un salon de musique.
- Une automatisation qui envoie un message dans un salon de modérateurs quand quelque chose se passe sur votre stream.
Webhooks enregistrés et URL personnalisées
Ajoutez une configuration par salon, puis choisissez le webhook par son nom dans chaque action. Quand l'URL change, vous la modifiez à un seul endroit. Pour un message ponctuel, vous pouvez aussi régler Webhook sur URL personnalisée et coller l'URL dans l'action. Macro Deck stocke chaque URL de webhook chiffrée, ne l'affiche plus jamais et ne l'écrit jamais dans le journal.
Macro Deck vérifie les limites de Discord avant l'envoi, par exemple 2000 caractères de texte de message et 6000 caractères pour tous les embeds réunis, et liste les éventuels problèmes au-dessus de l'aperçu pendant que vous modifiez le message. Quand Discord limite la fréquence de publication d'un webhook, Macro Deck attend et réessaie une fois si l'attente est de 5 secondes ou moins.
Ce qu'il vous faut
- Macro Deck 3 sous Windows, macOS ou Linux
- Une connexion Internet sur l'ordinateur qui exécute Macro Deck
- Un salon Discord dans lequel vous pouvez gérer les webhooks, et l'URL de son webhook
Configuration
Étape 1: Créez un webhook dans Discord
Dans Discord, ouvrez les paramètres du salon, allez dans Intégrations, puis Webhooks, et créez un webhook ou choisissez-en un. Cliquez sur Copier l'URL du webhook. L'URL commence par
https://discord.com/api/webhooks/. Toute personne qui la possède peut publier dans le salon : traitez-la comme un mot de passe.Étape 2: Ouvrez Webhooks Discord dans Macro Deck
Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur Webhooks Discord. Dans l'onglet Aperçu, cliquez sur Ajouter une configuration dans la section Configuration. Activer l'interrupteur en haut à droite ouvre la même boîte de dialogue.
Étape 3: Enregistrez le webhook
Remplissez la boîte de dialogue Ajouter un webhook Discord :
- Nom : affiché quand vous choisissez le webhook dans une action, par exemple le nom du salon.
- URL du webhook : l'URL que vous avez copiée dans Discord.
Cliquez sur Continuer. Ajoutez une configuration pour chaque salon supplémentaire.
Étape 4: Ajoutez l'action à un bouton
Sur la page Deck, cliquez sur le bouton que vous voulez utiliser. Le deck doit être déverrouillé : quand le bouton en haut à droite indique Verrouiller, il est déverrouillé. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, sélectionnez Webhooks Discord à gauche de la boîte de dialogue Ajouter une action et choisissez Envoyer un message par webhook Discord.
Étape 5: Rédigez le message
Choisissez le webhook enregistré sous Webhook. Rédigez le Texte du message dans l'onglet Message, et ajoutez si vous le souhaitez des embeds dans l'onglet Embeds. Vérifiez l'aperçu, puis cliquez sur Envoyer un message de test et Envoyer maintenant pour voir le message dans Discord.
Étape 6: Appuyez sur le bouton
Appuyez sur le bouton sur votre téléphone, votre tablette ou dans le client web. Le message apparaît dans le salon Discord, avec les variables remplies. Sinon, l'action indique la raison, par exemple que Discord a refusé le jeton du webhook.
Actions1
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Envoyer un message par webhook Discord
- Envoie un message avec des embeds facultatifs via un webhook Discord enregistré ou personnalisé, modifié avec un aperçu en direct.
Questions fréquentes
Comment mentionner un utilisateur ou un rôle ?
Une mention a besoin de l'identifiant Discord. Dans Discord, activez le Mode développeur dans les paramètres avancés, puis faites un clic droit sur l'utilisateur ou le rôle et choisissez Copier l'identifiant. Dans l'onglet Mentions, choisissez si personne, toutes les personnes mentionnées ou seulement les identifiants que vous indiquez sont notifiés.
Quelle est la différence avec l'intégration Discord ?
L'intégration Discord propose une action plus ancienne, Exécuter un webhook, avec un seul embed et sans aperçu. Elle continue de fonctionner. Webhooks Discord ajoute plusieurs embeds, le contrôle des mentions, un profil par message et l'aperçu en direct.
Où l'URL du webhook est-elle stockée ?
Macro Deck la stocke chiffrée sur l'ordinateur qui exécute Macro Deck. Elle n'est plus jamais affichée, jamais écrite dans le journal et ne fait jamais partie de l'aperçu. Pour la modifier, saisissez-la de nouveau. Seules les adresses de webhooks Discord sur discord.com, discordapp.com, ptb.discord.com et canary.discord.com sont acceptées.
Pourquoi une variable n'est-elle pas remplie dans mon message de test ?
Envoyer un message de test envoie les variables telles qu'elles sont écrites. Elles ne sont remplies que lorsque l'action s'exécute depuis un bouton, une automatisation ou un script.
Pourquoi l'action échoue-t-elle ?
L'action indique la raison, par exemple que le message est vide ou trop long, que le webhook n'existe plus dans Discord, que Discord a refusé le jeton du webhook ou que Discord limite la fréquence du webhook. Si le jeton a été refusé, copiez de nouveau l'URL du webhook et saisissez-la dans la configuration.
Puis-je modifier le message dans l'application Companion ?
L'application Companion et les anciennes applications de bureau affichent les réglages simples de l'action, avec le message sous forme de clés et de valeurs comme content et embeds.0.title, et n'enregistrent pas les modifications faites dans l'éditeur visuel. Modifiez les messages enrichis dans l'application de bureau actuelle.
Plus dans Chat et voix
Discord
Incluse avec Macro DeckCoupez le micro et le son, rejoignez des canaux vocaux, modifiez vos réglages vocaux et publiez des messages par webhook dans Discord depuis votre deck.
SinusBot
Incluse avec Macro DeckPilotez la musique de vos instances SinusBot et affichez sur votre deck ce qu'elles jouent.