Référence API

Messages

Envoyez du texte, des médias et des notes vocales depuis une session connectée.

Envoyer un message

POST/messages

Paramètre	Type	Description
sessionId *	string	Session WhatsApp utilisée pour l'envoi.
to *	string	Numéro du destinataire au format international sans « + ».
type *	"text" \| "image" \| "document" \| "audio"	Type de contenu envoyé.
text	string	Corps du message ou légende du média. 4096 caractères maximum.
mediaUrl	string	URL publique du fichier à envoyer. Requis pour les types média.
filename	string	Nom affiché pour un document.

sessionIdstringrequis
Session WhatsApp utilisée pour l'envoi.
tostringrequis
Numéro du destinataire au format international sans « + ».
type"text" | "image" | "document" | "audio"requis
Type de contenu envoyé.
textstring
Corps du message ou légende du média. 4096 caractères maximum.
mediaUrlstring
URL publique du fichier à envoyer. Requis pour les types média.
filenamestring
Nom affiché pour un document.

javascript

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: "image",
    mediaUrl: "https://votre-site.com/produits/sac.jpg",
    text: "Voici le modèle disponible — 25 000 FCFA",
  }),
});

json

{
  "id": "msg_71ca3d",
  "sessionId": "sess_2f9a",
  "to": "2250700000000",
  "status": "queued",
  "createdAt": "2026-09-14T01:20:03Z"
}

Notes vocales

WhatsApp attend de l'audio OPUS (.ogg). Envoyez un fichier déjà encodé, sinon il sera transmis comme pièce jointe audio classique. Les messages vocaux reçus sont transcrits automatiquement pour votre agent IA.

Historique des messages

GET/messages?sessionId=sess_2f9a&limit=50

Paramètre	Type	Description
sessionId	string	Filtrer par session.
contact	string	Filtrer par numéro de contact.
limit	number	1 à 100, 25 par défaut.
cursor	string	Curseur de pagination renvoyé par la requête précédente.

sessionIdstring
Filtrer par session.
contactstring
Filtrer par numéro de contact.
limitnumber
1 à 100, 25 par défaut.
cursorstring
Curseur de pagination renvoyé par la requête précédente.

Respectez les règles de WhatsApp : pas de message non sollicité en masse. Un envoi abusif peut entraîner le blocage du numéro par WhatsApp, indépendamment de MasterAgent.