Gateways

​

Ce que font les Gateways

Les Gateways vous permettent d’utiliser Alter depuis les plateformes de chat que vous avez déjà ouvertes :

• Discord — Envoyez un DM au bot ou mentionnez-le dans un canal de serveur (lorsqu’il est configuré).
• Telegram — Envoyez un message au bot dans un chat privé ou un groupe.

Chaque instance de gateway a son propre nom, Action par défaut, contrôles d’accès et paramètres de connexion. Les conversations sont stockées dans Alter sur votre Mac comme les chats Hub — les gateways sont un autre moyen de démarrer et de poursuivre ces conversations. Lorsque quelqu’un envoie un message, Alter :

1. Le reçoit via la connexion bot de la plateforme.
2. Exécute l’Alter Action sélectionnée (par exemple Ask Anything).
3. Diffuse la réponse dans le canal Discord ou le chat Telegram.
4. Peut télécharger les pièces jointes entrantes et envoyer les fichiers de sortie des exécutions d’outils.

​

Ouvrir les paramètres Gateways

Vous pouvez aussi utiliser le lien direct : com.wearedevx.alter://settings?id=gateways La page Gateways affiche tous les gateways configurés. Utilisez Ajouter un Gateway pour créer une connexion Discord ou Telegram.

​

Guides de configuration

​

Référence des paramètres gateway

Tous les gateways partagent ces champs : Les champs Connexion spécifiques à la plateforme sont documentés dans les guides de configuration :

• Champs de connexion Discord
• Champs de connexion Telegram

Après avoir enregistré un gateway activé, Alter affiche une ligne d’état comme Connecté en tant que @username ou une erreur sur laquelle vous pouvez agir.

​

Maintenir les Gateways en ligne avec le couvercle fermé

Sur un MacBook, fermer le couvercle met normalement le Mac en veille et déconnecte les bots gateway. Alter peut maintenir les gateways actifs disponibles lorsque le couvercle est fermé. En haut de Préférences → Intégrations → Gateways :

​

Protections batterie

Alter met en pause la disponibilité couvercle fermé automatiquement pour protéger l’autonomie :

• Mettre en pause en dessous de — Lorsque le Mac est débranché et en décharge, Alter rétablit la veille normale à ou en dessous de ce niveau (par défaut 20%, réglable de 5% à 50% par pas de 5 %). La disponibilité couvercle fermé se réactive après une charge au-dessus de la limite.
• Mettre en pause en mode Économie d’énergie — Toujours respecté tant que le Low Power Mode macOS est activé.

Désactiver l’interrupteur principal conserve l’autorisation administrateur installée, pour pouvoir la réactiver sans nouvelle invite. Utilisez Retirer l’autorisation administrateur… dans Options… pour la révoquer entièrement.

​

Quelles actions fonctionnent sur les Gateways ?

Les actions optent pour les plateformes externes. Dans l’Action Editor, ouvrez la section Gateways et choisissez Disponibilité : Dans Préférences → Integrations → Gateways, chaque gateway affiche une liste Actions disponibles pour sa plateforme. Utilisez-la pour confirmer quelles actions sont activées et ouvrir Action Editor → Gateways pour toute action listée. Les utilisateurs peuvent toujours changer d’action par conversation avec /new [action] ou le sélecteur Choose action, tant que l’action est autorisée sur la plateforme.

​

Actions sans paramètres vs. paramétrées

Quand quelqu’un choisit une action via Choose action (ou /actions) :

• Les actions sans paramètres (aucun champ de saisie dans l’Action Editor) démarrent immédiatement — Alter exécute l’action avec son prompt configuré, comme un lancement en un clic dans le Hub.
• Les actions paramétrées (avec champs de saisie) démarrent une nouvelle conversation et attendent le message suivant pour que l’utilisateur fournisse ces entrées.## Commandes et contrôles de chat

Discord et Telegram prennent en charge les mêmes commandes texte (saisissez-les comme messages normaux). Sur Telegram, les commandes fonctionnent aussi avec un suffixe bot comme /help@YourBotName. Sur Discord, Alter enregistre aussi les slash commands natifs (/help, /new, /actions, /chats, /history, /stop, /status) lorsque le bot se connecte. Si vous définissez un Server ID, les commandes s’enregistrent uniquement pour ce serveur ; sinon, elles s’enregistrent globalement pour l’application bot. Les deux plateformes exposent aussi des boutons pour les tâches courantes — par exemple New chat, Choose action et Past chats sur /help. Telegram utilise des claviers inline ; Discord utilise des composants de message. Lorsqu’une action utilise l’outil Ask User, Alter présente des questions à choix multiples via ces mêmes contrôles interactifs (et accepte les réponses saisies pour les réponses « Other »). Tout message qui n’est pas une commande est traité comme un tour de chat dans la conversation en cours.

