Documentation API

Branchez votre boutique et vos outils à WatPilot

Une API REST pour vos propres systèmes : envoyer des commandes à confirmer sur WhatsApp, lire commandes et conversations, répondre, et recevoir des webhooks signés. Adresse de base : https://watpilot.com/api/public/v1

Commandes en entrée, confirmations en sortie

Toute boutique capable d'appeler une URL obtient la confirmation COD sur WhatsApp.

Clés à portée limitée

read / write / mcp, révocables, affichées une fois, stockées hachées.

Webhooks signés

order.confirmed, handoff.requested… au moins une fois, vérifiables.

Et en MCP

Le même espace de travail en outils MCP sur https://watpilot.com/mcp.

Authentification — et votre premier appel

Créez une clé dans Paramètres → Clés API (portées : read, write, mcp). Elle n'est affichée qu'une fois. Envoyez-la en jeton Bearer. Cet appel transmet une commande à WatPilot, qui demande au client de la confirmer sur WhatsApp :

curl https://watpilot.com/api/public/v1/orders \
  -H "Authorization: Bearer wp_live_…" \
  -H "Content-Type: application/json" \
  -d '{"customer_phone": "0661 23 45 67", "customer_name": "Karim",
       "total": 4500, "currency": "DZD", "address": "Bab Ezzouar, Alger",
       "items": [{"name": "Montre Aurora", "quantity": 1, "price": 4500}],
       "external_id": "commande-1042"}'

Points de Terminaison API

POST
/orders

Créer une commande

Commande COD depuis n'importe quelle boutique ; déclenche la confirmation WhatsApp. Numéro au format local accepté ; même external_id deux fois → 409. Portée : write

GET
/orders

Lister les commandes

Filtre ?status=pending|confirmed|cancelled…, paginé. Portée : read

POST
/orders/{order_number}/status

Mettre à jour une commande

Par exemple shipped, delivered. Portée : write

GET
/bots

Lister les assistants

Vos assistants et leurs identifiants. Portée : read

GET
/conversations

Lister les conversations

?bot_id=&needs_human=true pour trouver les clients qui attendent un humain. Portée : read

POST
/conversations/{id}/messages

Répondre à un client

Envoie un message WhatsApp dans la conversation. Portée : write

POST
/webhooks

S'abonner aux événements

Signés par X-WatPilot-Signature (HMAC-SHA256), 5 nouvelles tentatives. Portée : write

Événements webhook

Abonnez-vous à un, plusieurs, ou "*" pour tous.

order.created
order.confirmed
order.cancelled
order.status_changed
handoff.requested
handoff.resolved

Besoin d'aide ?

Écrivez à contact@watpilot.com en précisant ce que vous branchez : nous répondons avec un exemple qui marche.