Aller au contenu principal
Was this helpful?

Échecs de webhook

Les règles d'automatisation PrimeCal peuvent être déclenchées par des webhooks entrants — un service externe envoie un payload JSON en POST vers une URL unique, et l'automatisation s'exécute. Cette page couvre ce qu'il faut vérifier quand un webhook ne se déclenche pas comme prévu.

Comprendre l'URL du webhook​

Chaque règle d'automatisation avec un déclencheur webhook.incoming possède sa propre URL unique :

POST https://app.primecal.eu/api/automation/webhooks/{token}/receive

Le {token} est spécifique à cette règle. Tu peux le trouver dans Automatisation → [Ta règle] → Webhook.

Le webhook ne se déclenche pas​

Étape 1 : Vérifie que l'URL est correcte.

Copie l'URL du webhook depuis la section Webhook de la règle dans PrimeCal et confirme qu'elle correspond à ce que tu envoies. Les tokens sont de longues chaînes aléatoires — une seule différence de caractère signifie que le webhook ne correspondra à aucune règle.

Étape 2 : Confirme que la requête atteint PrimeCal.

Vérifie si ton service externe (Slack, Zapier, ton propre service, etc.) envoie bien la requête HTTP :

  • Consulte les journaux de webhooks sortants de ton service
  • Confirme que la requête reçoit un code de statut 2xx de PrimeCal

Un 404 signifie que le token est incorrect. Un 400 signifie que le format du payload est incorrect. Un 200 signifie que PrimeCal l'a bien reçu.

Étape 3 : Vérifie les conditions de la règle d'automatisation.

Les webhooks ne déclenchent la règle que si ses conditions sont satisfaites. Si ton automatisation a des conditions comme webhook.data.status equals "completed", la règle ne se déclenchera pas si le payload entrant a une valeur différente.

Rends-toi dans Automatisation → [Ta règle] → Journal d'audit pour voir si le webhook a été reçu et pourquoi il s'est ou ne s'est pas déclenché.

Le journal d'audit affiche « Reçu mais conditions non satisfaites »​

C'est le cas le plus fréquent. Le webhook est bien arrivé à PrimeCal, mais les conditions de la règle ne correspondaient pas au payload.

Vérifie tes valeurs de condition :

  • webhook.data.status accède à data.status dans le corps JSON
  • La comparaison est sensible à la casse pour l'opérateur equals
  • Utilise contains plutôt que equals si tu veux des correspondances partielles

Exemple de payload :

POST /api/automation/webhooks/abc123.../receive
{
  "event": "order.completed",
  "data": {
    "status": "completed",
    "customer_id": "cust_456"
  }
}

Pour ce payload, le chemin de champ webhook.data.status donnerait "completed".

L'URL du webhook retourne 401 ou 403​

Les URL de webhook sont publiques et ne nécessitent pas d'authentification — elles utilisent le token lui-même comme mécanisme d'autorisation. Si tu obtiens un 401 ou 403 :

  • Confirme que tu n'envoies pas accidentellement un en-tête Authorization qui entre en conflit
  • Confirme que l'URL du webhook n'a pas été regénérée — si le token a été regénéré, l'ancienne URL n'est plus valide

Pour regénérer un token (ce qui invalide également l'ancienne URL) : va dans les détails de la règle → onglet Webhook → Regénérer le token. Mets à jour l'URL dans ton service externe après cette opération.

Le webhook retourne 200 mais rien ne se passe​

Si le journal d'audit indique que le webhook a été reçu avec les conditions satisfaites, mais que l'action ne s'est pas exécutée :

  1. Vérifie la configuration de l'action — pour set_event_color, un événement doit exister dans le contexte de calendrier correspondant
  2. Vérifie que la règle est activée (non mise en pause)
  3. Note la limite de débit : les règles d'automatisation ont un délai de 1 minute entre les exécutions pour éviter les boucles incontrôlées. Si un second webhook arrive dans la minute qui suit le premier, il peut être ignoré

Tester un webhook manuellement​

Tu peux tester ton webhook avec curl ou n'importe quel client HTTP :

curl -X POST https://app.primecal.eu/api/automation/webhooks/YOUR_TOKEN_HERE/receive \
  -H "Content-Type: application/json" \
  -d '{"event": "test", "data": {"status": "completed"}}'

Consulte ensuite le journal d'audit de la règle d'automatisation pour voir si le webhook a été reçu et traité.

Toujours bloqué ?​

  • Consulte d'abord le journal d'audit — il affiche chaque réception de webhook et la raison pour laquelle il s'est ou ne s'est pas déclenché
  • Pour les conditions et les chemins de champs : Valeurs intelligentes des webhooks
  • Contacte le support : Support Contact