API v1 · REST · JSON

Documentation développeur

L'API WatSell te permet d'intégrer ton agent WhatsApp dans tes propres outils : envoyer des messages, lire les conversations, gérer le catalogue et déclencher des livraisons, par programmation.

Base URL

https://watsell.app/api/watsell/v1

Authentification

Chaque requête doit inclure ta clé API dans l'en-tête X-API-Key. Génère ta clé dans l'app WatSell → Réglages → API développeur.

X-API-Key: wsk_live_xxxxxxxxxxxxxxxxxxxx

Garde ta clé secrète. Toute personne qui l'a peut envoyer des messages depuis ton numéro. En cas de fuite, régénère-la depuis l'app (l'ancienne est invalidée).

Endpoints

GET /health

Vérifie ta clé et l'état de ta connexion WhatsApp.

curl https://watsell.app/api/watsell/v1/health \
  -H "X-API-Key: $WATSELL_KEY"

# {"ok":true,"shop":"Ma Boutique","wa":"connected"}

POST /messages

Envoie un message WhatsApp à un client depuis ton numéro connecté.

Champ	Type	Description
`to`	string	Numéro du destinataire (format international, ex 2376...)
`text`	string	Le message (max 4000 caractères)

curl -X POST https://watsell.app/api/watsell/v1/messages \
  -H "X-API-Key: $WATSELL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"237699000000","text":"Bonjour, votre commande est prete !"}'

# {"ok":true,"to":"237699000000"}

GET /conversations

Liste tes conversations (numéro, dernier message, état de l'agent).

curl https://watsell.app/api/watsell/v1/conversations \
  -H "X-API-Key: $WATSELL_KEY"

GET /conversation?phone=2376...

Récupère l'historique complet d'une conversation avec un client.

curl "https://watsell.app/api/watsell/v1/conversation?phone=237699000000" \
  -H "X-API-Key: $WATSELL_KEY"

GET /catalog

Liste tes produits (nom, prix, description, lien de paiement).

curl https://watsell.app/api/watsell/v1/catalog \
  -H "X-API-Key: $WATSELL_KEY"

POST /orders

Crée une commande. Produit numérique = lien envoyé automatiquement. Produit physique = confirmation client puis flux livreur (COD).

curl -X POST https://watsell.app/api/watsell/v1/orders \
  -H "X-API-Key: $WATSELL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product":"Sac cuir","kind":"physical","amount":"25000 FCFA",
       "address":"Bonamoussadi","clientName":"Awa","clientPhone":"237699000000"}'

GET /orders

Liste tes commandes et leur état (awaiting_confirm, searching, delivered, received, cancelled...).

curl https://watsell.app/api/watsell/v1/orders \
  -H "X-API-Key: $WATSELL_KEY"

Webhook (event-hook)

Configure une URL de webhook dans l'app (Réglages → API). WatSell y enverra un POST JSON à chaque événement.

Événement	Déclencheur
`message.received`	Un client t'envoie un message
`order.created`	Une commande est créée

Format reçu

POST https://ton-serveur.com/webhook
X-WatSell-Event: message.received

{
  "event": "message.received",
  "at": 1787900000000,
  "shop": "Ma Boutique",
  "data": { "from": "237699000000", "text": "Bonjour, c'est dispo ?" }
}

Codes de réponse

Code	Signification
`200`	Succès
`400`	Requête invalide (champ manquant, WhatsApp non connecté)
`401`	Clé API invalide ou manquante
`404`	Endpoint inconnu

API v1 : fonctionne sur les numéros déjà connectés à WatSell. La connexion de numéros tiers (statut BSP / Tech Provider Meta) arrive en v2.