Aller au contenu
Toutes les intégrations

Webhooks

Un appel HTTP signé vers votre serveur à chaque événement : feedback, note basse, témoignage, contact, invitation, lien cassé.

Chaque webhook reçoit une requête POST JSON avec les champs id, event, occurred_at, account_id et data avec les en-têtes X-Repotz-Event, X-Repotz-Delivery et une signature X-Repotz-Signature (HMAC-SHA256 de « horodatage.corps » avec votre secret). En cas d'échec, RepOtz réessaie après 1 min, 5 min, 30 min, 2 h et 12 h ; le journal des 30 derniers jours se consulte et se rejoue depuis le tableau de bord. Après 20 échecs consécutifs, le webhook est mis en pause et vous êtes prévenu.

Comment ça marche

  1. 1

    Tableau de bord > Intégrations > Nouveau webhook : votre URL https et les événements.

  2. 2

    Copiez le secret affiché une seule fois et vérifiez la signature côté serveur.

  3. 3

    Envoyez un ping pour valider, puis consultez le journal des livraisons.

Ce que vous en faites

  • Prévenir votre propre système de billetterie d'une note basse.
  • Alimenter votre entrepôt de données sans interroger l'API.
  • Faire réagir un agent IA maison à chaque feedback.

Questions fréquentes

Comment vérifier la signature ?

Recalculez HMAC-SHA256(horodatage + '.' + corps brut) avec votre secret et comparez à la valeur v1 de l'en-tête ; refusez un horodatage de plus de cinq minutes.

Que se passe-t-il si mon serveur est en panne ?

Cinq tentatives étalées sur quinze heures, puis la livraison est marquée en échec ; vous la rejouez en un clic une fois le serveur revenu.

API et webhooks sont inclus dès le plan Pro. Les scopes analytics, témoignages et audits demandent le plan Agency.

Voyez d'abord où en est votre réputation

L'audit gratuit note votre présence en ligne en une minute ; l'essai de 14 jours ouvre l'API et les webhooks.