Langage :

Créer un Bot

Enregistrez un bot via l'API REST, récupérez son token et gérez ses métadonnées.

Prérequis

Un compte AlfyChat actif est requis. Vous pouvez créer jusqu'à 5 bots par compte. Le bot est lié à votre compte utilisateur et nécessite votre JWT pour être créé.

Créer un bot

POST

/api/bots

Crée un nouveau bot et retourne son token (affiché une seule fois)

POST /api/bots — Créer un bot

const res = await fetch('https://gateway.alfychat.app/api/bots', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + process.env.USER_JWT,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'MonBot',
    prefix: '!',
    description: 'Un bot utile pour ma communauté',
    isPublic: false,
  }),
});

const { bot } = await res.json();
console.log('Bot créé ! ID    :', bot.id);
console.log('Token (1 seule fois) :', bot.token);

Réponse 201 Created

Corps de la réponse

json

{
  "success": true,
  "bot": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "MonBot",
    "prefix": "!",
    "description": "Un bot utile pour ma communauté",
    "token": "abc123...64hexchars",  // ← Stocker immédiatement !
    "isVerified": false,
    "isPublic": false,
    "avatarUrl": null,
    "serverCount": 0,
    "createdAt": "2025-01-15T10:00:00.000Z"
  }
}

Autres opérations

GET

/api/bots

Liste tous vos bots (token masqué)

GET

/api/bots/:id

Détails d'un bot spécifique

PATCH

/api/bots/:id

Modifier nom, préfixe, description, avatar, visibilité

DELETE

/api/bots/:id

Supprimer définitivement le bot et ses données

POST

/api/bots/:id/regenerate-token

Générer un nouveau token — invalide l'ancien immédiatement

Token — Une seule exposition

Le token est retourné uniquement à la création. Les autres lectures renvoient le token masqué. Si vous le perdez, régénérez-le via /regenerate-token — l'ancien token sera définitivement invalidé.

PrécédentIntroduction AuthentificationSuivant