Base de connaissances GetMyBot

Authentification et jetons

Donner accès à GetMyBot à un programme : créer un jeton personnel, choisir un compte et limiter les opérations autorisées.

Sur cette page

Un jeton personnel donne accès à GetMyBot sans transmettre votre mot de passe. Cette documentation l’appelle PAT (Personal Access Token). Pour lire la liste des bots, le droit bots:read suffit ; pour créer des réactions, il faut reactions:write.

À la création, choisissez un seul compte et les autorisations nécessaires, appelées portées (scopes). Le jeton ne fonctionne que dans ce compte et n’accorde jamais plus de droits que votre utilisateur. Pour une première requête, voir le démarrage rapide de l’API.

Créer un jeton

Créez votre jeton personnel dans la section dédiée du compte. Sa valeur s’affiche une seule fois : conservez-la en lieu sûr. Le serveur ne garde qu’un hachage ; si vous le perdez, créez-en un nouveau et supprimez l’ancien.

Tous les jetons personnels commencent par mbp_.

Transmettre le jeton

Envoyez-le avec chaque requête dans l’en-tête HTTP Authorization, selon le schéma Bearer :

Authorization: Bearer <JETON_PERSONNEL>

Remplacez <JETON_PERSONNEL>, chevrons compris, par la valeur complète affichée, y compris mbp_. N’ajoutez pas ce préfixe une deuxième fois. Le serveur MCP n’accepte que les jetons personnels ; le jeton API d’un projet (mb_live_…) ne convient pas.

Le même en-tête sert aux sessions du compte web, qui utilisent un JWT de courte durée. Pour une intégration, utilisez le PAT mbp_….

Compte associé au jeton

Le jeton fonctionne dans un seul compte. Il s’agit du vôtre par défaut. Si vous avez accès à un autre compte, vous pouvez le choisir lors de la création : champ account_id dans POST /api/tokens ou liste déroulante au-dessus de la durée de validité dans l’interface. GET /api/account/cabinets énumère les comptes accessibles.

En pratique :

  • GET /api/bots renvoie les bots du compte choisi, sans vos bots personnels ni ceux d’un troisième compte.
  • Demander un bot d’un autre compte renvoie 404, comme pour un bot appartenant à quelqu’un d’autre. Le jeton ne permet pas de vérifier si son ID existe hors du compte choisi.
  • Vos droits restent les vôtres : le jeton limite l’accès à un compte, il ne l’étend pas. Le rôle dans le compte et les droits accordés sur chaque bot décident de ce que vous pouvez faire.
  • Un jeton créé pour le compte d’autrui agit avec vos droits dans ce compte. Lire la facturation (/api/billing/*) exige billing.read au niveau du compte ; créer des projets exige bots.create. Même la portée * ne donne pas ces droits.
  • Si votre accès au compte est révoqué, le jeton cesse de fonctionner dès la requête suivante ; il n’est pas nécessaire de le révoquer à part.

Compte accessible seulement par un bot

Dans GET /api/account/cabinets, le champ source de chaque compte indique :

  • self : votre propre compte ;
  • account : vous avez accès au compte selon un rôle ;
  • bot : vous avez seulement accès à un bot de ce compte, sans droit sur le compte entier.

Avec source: "bot", les opérations sur ce bot fonctionnent dans la limite de ses droits ; les opérations concernant tout le compte, comme connecter un bot ou la facturation, sont refusées. REST renvoie 403 avec {"error":"missing cabinet right"} ou, si vous êtes membre mais sans le droit requis, missing cabinet right: <droit>. MCP renvoie permission denied: missing cabinet right. Par exemple, connect_bot exige bots.create, et les outils de facturation exigent billing.read ou billing.write.

Pour obtenir ce droit, le propriétaire doit vous inviter dans Accès au compte avec l’autorisation nécessaire. Il n’est pas utile de recréer le jeton : il fonctionnera à la requête suivante après acceptation de l’invitation.

Les jetons créés avant cette fonction restent liés à votre propre compte. Si un tel jeton servait à accéder à un bot partagé depuis un autre compte, créez un jeton distinct pour ce dernier.

Portées d’accès

Les portées ont la forme ressource:action. La lecture utilise :read, la modification :write :

PortéeAutorise
bots:read, bots:writeBots, réglages, synchronisation et jeton du bot
reactions:read, reactions:writeRéactions, import, tests de formules, liens et ordre
labels:read, labels:writeÉtiquettes des abonnés
collections:read, collections:writeCollections et enregistrements
flows:read, flows:writeScénarios
integrations:read, integrations:writeIntégrations, connexions et identifiants
media:writeTéléversement dans la médiathèque
templates:read, templates:writeModèles de bots
settings:read, settings:writeRéglages
subscribers:readAbonnés et historique des conversations, en lecture
broadcasts:writeDiffusions et leur gestion
stats:readStatistiques et analytique
billing:readSolde et forfaits, en lecture

La portée spéciale * donne accès à tous les endpoints publics, sous réserve de vos droits effectifs.

Ce que le jeton permet ou non

Le PAT donne accès aux endpoints du constructeur, qui servent à bâtir le bot. Il ne permet pas d’appeler les endpoints réservés à la session web : connexion et inscription, endpoints mobiles, paiements et rechargement du solde, notifications, journal d’audit, envoi de messages par un opérateur, webhooks entrants, callbacks de paiement et WebSocket. Un jeton mbp_ sur ces routes obtient 401 ou 403.

Si la portée nécessaire à une route manque, la réponse est 403. Voir Erreurs API pour les codes.

Portées des fonctions d’agent IA

  • managed_ai:invoke et managed_ai:usage:read : appeler l’IA via l’interface commune des fournisseurs et lire la consommation.
  • copilot:use : utiliser les propositions Copilot. journey:read suffit pour diagnostiquer ; une modification du scénario exige aussi journey:edit.
  • journey:read et journey:edit : analyser les scénarios et leurs exécutions avec Flow Intelligence et Explainable Replay.
  • Les connexions Meta utilisent les portées des intégrations et des bots, avec vérification supplémentaire des droits du compte et du bot.

MCP applique les mêmes contrôles. Une connexion MCP n’ajoute aucun droit sur les autres comptes ou bots.

Pour aller plus loin