API REST
34 endpoints pour lire tes leads et tes conversations, importer des contacts, envoyer des messages via le moteur anti-ban, piloter tes campagnes, bloquer des numéros et lire tes liens traqués. Démarrage rapide · Authentification
Espace développeurs
Cette section s’adresse aux développeurs et aux intégrations techniques. Si tu veux utiliser WhatSetter au quotidien (campagnes, conversations, rendez-vous), va plutôt dans les guides du dashboard.
Trois portes d’entrée
Section intitulée « Trois portes d’entrée »Webhooks signés
WhatSetter pousse les événements vers ton serveur dès qu’ils se produisent : lead qualifié, lead écarté, numéro déconnecté. Chaque livraison est signée en HMAC-SHA256. Configurer les webhooks
Serveur MCP
34 outils pour Claude, Cursor, VS Code, ChatGPT, Gemini CLI et Codex CLI. Ton assistant lit tes leads, importe des contacts ou bloque un indicatif depuis une conversation. Connecter un assistant
Référence API
Une page par endpoint, générée depuis la spec OpenAPI 3.1, avec les schémas, des exemples et une console « Try it ». Ouvrir la référence
Les guides par ressource
Section intitulée « Les guides par ressource »Chaque guide montre la même requête en cURL, JavaScript et Python, la réponse que tu reçois, et les erreurs qui comptent pour cet endpoint.
LeadsLire, filtrer, modifier, attribuer, passer la main à un humain, ajouter des notes.
Listes et importCréer une liste et y pousser jusqu'à 500 contacts par appel.
CampagnesLister, mettre en pause, relancer, ajouter un lead opt-in.
MessagesEnvoyer un message WhatsApp à un lead avec qui tu parles déjà.
ConversationsBoîte de réception et historique complet des messages.
Rendez-vousLes rendez-vous pris par l'agent.
GroupesGroupes WhatsApp suivis : membres, messages, arrivées et départs.
Contacts bloquésNuméros et indicatifs que l'agent ignore.
ÉquipeLes membres de l'espace, pour attribuer des leads.
Liens traquésTes liens WhatsApp et leurs statistiques de clics.
Les principes
Section intitulée « Les principes »- Une seule clé pour tout. La même clé
ws_live_…sert pour l’API REST et le serveur MCP. Révoque-la et les deux s’arrêtent en moins d’une minute. - Des scopes. Chaque clé porte des permissions (
leads:read,messages:send,blocklist:manage, etc.). Donne à chaque intégration le minimum nécessaire. Voir Authentification et permissions. - L’anti-ban n’est pas contournable. L’API applique les mêmes protections que le dashboard : pas de contact à froid via
POST /messages, un quota quotidien par numéro WhatsApp, des envois humanisés. - Une seule enveloppe d’erreur. Chaque erreur est
{ "error": { "code": "…", "message": "…" } }avec uncodestable. Voir Erreurs, limites et idempotence. - Ton espace seulement. Une clé ne voit que son propre espace. Un identifiant qui appartient à un autre espace répond
404, jamais403.
En chiffres
Section intitulée « En chiffres »| Quoi | Nombre |
|---|---|
| Endpoints REST | 34 |
| Outils MCP | 34 |
| Scopes | 14, plus Accès complet |
| Événements webhook | 5, dont 3 émis aujourd’hui |