Webhooks
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 | sur demande le client change ses choix de produits |
updated_change_choices s’active sur demande auprès de l’équipe Ciklik, pas par l’API.
Par où commencer
Section intitulée « Par où commencer » Activer et tester La procédure, pas à pas, avec un premier envoi de test.
Comprendre un envoi Le contrat technique, pour votre développeur.
Référence des événements Chaque clé en détail, avec un exemple de contenu.
Bonnes pratiques et dépannage Réponse attendue, tentatives, sécurité, diagnostic.
Contrat OpenAPI Le contrat lisible par une machine.
À 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) | Équipe Ciklik ou API vendors | Les événements de votre boutique : abonnements, commandes, expéditions, clients… | cette page |
| Relance de panier abandonné | Mes Sites, onglet Paramètres marketing | Les coordonnées d’un panier abandonné et un lien de reprise | 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 |
| Campagne anti-churn | Mes Sites, section Webhook de la campagne | Une notification à un abonné dont le paiement a échoué | Campagne anti-churn |
Ces trois derniers ont un format et un cycle qui n’ont rien à voir avec les webhooks de site.