Introduction

Démarrage rapide

De la clé API au premier message envoyé depuis votre site, en quatre étapes.

1. Créer une clé API

Depuis votre espace MasterAgent, ouvrez Paramètres puis Clés API et générez une clé. Elle ne s'affiche qu'une seule fois : conservez-la dans les variables d'environnement de votre serveur.

env

MASTERAGENT_API_KEY=ma_live_xxxxxxxxxxxxxxxx

2. Connecter un numéro WhatsApp

Créez une session, puis affichez le QR code à scanner depuis le téléphone qui porte le numéro.

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": "qr" }'

3. Envoyer un message

javascript

const res = await fetch("https://masteragents.fun/api/public/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MASTERAGENT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    sessionId: "sess_2f9a",
    to: "2250700000000",
    type: "text",
    text: "Bonjour 👋 Merci pour votre commande !",
  }),
});

const message = await res.json();

4. Lire les réponses

Il n'y a pas de webhook à configurer : récupérez les messages à tout moment avec une simple requête GET. Utilisez le paramètre since pour ne recevoir que les nouveaux messages depuis votre dernier appel.

bash

curl "https://masteragents.fun/api/public/v1/messages?sessionId=sess_2f9a&since=2026-01-01T10:00:00Z&limit=50" \
  -H "Authorization: Bearer $MASTERAGENT_API_KEY"

N'appelez jamais l'API depuis le navigateur : la clé serait exposée. Passez toujours par votre serveur ou une fonction back-end.