Webhooks
L'essentiel
Les webhooks Ciklik envoient en temps réel les événements de votre boutique (abonnements, commandes, transactions, factures, expéditions, clients, adresses, inscriptions marketing) à une URL de réception que vous choisissez, sur une boutique box comme sur un site PrestaShop équipé du module Ciklik. Ciklik propose 18 événements, comme created_subscription ou updated_subscription, et vous déclarez une URL par clé d’événement dans Paramètres > Sites, onglet Avancé, champ Webhooks, ou par l’API. Chaque envoi est une requête POST au format JSON, et l’activation devient effective en moins d’une minute. Les webhooks servent à synchroniser un ERP, alimenter un outil no-code comme Make ou Zapier ou prévenir votre équipe logistique.
Un webhook prévient votre système dès que quelque chose change dans votre boutique Ciklik : un abonnement, une commande, une expédition, un client, une inscription. Vous indiquez une URL de réception pour chaque type d’événement. Ciklik y envoie l’information au moment où elle se produit, sans que vous ayez à interroger quoi que ce soit.
À quoi ça sert
Section intitulée « À quoi ça sert »- Synchroniser votre boutique avec un ERP ou un site PrestaShop, sans ressaisie manuelle.
- Alimenter un tableur ou un outil no-code, comme Make ou Zapier.
- Prévenir votre équipe logistique dès qu’une nouvelle expédition est créée.
- Déclencher l’envoi d’un e-mail personnalisé depuis un outil hors Ciklik.
Les 18 événements disponibles
Section intitulée « Les 18 événements disponibles »| Objet | Clé | Quand il part |
|---|---|---|
| Abonnement | created_subscription | un abonnement est créé |
| Abonnement | updated_subscription | un abonnement est modifié |
| Abonnement | deleted_subscription | un abonnement est supprimé |
| Expédition | created_shippingbox | une expédition est créée |
| Expédition | updated_shippingbox | une expédition est modifiée |
| Expédition | deleted_shippingbox | une expédition est supprimée |
| Commande | created_checkoutorder | une commande est créée |
| Commande | updated_checkoutorder | une commande est modifiée |
| Transaction | created_checkouttransaction | une transaction est créée |
| Transaction | updated_checkouttransaction | une transaction est modifiée |
| Facture | created_checkoutinvoice | une facture est émise |
| Client | created_user | un client est créé |
| Client | updated_user | un client est modifié |
| Adresse | created_address | une adresse est créée |
| Adresse | updated_address | une adresse est modifiée |
| Inscription marketing | created_optin | une inscription marketing est créée |
| Inscription marketing | updated_optin | une inscription marketing est modifiée |
| Abonnement | updated_change_choices | hors API le client change ses choix de produits |
updated_change_choices ne s’active pas par l’API : ajoutez-la dans le champ Webhooks de l’onglet Avancé de votre site.
Par où commencer
Section intitulée « Par où commencer »À ne pas confondre
Section intitulée « À ne pas confondre »| Mécanisme | Où il se configure | Ce qu’il envoie | Page |
|---|---|---|---|
| Webhooks de site (cette rubrique) | Sites, onglet Avancé, champ Webhooks, ou API vendors | Les événements de votre boutique : abonnements, commandes, expéditions, clients… | cette page |
| Relance de panier abandonné | Sites, onglet Avancé, section Relances de panier abandonné | Les coordonnées d’un panier abandonné et un lien de reprise, signés par l’en-tête X-Ciklik-Signature | Paniers abandonnés |
| Bloc Newsletter de l’éditeur | Paramétrage du bloc Newsletter, sur votre site | L’adresse e-mail d’un nouvel inscrit à la newsletter | Récupérer les inscrits à la newsletter |
Ces deux derniers ont un format et un cycle qui n’ont rien à voir avec les webhooks de site.
Questions fréquentes
Comment savoir quel événement a déclenché un webhook Ciklik ?
Uniquement par l'URL appelée : le contenu de l'envoi ne contient pas le nom de l'événement. Déclarez une URL de réception distincte pour chaque clé d'événement.
Les webhooks Ciklik sont-ils signés ?
Pas les webhooks de site : Ciklik n'y met ni signature ni secret partagé, votre URL de réception est le seul secret du dispositif. Utilisez HTTPS et gardez cette URL confidentielle. Seuls les webhooks de relance de panier abandonné sont signés, par l'en-tête X-Ciklik-Signature : voir la page Paniers abandonnés.
Un webhook en échec est-il renvoyé ?
Seulement si la connexion échoue (DNS, refus, délai dépassé, certificat invalide) : Ciklik fait alors jusqu'à 5 tentatives au total. Une réponse 4xx ou 5xx n'est jamais rejouée, et une réponse qui dépasse 30 secondes provoque des doublons.
Peut-on recevoir les webhooks Ciklik dans Make ou Zapier ?
Oui. Créez un module « Custom webhook » dans Make ou un déclencheur « Catch Hook » dans Zapier, puis déclarez l'URL fournie pour la clé d'événement voulue.
Tous les événements s'activent-ils par l'API ?
Non. 17 clés s'activent par l'API. La clé updated_change_choices s'ajoute uniquement dans le champ Webhooks de l'onglet Avancé de votre site.