Webhooks

Webhooks sind HTTP-POST-Benachrichtigungen, die Replix an deine eigenen Endpunkte sendet, wenn bestimmte Ereignisse eintreten. So kannst du externe Systeme, Dashboards oder Automatisierungen in Echtzeit anbinden. Verfügbar im Agentur-Plan.

Drei Events stehen zur Verfügung: 1) new_review — ausgelöst, wenn eine neue Google-Bewertung erkannt wird. 2) new_reply — ausgelöst, wenn eine Antwort auf Google gepostet wird. 3) negative_review — ausgelöst bei Bewertungen mit 1–2 Sternen. Die Events werden während des täglichen Bewertungs-Syncs ausgelöst.

Gehe zu Einstellungen → Webhooks → 'Webhook erstellen'. Gib die Ziel-URL (HTTPS) ein und wähle das Event. Pro Konto kannst du max. 3 Webhooks registrieren. Die URL wird auf SSRF-Sicherheit geprüft — localhost, private IP-Adressen und IPv6-Loopback sind nicht erlaubt. MFA ist für die Erstellung erforderlich.

Der Webhook sendet einen HTTP-POST-Request mit JSON-Body an deine URL. Der Payload enthält: event (der Event-Name), timestamp (ISO 8601), data (die Event-Daten wie Bewertungstext, Sternebewertung, Autor, Antworttext etc.). Beispiel:

{ "event": "new_review", "timestamp": "2025-01-15T10:30:00Z", "data": { "review_id": "...", "author": "Max M.", "rating": 4, "text": "Tolles Erlebnis!", "location": "Mein Restaurant" } }

Replix implementiert SSRF-Schutz: Webhook-URLs werden gegen eine Blockliste geprüft. Blockiert werden: localhost und 127.0.0.1, private IP-Bereiche (10.x, 172.16-31.x, 192.168.x), IPv6-Loopback (::1), und nicht-HTTPS-URLs. Nur Domains, die auf hooks.slack.com, discord.com oder discordapp.com verweisen, sind als Slack/Discord-Integrationen erlaubt. Für alle anderen werden nur öffentliche HTTPS-URLs akzeptiert.

Wenn dein Endpunkt nicht antwortet oder einen Fehler-Statuscode zurückgibt, wird der Webhook-Aufruf ggf. beim nächsten Sync wiederholt, wenn ein neues Event ausgelöst wird. Es gibt derzeit kein automatisches Retry-System mit Backoff. Stelle sicher, dass dein Endpunkt zuverlässig erreichbar ist.