Webhooks

Verwenden Sie SEO Boost Hub Webhooks, um ereignisbasierte Benachrichtigungen nahezu in Echtzeit in Ihren Systemen zu empfangen.

Einrichtung

Konfigurieren Sie Webhook-Endpunkte in Ihrem Dashboard:

Navigieren Sie zu Einstellungen → Webhooks Klicken Sie auf Endpunkt hinzufügen, geben Sie Ihre URL ein und wählen Sie die Ereignisse aus, die Sie empfangen möchten.

Verfügbare Ereignisse

Die folgenden Ereignisse lösen Webhook-Benachrichtigungen aus:

Ereignis	Beschreibung
`location.updated`	Die Details eines Standorts wurden geändert
`rank.scanned`	Ein täglicher Ranking-Scan für ein Keyword wurde abgeschlossen
`content.published`	Ein Inhaltsbeitrag wurde im Google Business Profile veröffentlicht
`review.received`	Eine neue Google-Bewertung wurde empfangen
`health.calculated`	Der Business-Health-Score wurde neu berechnet

Payload-Format

Alle Webhook-Payloads folgen einer konsistenten JSON-Struktur:

{
  "id": "evt_01hx9c3f7a",
  "event": "rank.scanned",
  "timestamp": "2025-11-28T08:15:00Z",
  "data": {
    "keyword_id": "kw_01hx8b2e4d",
    "keyword": "best coffee shop berlin",
    "location_id": "loc_01hx7a9b2c",
    "previous_rank": 8,
    "current_rank": 5,
    "search_engine": "google",
    "scanned_at": "2025-11-28T08:14:55Z"
  }
}

Signaturverifizierung

Jede Webhook-Anfrage enthält einen X-Signature-Header mit einem HMAC-SHA256-Hash des Payloads. Überprüfen Sie diese Signatur, um sicherzustellen, dass die Anfrage authentisch ist:

Signatur-Header

X-Signature: sha256=a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2

Verifizierungsbeispiel (PHP)

$payload = file_get_contents('php://input');
$signature = hash_hmac('sha256', $payload, $webhookSecret);
$header = $_SERVER['HTTP_X_SIGNATURE'] ?? '';

if (hash_equals("sha256={$signature}", $header)) {
    // Signature is valid — process the event
} else {
    // Invalid signature — reject the request
    http_response_code(401);
}

Wiederholungsrichtlinie

Wenn Ihr Endpunkt einen Nicht-2xx-Statuscode zurückgibt, wird der Webhook mit exponentiellem Backoff erneut versucht:

Versuch	Verzögerung
1. Versuch	Sofort
2. Versuch	5 Minuten
3. Versuch	30 Minuten

Hinweis Nach 3 fehlgeschlagenen Versuchen wird der Webhook als fehlgeschlagen markiert. Fehlgeschlagene Zustellungen können unter Einstellungen → Webhooks eingesehen werden.