Création d'un bot
Étape 1. Créez une application (suivez le lien).
Étape 2. Ajoutez un bot (cliquez sur le bouton "Ajouter un bot").
Étape 2.1. Dans la section Installation, sélectionnez Lien d'installation → Aucun.
Étape 2.2. Dans la section Bot, désactivez Bot public, puis activez les Intents suivants :
- Message Content Intent
- Server Members Intent
Vous pouvez également activer Presence Intent pour une utilisation future.
Étape 3. Obtenez le jeton (Réinitialiser le jeton).
Étape 4. Ajoutez le bot au serveur :
- Allez dans OAuth2 → Générateur d'URL.
- Dans Scopes, sélectionnez bot.
- Dans Permissions du bot, choisissez Envoyer des messages, Lire l'historique des messages et toute autre permission requise.
Ensuite, ouvrez le lien généré, sélectionnez le serveur où vous souhaitez ajouter le bot et confirmez l'autorisation.
Pour obtenir le webhook complet depuis Discord, attribuez simplement n'importe quelle valeur à la variable save_webhook.
Si la variable est définie, le webhook sera sauvegardé dans discord_webhook.
Connexion du bot Discord dans MaviBot
Allez maintenant dans la section "Messageries" de votre projet dans MaviBot :
Collez ensuite le jeton copié depuis Discord.
Cliquez sur le bouton Terminé.
Fonctions de la calculatrice
Répondre à un message
discord_reply_to_message(message_id, text) - Cette fonction est utilisée pour répondre à un message.
| Paramètres | Description |
|---|---|
| ! message_id | L'ID du message auquel vous souhaitez répondre. |
| ! text | Le texte du message de réponse. |
Supprimer un message
discord_delete_message(message_id) - Cette fonction est utilisée pour supprimer un message.
| Paramètres | Description |
|---|---|
| ! message_id | L'ID du message à supprimer. |
Modifier un message
discord_edit_message(message_id, text) - Cette fonction est utilisée pour modifier un message.
| Paramètres | Description |
|---|---|
| ! message_id | L'ID du message à modifier. |
| ! text | Le nouveau texte du message. |
Épingler un message
discord_pin_message(message_id) - Cette fonction est utilisée pour épingler un message.
| Paramètres | Description |
|---|---|
| ! message_id | L'ID du message à épingler. |
Désépingler un message
discord_unpin_message(message_id) - Cette fonction est utilisée pour désépingler un message.
| Paramètres | Description |
|---|---|
| ! message_id | L'ID du message à désépingler. |
Envoyer une réaction à un message
discord_send_reaction(message_id, reaction) - Cette fonction est utilisée pour envoyer une réaction à un message.
| Paramètres | Description |
|---|---|
| ! message_id | L'ID du message auquel envoyer une réaction. |
| ! reaction | La réaction à envoyer. Vous pouvez fournir un seul emoji (par exemple ❤️) ou l'ID d'un emoji personnalisé sur le serveur. Des informations sur la façon d'obtenir l'ID d'un emoji personnalisé sont fournies ci-dessous. |
Supprimer une réaction d'un message dans un canal
discord_delete_reaction(message_id, reaction, user_id) - Cette fonction est utilisée pour supprimer une réaction d'un message dans un canal.
| Paramètres | Description |
|---|---|
| ! message_id | L'ID du message duquel supprimer la réaction. |
| ! reaction | La réaction à supprimer. Vous pouvez fournir un seul emoji (par exemple ❤️) ou l'ID d'un emoji personnalisé sur le serveur. Des informations sur la façon d'obtenir l'ID d'un emoji personnalisé sont fournies ci-dessous. |
| user_id | L'ID de l'utilisateur dont vous souhaitez supprimer la réaction. Ce paramètre est facultatif si vous souhaitez supprimer la réaction du bot actuel. |
Callbacks
Lorsqu'un utilisateur envoie une réaction, un callback est reçu dans le chat au format suivant :
new_like ❤️ uid413984787162726410
Où uid413984787162726410 est l'ID de l'utilisateur qui a envoyé la réaction.
Comment obtenir l'ID d'un emoji personnalisé
Si vous envoyez une réaction personnalisée à un message dans un canal Discord, un callback sera reçu au format suivant :
new_like beer:1479419477396291696 uid413984787162726410
Où beer:1479419477396291696 est l'ID de la réaction. Vous pouvez le copier pour l'utiliser dans les fonctions liées aux réactions.
Comment obtenir l'ID du message
Vous pouvez obtenir l'ID du message du client à partir du webhook si save_webhook est activé. Exemple :
data = discord_webhook["data"]
msg_id = data["id"]
result = discord_reply_to_message(msg_id, "Ceci est une réponse à un message")