Ce que vous pouvez créer
Une application Lyra possède une identité de bot. Cette même identité peut appeler l’API REST, enregistrer des commandes, recevoir les événements Gateway et répondre aux interactions. Les webhooks entrants constituent une solution plus légère pour envoyer uniquement des messages dans un salon.
- Des bots qui réagissent aux événements des communautés en temps réel
- Des commandes slash avec options, autocomplétion et réponses modales
- Des intégrations CI, de supervision et de publication via des webhooks entrants
- Des outils internes utilisant des jetons utilisateur de courte durée
1. Créer une application
Connectez-vous avec votre compte Lyra, ouvrez la console développeur puis choisissez Nouvelle application. Le nom doit contenir entre 2 et 32 caractères ; la description facultative est limitée à 400 caractères.
Le jeton n’est affiché qu’une fois
Copiez immédiatement le jeton généré. Lyra ne conserve que son hash SHA-256. S’il est perdu, effectuez une rotation depuis l’onglet Bot.
2. Conserver le jeton hors du code
Placez le jeton dans une variable d’environnement ou un gestionnaire de secrets. Ne le commitez jamais, ne l’intégrez pas à un bundle client et ne l’envoyez pas dans les paramètres d’une URL.
export LYRA_BOT_TOKEN="paste-the-token-here"3. Effectuer la première requête
Les requêtes de bots utilisent le schéma d’autorisation Bot. La requête ci-dessous lit le profil associé au jeton et permet de valider l’authentification sans modifier de donnée.
curl https://beta.lyra.social/api/v1/users/@me \
-H "Authorization: Bot $LYRA_BOT_TOKEN" \
-H "Accept: application/json"Résultat attendu
Une requête réussie renvoie HTTP 200 et l’objet utilisateur du bot. Les erreurs d’authentification utilisent l’enveloppe JSON standard.
Étapes suivantes
- Enregistrer une commande slash globale
- Générer un lien d’invitation depuis l’onglet Bot
- Se connecter à wss://beta.lyra.social/ws pour les événements en direct
- Utiliser un webhook lorsqu’une connexion persistante n’est pas nécessaire