Skip to main content
Ce guide vous aide à créer un bot Discord, accorder les autorisations nécessaires à Alter et le connecter dans Préférences → Intégrations → Gateways.
Alter se connecte à Discord en tant que bot avec un bot token. Vous créez le bot dans le Discord Developer Portal ; Alter ne génère pas d’URL d’invitation — ajoutez le bot à votre serveur depuis le portail.

Avant de commencer

  • Compte Discord avec droit de créer des applications (et d’ajouter des bots au serveur cible).
  • Alter installé et ouvert sur votre Mac.
  • Quelques minutes pour copier tokens et IDs — traitez les bot tokens comme des mots de passe.
Références officielles :

Étape 1 — Créer une application Discord

1

Ouvrir le Developer Portal

Allez sur discord.com/developers/applications et connectez-vous.
2

New Application

Cliquez New Application, choisissez un nom (par exemple Alter) et confirmez.
Discord Developer Portal — General Information page after creating an application
Source: discord.js guide — Application Setup
3

Ouvrir la page Bot

Dans la barre latérale, sélectionnez Bot, puis cliquez Add Bot (ou Reset Token si vous en avez déjà un).
Discord Developer Portal — Bot page with Add Bot button
Source: Stack Overflow — permanent OAuth invite for a Discord bot

Étape 2 — Activer Message Content Intent

Alter doit lire le texte des messages dans les serveurs et les DM. Discord exige de l’activer explicitement dans le Developer Portal.
1

Ouvrir les réglages Bot

Dans votre application, allez à Bot.
2

Activer Message Content Intent

Sous Privileged Gateway Intents, activez Message Content Intent.
Discord Developer Portal — Privileged Gateway Intents with Message Content Intent enabled
Source: PyCord docs — Gateway Intents
3

Enregistrer

Confirmez les invites. Sans cet intent, Alter ne peut pas lire les messages et affiche une erreur du type Enable Message Content Intent for this bot.

Étape 3 — Copier le bot token

1

Afficher le token

Sur la page Bot, cliquez Reset Token (première configuration) ou Copy sous Token.
Discord Developer Portal — Jeton du bot section with Reset Token
Source: discord.js guide — Application Setup
2

Le stocker en sécurité

Collez le token temporairement en lieu sûr — vous l’entrerez dans Alter plus tard. S’il fuit, utilisez Reset Token dans le portail et mettez Alter à jour.
Ne commitez ni ne partagez jamais votre bot token. Quiconque le possède peut contrôler votre bot.

Étape 4 — Inviter le bot sur votre serveur

Alter ne construit pas de lien d’invitation dans l’app. Générez-en un dans le Developer Portal :
1

Ouvrir OAuth2 URL Generator

Dans la barre latérale de l’application, allez à OAuth2URL Generator.
2

Sélectionner les scopes

3

Sélectionner les permissions bot

Sous Bot Permissions, activez :
  • View Channels
  • Send Messages
  • Read Message History
  • Attach Files
  • Create Public Threads et Send Messages in Threads (optionnel — seulement si vous activez Démarrer les discussions serveur dans des fils dans Alter)
Cela permet à Alter de lire vos messages, répondre, envoyer des fichiers de sortie d’outils et, optionnellement, créer des fils de discussion dans les canaux serveur.
Discord Developer Portal — OAuth2 URL Generator bot permissions
Source: Stack Overflow — permanent OAuth invite for a Discord bot. Select the permissions listed above — not Administrator.
4

Copier et ouvrir l'URL générée

Copiez l’URL en bas, ouvrez-la dans le navigateur, choisissez votre serveur et autorisez le bot.Discord documente ce flux dans Adding bots to servers.
Discord bot authorization page when opening the generated invite URL
Source: discord.js guide — Adding Your App
Vous avez besoin de Manage Server (ou équivalent) sur le serveur Discord cible pour terminer l’invitation.

Étape 5 — Optionnel : copier Server et user IDs

Utilisez-les si vous voulez restreindre quel serveur ou quels utilisateurs peuvent parler à Alter.
1

Activer Developer Mode dans Discord

Dans le client Discord : User Settings → Advanced → Developer Mode → on.Voir Discord’s ID documentation.
2

Copier Server ID

Clic droit sur l’icône du serveur → Copy Server ID. Collez dans ID du serveur (facultatif) d’Alter pour ignorer les messages d’autres serveurs.
3

Copier user IDs

Clic droit sur un utilisateur → Copy User ID. Utilisez des IDs séparés par des virgules dans ID utilisateur Discord autorisés pour n’autoriser que ces personnes.
Laissez Server ID et ID utilisateur Discord autorisés vides pour autoriser quiconque peut envoyer un message au bot (sous réserve des permissions de canal Discord).

Connect in Alter

1

Ouvrir les réglages Gateways

Ouvrez Préférences (⌘,) → IntégrationsGateways. Voir la vue d’ensemble Gateways pour d’autres façons d’ouvrir Settings.
2

Ajouter un Discord gateway

Cliquez Ajouter un GatewayDiscord. Alter crée une nouvelle entrée dans la liste.
3

Remplir les champs Connection

Un lien Guide de configuration gateway Discord en bas de la section Connection ouvre cette page dans votre navigateur.
4

Choisir Action par défaut et comportement des fils

Ask Anything est la valeur par défaut et fonctionne sur Discord immédiatement. Pour une action personnalisée, définissez Disponibilité sur Discord ou Tous sous Action Editor → Gateways.Sous Behavior, Démarrer les discussions serveur dans des fils est activé par défaut pour les nouveaux gateways Discord — chaque nouveau message de premier niveau dans un serveur obtient son propre fil Discord et chat Alter. Les messages déjà dans un fil continuent ce chat. Les MP sont inchangés. Désactivez si vous préférez les réponses dans le canal principal. Si vous le gardez activé, accordez Create Public Threads et Send Messages in Threads lors de l’invitation du bot (Étape 4).
5

Activer et enregistrer

Activez Activé, puis cliquez Enregistrer et redémarrer. Attendez un statut du type Connecté en tant que bot … ou Connecté en tant que @….
Si la connexion échoue, voir Dépannage Gateways.

Tester le bot

1

Confirmer qu'Alter est ouvert

Les Gateways ne fonctionnent que tant qu’Alter est ouvert sur votre Mac.
2

Envoyer /help

En DM ou canal serveur, envoyez /help (ou le slash command Discord /help). Le bot doit lister les commandes et afficher New chat, Choose action et Past chats.
3

Envoyer un message

Envoyez un message normal (ou @mention le bot dans un serveur si Exiger une mention dans les serveurs est activé). Alter doit réagir avec 👀, afficher Thinking…, puis diffuser la réponse et réagir avec ✅ ou ❌ à la fin.
4

Essayer /new

Lancez /new pour une nouvelle conversation avec la Action par défaut, ou /new ask-anything pour cibler une action précise.
5

Essayer les messages vocaux

Envoyez un voice message Discord ou joignez un fichier audio. Alter le transcrit avec votre processeur vocal sélectionné (Préférences → Voice) et envoie le texte à l’action active.

Pages associées