---
title: "Activer et tester un webhook"
description: "Faites activer une URL de réception pour un événement, vérifiez qu'elle reçoit bien les envois et lisez votre premier webhook Ciklik."
url: https://www.ciklik.academy/fr/webhooks/activer-et-tester-un-webhook/
lang: fr
lastUpdated: 2026-10-23
---

# Activer et tester un webhook

> Box et PrestaShop
>
> Cette page vaut pour les boutiques box comme pour les boutiques PrestaShop.

Avant de commencer, réunissez :

- une URL de réception publique, qui accepte les requêtes POST et répond immédiatement ;
- la clé de l’événement que vous voulez recevoir (voir le [catalogue des événements](https://www.ciklik.academy/fr/webhooks/)) ;
- dix minutes.

## Étape 1 : obtenir une URL de réception

**Outil no-code (Make, Zapier) :**

C’est le chemin le plus simple, et celui que suivent la plupart des marchands Ciklik.

1. Ajoutez un module “Custom webhook” dans un nouveau scénario Make.

2. Copiez l’URL que Make vous donne.

3. Déclarez-la pour la clé d’événement voulue (voir l’étape 2 ci-dessous).

4. Une fois le premier envoi reçu, cliquez sur le bouton “Redetermine data structure” du module webhook dans Make : les champs de l’événement deviennent alors utilisables dans la suite de votre scénario.

Le même principe vaut pour Zapier : créez un déclencheur “Catch Hook” et suivez les mêmes étapes.

**Votre serveur :**

Une adresse de votre application qui accepte le POST JSON et répond immédiatement suffit. Pour construire cette URL de réception, votre développeur trouvera le contrat complet de la requête dans [Comprendre un envoi de webhook](https://www.ciklik.academy/fr/webhooks/comprendre-un-envoi-de-webhook/) et les erreurs à éviter dans [Bonnes pratiques et dépannage](https://www.ciklik.academy/fr/webhooks/bonnes-pratiques-et-depannage/).

**Outil de capture :**

Un service public de type webhook.site permet de voir à quoi ressemble un envoi en deux minutes, sans rien coder.

> Attention
>
> L’URL générée par ces outils est publique : toute personne qui la connaît peut lire les données de vos clients. N’utilisez cette méthode qu’avec un compte de test, jamais en production.

## Étape 2 : activer l’événement

1. Choisissez la clé de l’événement dans le catalogue.

2. Dans **Paramètres > Sites**, ouvrez votre site, cliquez sur **Modifier**, puis ouvrez l’onglet **Avancé**. Dans le champ **Webhooks**, ajoutez une ligne : la clé de l’événement à gauche, l’URL de réception à droite. Enregistrez. Vous pouvez aussi passer par l’[API](https://www.ciklik.academy/fr/webhooks/configurer-les-webhooks-par-lapi/).

3. L’activation devient effective en moins d’une minute.

> Recopiez la clé à l’identique
>
> Le champ **Webhooks** ne vérifie pas les clés. Une clé mal orthographiée (`created_subcription`, `Created_subscription`, espace en trop) est enregistrée sans erreur, mais aucun envoi ne part jamais. Copiez la clé depuis le catalogue. Par l’API, en revanche, une clé inconnue est refusée (erreur 422).
>
> N’ajoutez pas non plus `deleted_user` ni `deleted_optin` : ces clés ne sont pas prises en charge.

> Configuration et journal
>
> Le champ **Webhooks** de l’onglet **Avancé** liste toutes vos URL déclarées. Le menu **Paramètres > Avancé > Webhooks** n’est pas un écran de configuration : c’est le journal des envois. Deux règles à connaître :
>
> - une seule URL de réception par événement : une nouvelle URL remplace la précédente, sans avertissement ;
> - votre URL ne doit jamais rediriger, même d’HTTP vers HTTPS ou pour ajouter une barre oblique finale. Sur une redirection, le contenu de l’envoi est perdu.

## Étape 3 : déclencher un premier envoi

Faites ces tests sur un compte client de test, jamais sur un client réel.

| Ce que vous faites                                         | Événement                                                                                   | Délai                                                                               |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| Créer un compte client de test                             | `created_user`                                                                              | immédiat                                                                            |
| Créer une adresse pour ce compte                           | `created_address`                                                                           | immédiat                                                                            |
| Modifier l’adresse de ce compte de test                    | `updated_address`                                                                           | immédiat                                                                            |
| S’inscrire à la newsletter avec une adresse e-mail de test | `created_optin`                                                                             | environ 10 secondes                                                                 |
| Passer une commande                                        | `created_checkoutorder`, puis `created_checkouttransaction`, puis `created_checkoutinvoice` | environ 10 secondes pour la commande et la transaction, 15 secondes pour la facture |

Passer une commande exige un paiement réel : utilisez un coupon à 100 % si vous ne voulez pas débiter une carte.

> Un geste, plusieurs envois
>
> Modifier une adresse déclenche aussi un envoi par expédition récente et par commande en cours de création : c’est normal. Voir [Événements : clients, adresses et inscriptions](https://www.ciklik.academy/fr/webhooks/evenements-clients-adresses-optins/#updated_address).

## Lire ce que vous recevez

Voici le contenu réel de deux premiers envois, sur un compte de test.

```json
{
    "email": "claire.martin@example.com",
    "tenant_id": 1,
    "valid": true,
    "list_id": "9f2c4e7a1b",
    "changed": []
}
```

```json
{
    "id": 1,
    "email": "claire.martin@example.com",
    "uuid": "cus_Qx7hR3eaEowcv1DX",
    "refp": "https://boutique.example.com/formules?refp=CLAIRE2026",
    "has_active_subscription": false,
    "info": null,
    "changed": []
}
```

- Les champs sont à la racine : il n’y a pas d’enveloppe.
- `changed` est vide sur une création.
- Le nom de l’événement n’est pas dans le contenu : c’est l’URL de réception qui l’identifie.
- Le reste du contrat (types de champs, cas des modifications, formats de dates et de montants) est décrit dans [Comprendre un envoi de webhook](https://www.ciklik.academy/fr/webhooks/comprendre-un-envoi-de-webhook/).

## Si vous ne recevez rien

Vérifiez dans l’ordre :

1. votre URL répond bien à une requête POST envoyée depuis l’extérieur ;
2. elle ne redirige pas ;
3. elle n’exige ni mot de passe ni filtrage par adresse IP ;
4. son certificat est valide et émis par une autorité reconnue : un certificat auto-signé fait échouer l’envoi sans laisser de trace ;
5. moins de 60 secondes se sont écoulées depuis l’activation : la configuration est mise en cache une minute.

Si tout cela est en ordre et que rien n’arrive toujours, passez à [Bonnes pratiques et dépannage](https://www.ciklik.academy/fr/webhooks/bonnes-pratiques-et-depannage/).

## Voir aussi

[Comprendre un envoi de webhook](https://www.ciklik.academy/fr/webhooks/comprendre-un-envoi-de-webhook/)

[Bonnes pratiques et dépannage](https://www.ciklik.academy/fr/webhooks/bonnes-pratiques-et-depannage/)

[Configurer les webhooks par l'API](https://www.ciklik.academy/fr/webhooks/configurer-les-webhooks-par-lapi/)

[Webhooks](https://www.ciklik.academy/fr/webhooks/)