Skip to content
All integrations

Webhooks

A signed HTTP call to your server on every event: feedback, low rating, testimonial, contact, invitation, broken link.

Each webhook receives a JSON POST with the fields id, event, occurred_at, account_id and data with the headers X-Repotz-Event, X-Repotz-Delivery and a signature X-Repotz-Signature (HMAC-SHA256 of "timestamp.body" with your secret). On failure, RepOtz retries after 1 min, 5 min, 30 min, 2 h and 12 h; the journal of the last 30 days can be read and replayed from the dashboard. After 20 consecutive failures the webhook is paused and you are warned.

How it works

  1. 1

    Dashboard > Integrations > New webhook: your https URL and the events.

  2. 2

    Copy the secret shown once and verify the signature on your server.

  3. 3

    Send a ping to validate, then read the delivery journal.

What you do with it

  • Warn your own ticketing system of a low rating.
  • Feed your data warehouse without polling the API.
  • Have a home-made AI agent react to every feedback.

Frequently asked questions

How do I verify the signature?

Recompute HMAC-SHA256(timestamp + '.' + raw body) with your secret and compare to the v1 value of the header; reject a timestamp older than five minutes.

What if my server is down?

Five attempts spread over fifteen hours, then the delivery is marked failed; replay it in one click once the server is back.

API and webhooks are included from the Pro plan. The analytics, testimonials and audits scopes require the Agency plan.

See where your reputation stands first

The free audit scores your online presence in a minute; the 14-day trial opens the API and the webhooks.