Comprendre le JSON du component embed
Lire et tester le JSON servi à Discord.
Le component embed est un document JSON envoyé à Discord pour afficher un message riche. Botillon le génère depuis vos réglages, le compacte et le limite à 3000 octets. Vous pouvez le copier pour l’utiliser dans un webhook ou un bot.
Structure générale
Un component embed contient :
- content : texte brut éventuel ;
- embeds : titre, description, couleur, image, vignette, champs ;
- components : boutons et actions ;
- flags : options d’affichage.
La structure exacte dépend du style choisi. Le JSON généré est déjà compatible avec Discord : ne le modifiez que si vous connaissez le format.
Où le trouver
- Ouvrez l’onglet Partage Discord.
- Configurez le message.
- Cliquez sur Copier le JSON ou ouvrez l’aperçu.
- Collez-le dans votre outil.
Limites
- 3000 octets pour le document final.
- Les URLs doivent être publiques.
- Les caractères spéciaux doivent être échappés.
- Discord peut refuser un composant mal formé.
Bonnes pratiques
- Utilisez le JSON généré comme base.
- Validez avec un outil JSON avant l’envoi.
- Ne mettez pas de secrets dans le JSON.
- Testez dans un salon privé.
- Gardez une version compatible si vous modifiez à la main.
Dépannage
- « Invalid Form Body » : structure ou champ invalide.
- « 3000 bytes exceeded » : réduisez le texte ou les images.
- Boutons absents : composants mal placés.
- Image cassée : URL non publique.
Voir aussi
Cet article vous a-t-il aidé ?
Votre avis aide à améliorer la documentation.
Passer à la pratique
Ouvrez la page concernée dans Botillon. La connexion Discord est demandée si nécessaire.
Besoin d’aide ?
Une erreur dans l’article, un réglage introuvable ou un problème de compte : ouvrez un ticket support avec l’URL de cette page.