​

Utilisation quotidienne

1. Gardez Alter en cours d’exécution sur votre Mac avec le gateway Activé. Sur un MacBook, activez Maintenir les Gateways en ligne avec le couvercle fermé si vous voulez que les bots restent connectés couvercle fermé.
2. Envoyez un message au bot sur Discord ou Telegram (ou @mention sur les serveurs Discord lorsque Exiger une mention dans les serveurs est activé).
3. Alter affiche un placeholder Thinking… pendant l’exécution de l’action, puis se met à jour avec la réponse diffusée. Dans les DM Telegram, Alter peut diffuser via l’aperçu brouillon natif de Telegram lorsque pris en charge ; dans les groupes, il modifie un message normal.
4. Joignez des fichiers dans Discord ou Telegram — Alter les télécharge pour le tour et peut envoyer les fichiers de sortie des outils. Les voice messages et audio files sont transcrits avec votre processeur vocal sélectionné (Préférences → Voice) et envoyés à Alter sous forme de texte ; l’audio plus long est aussi joint comme contexte de transcription type réunion.
5. Utilisez /stop, le bouton Stop (groupes Telegram et Discord), ou attendez la fin du tour avant d’envoyer un autre message dans le même canal ou chat.

​

Une réponse à la fois

Alter gère une réponse en cours par canal ou chat. Si un second message arrive pendant qu’Alter répond encore, le bot indique qu’Alter répond déjà dans ce canal ou chat. Attendez la fin du tour en cours, puis renvoyez.

​

Continuité des conversations

Chaque canal Discord ou chat Telegram peut avoir une conversation Alter active. Utilisez /new pour repartir à zéro, ou /chats et /use pour reprendre une conversation Alter existante sur votre Mac. Sur Discord, activer Démarrer les discussions serveur dans des fils donne à chaque nouveau message de premier niveau du serveur son propre fil et chat Alter. Les réponses dans un fil existant continuent ce chat au lieu d’en démarrer un autre.

​

Confidentialité et données

• Les bot tokens sont stockés dans le macOS Keychain, pas dans des fichiers de paramètres en texte clair.
• La configuration gateway (noms, listes d’accès, default actions) est stockée localement dans les préférences Alter sur votre Mac.
• L’état par canal (conversation sélectionnée, action en attente) est stocké dans le dossier Application Support d’Alter.
• Le traitement des messages utilise la même pile Alter locale que le Hub — il n’y a pas de relais cloud séparé pour le trafic gateway.

Voir aussi Données locales et confidentialité.

​

Dépannage

​

Connexion et tokens

​

Utilisation

​

Disponibilité couvercle fermé

​

Notes de plateforme

• Alter doit être en cours d’exécution — fermer Alter arrête les bots gateway jusqu’à la réouverture de l’app. Sur un MacBook, Maintenir les Gateways en ligne avec le couvercle fermé maintient le Mac éveillé pendant l’exécution des gateways, mais Alter doit rester ouvert.
• Les messages de bots sont ignorés sur les deux plateformes.
• Discord ajoute 👀 pendant le traitement de votre message, puis ✅ ou ❌ à la fin du tour. Les réactions ajoutées par les utilisateurs ne sont pas traitées comme commandes ou entrée de chat.
• Telegram utilise le long polling pour les mises à jour message et callback_query (appuis clavier inline). Après un tour, Alter peut réagir avec 👍 ou 👎 à votre message. Les chats de groupe affichent un bouton Stop pendant les tours actifs.

Pour des problèmes plus larges d’outils et d’autorisations, utilisez Préférences → Doctor ou Tools not working.

​

Pages connexes

• Configurer un Discord gateway
• Configurer un Telegram gateway
• Alter Actions — configurer les actions et la disponibilité gateway
• Alter Settings
• Vue d’ensemble des intégrations
• Guide API Gateway — API compatible OpenAI (séparée des Gateways de chat)