Skip to main content

Les intégrations

Tu l'as sans doute remarqué quand tu postes un lien sur Discord, ou alors quand tu envoies un message contenant une image mais l'entité message est composée d'énormément de choses décrites dans la documentation. Retenons de cette liste quelques éléments importants :

  • un identifiant
  • l'identifiant du canal dans lequel le message est posté
  • l'auteur du message
  • le contenu de ce message (chaîne de caractères ne pouvant excéder 2000 caractères)
  • l'horodatage d'envoi du message
  • des intégrations

Une intégration, c'est quoi?​

Du verbe anglais "to embed" qui signifie "intégrer", un embed est une intégration visuelle sur un site web, une application, un IRC, etc. Tu l'utilises dans la vie de tous les jours quand, par exemple, tu partages un lien YouTube ou une page du journal de ton école sur Twitter, Facebook ou autre!

Une intégration (un embed), c'est également une entité générée par Discord et qui permet de mettre en avant des ressources de manière plus interactive. En effet, lorsque tu postes un lien YouTube par exemple, une intégration est automatiquement créé afin de pouvoir jouer la vidéo YouTube depuis l'application Discord (sans ouvrir ton navigateur). Elle est intégrée à Discord. Voici la page de la documentation officielle : https://discord.com/developers/docs/resources/channel#embed-object.

Les limitations​

note

Comme toute entité, une intégration est également soumise à des limites. Ces dernières sont décrites dans la documentation en ligne.

Outre les limitations de contenu, Discord bloque l'utilisation de certains champs.

Protected embed's fields

Ces bloquages permettent ainsi à Discord de s'assurer le monopole sur la création de certaines intégrations spécifiques, par exemple celles comprenant des vidéos:

YouTube embedded in Discord

La structure d'une intégration​

Une intégration soit formée de beaucoup d'éléments. Il est donc important de comprendre sa structure JSON afin de comprendre à quel élément affiché correspond chaque paire clé-valeur.

Embed Structure

Nous conseillons fortement de se rendre sur le Discord Embed Builder et de jouer avec les différents champs afin de comprendre leur fonctionnement.

tip

Tu peux te rendre sur color-hex et choisir une couleur depuis leur site web! Ajoute ensuite 0x devant le code hexadécimal. C'est une notation qui change la chaîne de caractères écrite en un code hexadécimal 😁

Tu peux aussi utiliser la fonction parseInt et la méthode .toString(16) de JavaScript:

const hexadecimalBase = 16;

const decimalNumber = parseInt('a49d33', hexadecimalBase); // 10788147
decimalNumber.toString(hexadecimalBase); // 'a49d33'
decimalNumber === 0xa49d33; // true
decimalNumber === 10788147; // true