Référence API

Sessions WhatsApp

Une session représente un numéro WhatsApp connecté à MasterAgent. Elle peut être créée par QR code ou par code d'appairage à huit chiffres.

Créer une session

POST/sessions

Paramètre	Type	Description
label *	string	Nom affiché de la session, par exemple « Service client ».
method *	"qr" \| "pairing"	Mode de connexion souhaité.
phone	string	Numéro international sans « + ». Obligatoire si method vaut pairing.
agentId	string	Agent IA qui répondra automatiquement aux messages entrants.

labelstringrequis
Nom affiché de la session, par exemple « Service client ».
method"qr" | "pairing"requis
Mode de connexion souhaité.
phonestring
Numéro international sans « + ». Obligatoire si method vaut pairing.
agentIdstring
Agent IA qui répondra automatiquement aux messages entrants.

bash

curl -X POST https://masteragents.fun/api/public/v1/sessions \
  -H "Authorization: Bearer $MASTERAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "label": "Service client", "method": "pairing", "phone": "2250700000000" }'

json

{
  "id": "sess_2f9a",
  "label": "Service client",
  "status": "pending",
  "pairingCode": "48219073",
  "qr": null,
  "createdAt": "2026-09-14T01:12:44Z"
}

Lire une session

GET/sessions/{sessionId}

Interrogez cette route toutes les 3 secondes tant que le statut vaut pending. Le QR code expire au bout de 60 secondes et est renouvelé automatiquement.

json

{
  "id": "sess_2f9a",
  "status": "connected",
  "profile": {
    "name": "Ma Boutique",
    "phone": "2250700000000",
    "pictureUrl": "https://…"
  }
}

Statuts possibles

Paramètre	Type	Description
pending	statut	En attente de scan du QR code ou de saisie du code d'appairage.
connected	statut	Numéro connecté, messages entrants et sortants actifs.
disconnected	statut	Session interrompue : reconnectez-la pour reprendre.
expired	statut	Connexion non finalisée dans les délais, créez une nouvelle session.

pendingstatut
En attente de scan du QR code ou de saisie du code d'appairage.
connectedstatut
Numéro connecté, messages entrants et sortants actifs.
disconnectedstatut
Session interrompue : reconnectez-la pour reprendre.
expiredstatut
Connexion non finalisée dans les délais, créez une nouvelle session.

Lister, reconnecter, supprimer

GET/sessions

POST/sessions/{sessionId}/reconnect

DELETE/sessions/{sessionId}

La suppression déconnecte le numéro et efface les identifiants de session. L'historique des conversations reste disponible dans votre espace.