Discord est une plateforme de communication puissante qui vous permet de vous connecter avec vos amis, des communautés et des équipes. Elle offre une gamme de fonctionnalités pour la collaboration en équipe, notamment des canaux textuels, des canaux vocaux et des appels vidéo.
Avec un compte Discord ou un bot, vous pouvez :
- Envoyer des messages : envoyer des messages dans un canal spécifique
- Obtenir des messages : récupérer des messages d'un canal spécifique
- Obtenir des informations sur un serveur : récupérer des informations sur un serveur spécifique
- Obtenir des informations sur un utilisateur : récupérer des informations sur un utilisateur spécifique
Dans Cadense, l'intégration Discord permet à vos agents d'accéder et d'exploiter les serveurs Discord de votre organisation. Les agents peuvent récupérer des informations depuis les canaux Discord, rechercher des utilisateurs spécifiques, obtenir des informations sur les serveurs et envoyer des messages. Cela permet à vos workflows de s'intégrer à vos communautés Discord, d'automatiser les notifications et de créer des expériences interactives.
Important : pour lire le contenu des messages, votre bot Discord doit avoir l'option « Message Content Intent » activée dans le portail développeur Discord. Sans cette permission, vous recevrez toujours les métadonnées des messages, mais le champ de contenu apparaîtra vide.
Les composants Discord dans Cadense utilisent un chargement paresseux efficace, ne récupérant les données que lorsque nécessaire pour minimiser les appels API et éviter les limitations de taux. Le rafraîchissement des jetons se produit automatiquement en arrière-plan pour maintenir votre connexion.
Configuration de votre bot Discord
- Accédez au Portail des développeurs Discord
- Créez une nouvelle application et naviguez vers l'onglet « Bot »
- Créez un bot et copiez votre jeton de bot
- Sous « Intents privilégiés de passerelle », activez l'Intent de contenu des messages pour lire le contenu des messages
- Invitez votre bot sur vos serveurs avec les permissions appropriées
Instructions d'utilisation
Intégration complète de Discord : messages, fils de discussion, canaux, rôles, membres, invitations et webhooks.
Outils
discord_send_message
Envoyer un message à un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord où envoyer le message |
content | chaîne | Non | Le contenu textuel du message |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
files | fichier[] | Non | Fichiers à joindre au message |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du message Discord |
discord_get_messages
Récupérer des messages d'un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord pour récupérer les messages |
limit | nombre | Non | Nombre maximum de messages à récupérer (par défaut : 10, max : 100) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Conteneur pour les données des messages |
discord_get_server
Récupérer des informations sur un serveur Discord (guilde)
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Informations sur le serveur Discord (guilde) |
discord_get_user
Récupérer des informations sur un utilisateur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Jeton du bot Discord pour l'authentification |
userId | chaîne | Oui | L'ID de l'utilisateur Discord |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | string | Message de succès ou d'erreur |
data | object | Informations de l'utilisateur Discord |
discord_edit_message
Modifier un message existant dans un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord contenant le message |
messageId | chaîne | Oui | L'ID du message à modifier |
content | chaîne | Non | Le nouveau contenu textuel du message |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du message Discord mis à jour |
discord_delete_message
Supprimer un message d'un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord contenant le message |
messageId | chaîne | Oui | L'ID du message à supprimer |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_add_reaction
Ajouter une réaction emoji à un message Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord contenant le message |
messageId | chaîne | Oui | L'ID du message auquel réagir |
emoji | chaîne | Oui | L'emoji à utiliser pour la réaction (emoji unicode ou emoji personnalisé au format nom:id) |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_remove_reaction
Supprimer une réaction d'un message Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord contenant le message |
messageId | chaîne | Oui | L'ID du message avec la réaction |
emoji | chaîne | Oui | L'emoji à supprimer (emoji unicode ou emoji personnalisé au format nom:id) |
userId | chaîne | Non | L'ID de l'utilisateur dont la réaction doit être supprimée (omettre pour supprimer la propre réaction du bot) |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_pin_message
Épingler un message dans un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord contenant le message |
messageId | chaîne | Oui | L'ID du message à épingler |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_unpin_message
Désépingler un message dans un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord contenant le message |
messageId | chaîne | Oui | L'ID du message à désépingler |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_create_thread
Créer un fil de discussion dans un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord où créer le fil de discussion |
name | chaîne | Oui | Le nom du fil de discussion (1-100 caractères) |
messageId | chaîne | Non | L'ID du message à partir duquel créer un fil de discussion (si création à partir d'un message existant) |
autoArchiveDuration | nombre | Non | Durée en minutes avant l'auto-archivage du fil de discussion (60, 1440, 4320, 10080) |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du fil de discussion créé |
discord_join_thread
Rejoindre un fil de discussion dans Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
threadId | chaîne | Oui | L'ID du fil de discussion à rejoindre |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_leave_thread
Quitter un fil de discussion Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
threadId | chaîne | Oui | L'ID du fil de discussion à quitter |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_archive_thread
Archiver ou désarchiver un fil de discussion dans Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
threadId | chaîne | Oui | L'ID du fil de discussion à archiver/désarchiver |
archived | booléen | Oui | Indique s'il faut archiver (true) ou désarchiver (false) le fil de discussion |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données mises à jour du fil de discussion |
discord_create_channel
Créer un nouveau canal dans un serveur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
name | chaîne | Oui | Le nom du canal (1-100 caractères) |
type | nombre | Non | Type de canal (0=texte, 2=vocal, 4=catégorie, 5=annonce, 13=scène) |
topic | chaîne | Non | Sujet du canal (0-1024 caractères) |
parentId | chaîne | Non | ID de la catégorie parente pour le canal |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du canal créé |
discord_update_channel
Mettre à jour un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord à mettre à jour |
name | chaîne | Non | Le nouveau nom pour le canal |
topic | chaîne | Non | Le nouveau sujet pour le canal |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du canal mis à jour |
discord_delete_channel
Supprimer un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord à supprimer |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_get_channel
Obtenir des informations sur un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord à récupérer |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du canal |
discord_create_role
Créer un nouveau rôle dans un serveur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
name | chaîne | Oui | Le nom du rôle |
color | nombre | Non | Valeur de couleur RGB en entier (par exemple, 0xFF0000 pour rouge) |
hoist | booléen | Non | Indique si les membres du rôle doivent être affichés séparément des membres en ligne |
mentionable | booléen | Non | Indique si le rôle peut être mentionné |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du rôle créé |
discord_update_role
Mettre à jour un rôle dans un serveur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
roleId | chaîne | Oui | L'ID du rôle à mettre à jour |
name | chaîne | Non | Le nouveau nom pour le rôle |
color | nombre | Non | Valeur de couleur RGB en entier |
hoist | booléen | Non | Indique si les membres du rôle sont affichés séparément |
mentionable | booléen | Non | Indique si le rôle peut être mentionné |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du rôle mis à jour |
discord_delete_role
Supprimer un rôle d'un serveur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
roleId | chaîne | Oui | L'ID du rôle à supprimer |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_assign_role
Attribuer un rôle à un membre dans un serveur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
userId | chaîne | Oui | L'ID de l'utilisateur à qui attribuer le rôle |
roleId | chaîne | Oui | L'ID du rôle à attribuer |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_remove_role
Retirer un rôle d'un membre dans un serveur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
userId | chaîne | Oui | L'ID de l'utilisateur à qui retirer le rôle |
roleId | chaîne | Oui | L'ID du rôle à retirer |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_kick_member
Expulser un membre d'un serveur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
userId | chaîne | Oui | L'ID de l'utilisateur à expulser |
reason | chaîne | Non | Raison de l'expulsion du membre |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_ban_member
Bannir un membre d'un serveur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
userId | chaîne | Oui | L'ID de l'utilisateur à bannir |
reason | chaîne | Non | Raison du bannissement du membre |
deleteMessageDays | nombre | Non | Nombre de jours pour lesquels supprimer les messages (0-7) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_unban_member
Débannir un membre d'un serveur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
userId | chaîne | Oui | L'ID de l'utilisateur à débannir |
reason | chaîne | Non | Raison du débannissement du membre |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_get_member
Obtenir des informations sur un membre d'un serveur Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
userId | chaîne | Oui | L'ID de l'utilisateur à récupérer |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du membre |
discord_update_member
Mettre à jour un membre dans un serveur Discord (par ex., changer le surnom)
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
userId | chaîne | Oui | L'ID de l'utilisateur à mettre à jour |
nick | chaîne | Non | Nouveau surnom pour le membre (null pour supprimer) |
mute | booléen | Non | Indique s'il faut mettre en sourdine le membre dans les canaux vocaux |
deaf | booléen | Non | Indique s'il faut rendre sourd le membre dans les canaux vocaux |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du membre mises à jour |
discord_create_invite
Créer un lien d'invitation pour un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord pour lequel créer une invitation |
maxAge | nombre | Non | Durée de l'invitation en secondes (0 = n'expire jamais, par défaut 86400) |
maxUses | nombre | Non | Nombre maximum d'utilisations (0 = illimité, par défaut 0) |
temporary | booléen | Non | Si l'invitation accorde une adhésion temporaire |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données de l'invitation créée |
discord_get_invite
Obtenir des informations sur une invitation Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
inviteCode | chaîne | Oui | Le code d'invitation à récupérer |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données de l'invitation |
discord_delete_invite
Supprimer une invitation Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
inviteCode | chaîne | Oui | Le code d'invitation à supprimer |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
discord_create_webhook
Créer un webhook dans un canal Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
channelId | chaîne | Oui | L'ID du canal Discord où créer le webhook |
name | chaîne | Oui | Nom du webhook (1-80 caractères) |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du webhook créé |
discord_execute_webhook
Exécuter un webhook Discord pour envoyer un message
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
webhookId | chaîne | Oui | L'ID du webhook |
webhookToken | chaîne | Oui | Le jeton du webhook |
content | chaîne | Oui | Le contenu du message à envoyer |
username | chaîne | Non | Remplacer le nom d'utilisateur par défaut du webhook |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Message envoyé via webhook |
discord_get_webhook
Obtenir des informations sur un webhook Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
webhookId | chaîne | Oui | L'ID du webhook à récupérer |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |
data | objet | Données du webhook |
discord_delete_webhook
Supprimer un webhook Discord
Entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
botToken | chaîne | Oui | Le jeton du bot pour l'authentification |
webhookId | chaîne | Oui | L'ID du webhook à supprimer |
serverId | chaîne | Oui | L'ID du serveur Discord (ID de guilde) |
Sortie
| Paramètre | Type | Description |
|---|---|---|
message | chaîne | Message de succès ou d'erreur |