Si votre boutique n'est pas sur Shopify (site sur mesure, headless ou autre plateforme), vous pouvez quand même l'utiliser avec Kanal. Créez une boutique personnalisée : vos développeurs envoient ensuite vos commandes, paniers abandonnés, clients et expéditions à Kanal via l'API Commerce, et ces données déclenchent vos automatisations WhatsApp.
Cliquez sur le nom de votre équipe, puis sur Paramètres.
Ouvrez Boutiques, puis cliquez sur Ajouter une boutique.
Choisissez Boutique personnalisée et renseignez les informations demandées.
La boutique apparaît ensuite dans la liste de Paramètres > Boutiques. Ouvrez-la pour accéder à ses onglets API & ingestion et Guide.
L'onglet API & ingestion fournit une Clé d'ingestion API. Cette clé ne fonctionne que pour cette boutique : elle ne peut écrire dans aucune autre boutique de votre équipe.
Transmettez-la à votre développeur et conservez-la côté serveur uniquement, jamais dans un navigateur ou une application mobile.
Si la clé a fuité, ou si un prestataire ne doit plus y avoir accès, régénérez-la ou révoquez-la depuis ce même onglet, puis mettez à jour votre intégration.
Elle s'utilise comme une clé API classique, dans l'en-tête Authorization: Bearer <votre clé>. Une clé créée dans Paramètres > Développeurs > Clés API fonctionne aussi, mais elle donne accès à toutes les boutiques de votre équipe. Pour une boutique personnalisée, préférez la clé d'ingestion, limitée à cette seule boutique.
L'onglet Guide affiche le store_id de la boutique, l'identifiant numérique qui figure dans le chemin de chaque appel à l'API Commerce. Vous n'avez pas besoin de le demander au support.
Toutes les URL de l'API Commerce commencent par :
https://api.getkanal.com/api/v1/stores/{store_id}/
/api/v1/ après le nom de domaine. Une URL de la forme https://api.getkanal.com/v1/stores/... ne fonctionne pas.Endpoint | Usage |
|---|---|
| Créer ou mettre à jour une commande |
| Créer ou mettre à jour un panier abandonné |
| Créer ou mettre à jour une fiche client |
| Créer ou mettre à jour une expédition |
Exemple d'envoi d'une commande, avec le store_id 123 :
curl -X POST https://api.getkanal.com/api/v1/stores/123/orders \
-H "Authorization: Bearer VOTRE_CLE_D_INGESTION" \
-H "Content-Type: application/json" \
-d '{
"external_id": "ORDER-1001",
"total_price": 49.90,
"currency": "EUR",
"customer": { "phone": "+33612345678", "first_name": "Marie" }
}'Le détail de chaque endpoint (champs, statuts, erreurs, limites) est dans API Commerce : envoyer vos données de boutique à Kanal. La référence technique complète est sur developers.getkanal.com.
Commande : une commande envoyée avec le téléphone du client (customer.phone) peut déclencher vos automatisations au déclencheur Commande boutique créée. Sans téléphone, la commande est enregistrée mais ne déclenche rien.
Panier abandonné : seul un panier au statut abandoned déclenche une automatisation.
Expédition : une expédition déclenche vos automatisations au déclencheur Mise à jour d'expédition boutique uniquement si elle contient un numéro de suivi (tracking_number) et une URL de suivi (tracking_url), et si la commande liée est connue de Kanal avec un contact. Sinon, l'expédition est enregistrée mais aucun message ne part.
POST /customers.Pour en savoir plus sur les clés et les erreurs d'authentification, consultez Authentification et clés API.