L'API Kanal permet à n'importe quel back-office e-commerce d'alimenter vos automatisations WhatsApp, sans connexion Shopify. Si votre boutique est sur mesure, headless, ou sur une plateforme que Kanal n'intègre pas nativement, c'est la voie à emprunter.
La référence technique complète et toujours à jour se trouve sur developers.getkanal.com.
Kanal expose deux ensembles d'endpoints, avec des usages et des prérequis différents.
Elle sert à pousser vos données de boutique vers Kanal : commandes, paniers abandonnés, clients et expéditions. Ces données déclenchent ensuite vos automatisations. Elle ne nécessite pas d'abonnement actif.
Elle sert à envoyer des messages : messages libres, templates, déclenchement d'automatisations et lecture des informations de votre compte. Elle nécessite un abonnement actif. Sans cela, chaque appel retourne une erreur 403.
https://api.getkanal.comLes endpoints Commerce sont rattachés à une boutique via un identifiant numérique store_id :
/api/v1/stores/{store_id}/orders
/api/v1/stores/{store_id}/checkouts
/api/v1/stores/{store_id}/customers
/api/v1/stores/{store_id}/shipmentsLes endpoints Messaging ne prennent pas de store_id : la clé API détermine le numéro WhatsApp utilisé pour l'envoi.
Méthode | Chemin | Rôle |
|---|---|---|
|
| Créer ou mettre à jour une commande |
|
| Modifier le statut d'une commande |
|
| Créer ou mettre à jour un panier |
|
| Modifier le statut d'un panier |
|
| Créer ou mettre à jour un client |
|
| Supprimer un client (RGPD) |
|
| Créer ou mettre à jour une expédition |
Méthode | Chemin | Rôle |
|---|---|---|
|
| Envoyer un message libre |
|
| Envoyer un template |
|
| Lister vos templates approuvés |
|
| Déclencher une automatisation |
|
| Informations du compte |
Création d'une commande, qui déclenchera vos automatisations post-achat :
curl -X POST https://api.getkanal.com/api/v1/stores/123/orders \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"external_id": "ORDER-1001",
"placed_at": "2026-05-18T10:00:00Z",
"total_price": 49.90,
"currency": "EUR",
"customer": { "phone": "+33612345678", "first_name": "Marie" }
}'L'API Commerce est en écriture seule. Il n'existe aucun endpoint de lecture ou de pagination pour les commandes, paniers, clients ou expéditions : vous poussez des données, vous ne les relisez pas. Votre système reste la source de vérité. Pour corriger un enregistrement, renvoyez-le avec le même external_id.