--- title: "Webhooks" description: "Recevez en temps réel les événements de votre boutique Ciklik (abonnements, commandes, expéditions, clients) sur votre propre système." url: https://www.ciklik.academy/fr/webhooks/ lang: fr lastUpdated: 2026-10-23 --- # Webhooks > Box et PrestaShop > > Cette page vaut pour les boutiques box comme pour les boutiques PrestaShop. 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. > Comment l’activer > > Choisissez la clé de l’événement dans le catalogue plus bas. Déclarez cette clé et votre URL de réception dans **Paramètres > Sites**, fiche de votre site, onglet **Avancé**, champ **Webhooks**, ou par l’API. L’envoi devient actif en moins d’une minute. > > Voir [Activer et tester un webhook](https://www.ciklik.academy/fr/webhooks/activer-et-tester-un-webhook/) et [Configurer les webhooks par l’API](https://www.ciklik.academy/fr/webhooks/configurer-les-webhooks-par-lapi/). ## À 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 | Objet | Clé | Quand il part | | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | | Abonnement | [`created_subscription`](https://www.ciklik.academy/fr/webhooks/evenements-abonnements/#created_subscription) | un abonnement est créé | | Abonnement | [`updated_subscription`](https://www.ciklik.academy/fr/webhooks/evenements-abonnements/#updated_subscription) | un abonnement est modifié | | Abonnement | [`deleted_subscription`](https://www.ciklik.academy/fr/webhooks/evenements-abonnements/#deleted_subscription) | un abonnement est supprimé | | Expédition | [`created_shippingbox`](https://www.ciklik.academy/fr/webhooks/evenements-expeditions/#created_shippingbox) | une expédition est créée | | Expédition | [`updated_shippingbox`](https://www.ciklik.academy/fr/webhooks/evenements-expeditions/#updated_shippingbox) | une expédition est modifiée | | Expédition | [`deleted_shippingbox`](https://www.ciklik.academy/fr/webhooks/evenements-expeditions/#deleted_shippingbox) | une expédition est supprimée | | Commande | [`created_checkoutorder`](https://www.ciklik.academy/fr/webhooks/evenements-commandes-transactions-factures/#created_checkoutorder) | une commande est créée | | Commande | [`updated_checkoutorder`](https://www.ciklik.academy/fr/webhooks/evenements-commandes-transactions-factures/#updated_checkoutorder) | une commande est modifiée | | Transaction | [`created_checkouttransaction`](https://www.ciklik.academy/fr/webhooks/evenements-commandes-transactions-factures/#created_checkouttransaction) | une transaction est créée | | Transaction | [`updated_checkouttransaction`](https://www.ciklik.academy/fr/webhooks/evenements-commandes-transactions-factures/#updated_checkouttransaction) | une transaction est modifiée | | Facture | [`created_checkoutinvoice`](https://www.ciklik.academy/fr/webhooks/evenements-commandes-transactions-factures/#created_checkoutinvoice) | une facture est émise | | Client | [`created_user`](https://www.ciklik.academy/fr/webhooks/evenements-clients-adresses-optins/#created_user) | un client est créé | | Client | [`updated_user`](https://www.ciklik.academy/fr/webhooks/evenements-clients-adresses-optins/#updated_user) | un client est modifié | | Adresse | [`created_address`](https://www.ciklik.academy/fr/webhooks/evenements-clients-adresses-optins/#created_address) | une adresse est créée | | Adresse | [`updated_address`](https://www.ciklik.academy/fr/webhooks/evenements-clients-adresses-optins/#updated_address) | une adresse est modifiée | | Inscription marketing | [`created_optin`](https://www.ciklik.academy/fr/webhooks/evenements-clients-adresses-optins/#created_optin) | une inscription marketing est créée | | Inscription marketing | [`updated_optin`](https://www.ciklik.academy/fr/webhooks/evenements-clients-adresses-optins/#updated_optin) | une inscription marketing est modifiée | | Abonnement | [`updated_change_choices`](https://www.ciklik.academy/fr/webhooks/evenements-abonnements/#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 [Activer et tester un webhook](https://www.ciklik.academy/fr/webhooks/activer-et-tester-un-webhook/) [Comprendre un envoi de webhook](https://www.ciklik.academy/fr/webhooks/comprendre-un-envoi-de-webhook/) [Événements : abonnements](https://www.ciklik.academy/fr/webhooks/evenements-abonnements/) [Bonnes pratiques et dépannage](https://www.ciklik.academy/fr/webhooks/bonnes-pratiques-et-depannage/) [Contrat OpenAPI ](https://www.ciklik.academy/openapi/ciklik-webhooks.yaml)Le contrat lisible par une machine. ## À 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](https://www.ciklik.academy/fr/acquisition/paniers-abandonnes/) | | 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](https://www.ciklik.academy/fr/acquisition/recuperer-les-inscrits-a-la-newsletter/) | Ces deux derniers ont un format et un cycle qui n’ont rien à voir avec les webhooks de site. > Données personnelles > > Le contenu d’un envoi comprend les coordonnées de vos clients : nom, adresse, téléphone, e-mail. Utilisez HTTPS. Votre URL de réception est le seul secret du dispositif : gardez-la confidentielle et ne la communiquez qu’aux systèmes qui en ont besoin. ## 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.