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/botsrenvoie 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/*) exigebilling.readau niveau du compte ; créer des projets exigebots.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ée | Autorise |
|---|---|
bots:read, bots:write | Bots, réglages, synchronisation et jeton du bot |
reactions:read, reactions:write | Réactions, import, tests de formules, liens et ordre |
labels:read, labels:write | Étiquettes des abonnés |
collections:read, collections:write | Collections et enregistrements |
flows:read, flows:write | Scénarios |
integrations:read, integrations:write | Intégrations, connexions et identifiants |
media:write | Téléversement dans la médiathèque |
templates:read, templates:write | Modèles de bots |
settings:read, settings:write | Réglages |
subscribers:read | Abonnés et historique des conversations, en lecture |
broadcasts:write | Diffusions et leur gestion |
stats:read | Statistiques et analytique |
billing:read | Solde 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:invokeetmanaged_ai:usage:read: appeler l’IA via l’interface commune des fournisseurs et lire la consommation.copilot:use: utiliser les propositions Copilot.journey:readsuffit pour diagnostiquer ; une modification du scénario exige aussijourney:edit.journey:readetjourney: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
- Démarrage rapide de l’API : première requête avec le jeton.
- Erreurs : comprendre
401et403. - MCP : utiliser le même jeton avec un agent.