Webhooks, Zapier et Make

Ce que vous obtenez

• Events: score.dropped, visibility.lost, visibility.gained, scan.completed, answers.updated, site.created, site.deleted.
• Une signature HMAC sur chaque requête, pour vérifier qu’elle vient bien de nous.
• De nouvelles tentatives automatiques après 5 minutes, 30 minutes, 2 heures, 6 heures et 24 heures.
• Un journal des envois sur la page Intégrations, qui montre ce qui a été envoyé et ce que votre endpoint a répondu.

Avant de commencer

• Un compte OLAB Assist avec l’offre Agency, connecté en tant que propriétaire du compte.
• Un compte Zapier, Make ou n8n, ou votre propre endpoint https.

Configurer étape par étape

1. 1

   Créer un webhook de réception

   Zapier : nouveau Zap → déclencheur Webhooks by Zapier → Catch Hook. Make : nouveau scénario → Webhooks → Custom webhook. n8n : un nœud Webhook avec la méthode POST. Copiez l’adresse fournie.

2. 2

   L’ajouter dans OLAB Assist

   Intégrations → Webhooks : collez l’adresse, réglez le format sur JSON, cochez les événements souhaités et cliquez sur Ajouter un webhook. Copiez le secret de signature, affiché une seule fois.

3. 3

   Envoyer un test

   Cliquez sur Envoyer un test. Votre outil reçoit un événement ping et apprend les champs.

4. 4

   Ajouter l’action

   Par exemple Asana → Create Task avec le titre « Baisse du score sur {{data.site.domain}} » et le lien du rapport issu de data.report_url. Ajoutez un filtre sur type si un même webhook reçoit plusieurs événements.

5. 5

   L’activer

   Publiez le Zap ou le scénario. Désormais, chaque événement correspondant le déclenche.

{
  "id": "evt_4Hh2…",
  "type": "score.dropped",
  "api_version": "v1",
  "created_at": "2026-10-05T10:00:00.000Z",
  "data": {
    "site": { "id": "k3Jd9x2Lq", "domain": "yourbrand.example", "app_url": "…" },
    "previous_score": 86, "score": 71,
    "drop_points": 15, "drop_pct": 17.4,
    "report_url": "https://olabassist.com/r/…"
  }
}

Tips

• Utilisez un webhook par destination. Chacun a ses propres événements, son seuil et son secret.
• Utilisez l’id de l’événement pour ignorer les doublons : un événement renvoyé garde son id.
• Développeurs : vérifiez OLAB-Signature comme indiqué dans la documentation développeurs.

Troubleshooting

Questions