Zum Hauptinhalt springen
Workexe

Webhook-Integrationen

Workexe-Events an Slack, Jira, Zapier, Make, n8n oder eigene Endpoints senden. Lieferungen per HMAC prüfen, fehlgeschlagene Payloads replayen, Webhooks pro Projekt scopen.

3. September 20252 Min.

Webhook-Integrationen

Ausgehend vs eingehend

Ausgehende Webhooks pushen Workexe-Events bei Änderungen (Rank-Drop, Audit fertig, Report exportiert). Eingehende Webhooks lassen externe Tools per signiertem POST Workexe-Aktionen auslösen.

  • Ausgehend: Workexe → Ihre URL (häufigste Variante)
  • Eingehend: Ihr Tool → Workexe API
  • Beide: JSON mit Schema v1
  • Pro Projekt, keine Datenüberschneidung

Event-Typen

Alle Events oder Teilmenge. Payload: Projekt-ID, Event-Name, ISO-Zeitstempel, normalisiertes Datenobjekt.

  • keyword.position_changed
  • backlink.new_or_lost
  • site_audit.crawl_completed
  • report.export_ready
  • task.created
  • workflow.run_failed
  • integration.connected

Setup in 3 Schritten

Ab Pro und Agency. Native Connectors ohne Code, Raw-URL für Custom-Stacks.

  • Settings → Integrationen → Webhooks → Endpoint hinzufügen
  • URL, Events, Signing Secret kopieren
  • Test-Event senden, 2xx im Delivery-Log prüfen
  • Live aktivieren nach erfolgreichem Test

Sicherheit

Jede Lieferung: X-Workexe-Signature (HMAC-SHA256). Requests älter als 5 Minuten ablehnen.

  • Secret-Rotation ohne Downtime (24h Overlap)
  • IP-Allowlist optional (Enterprise)
  • TLS 1.2+ auf Ziel-URLs
  • Secrets nach Erstellung nicht erneut abrufbar

Retries und Logs

Fehlgeschlagene Lieferungen werden automatisch wiederholt. Request/Response 90 Tage gespeichert.

  • 3 Retries: 1min, 5min, 30min
  • Delivery-Log mit Status, Latenz, Code
  • Manuelles Replay per Klick
  • E-Mail-Alert nach 10 Fehlern in 1h

Native Connectors

UI statt Raw-URL? Built-in Connectors nutzen dieselbe Webhook-Engine.

  • Slack mit Rich Blocks
  • Jira Issues mit Labels
  • Zapier / Make / n8n offizielle Apps
  • Google Sheets Zeilen anhängen
webhook-integrationen Einrichtung
  1. 1
    Projekt öffnen

    Modul webhook-integrationen im Projekt-Panel starten.

  2. 2
    Quellen verbinden

    GSC, GA4 und CSV-Importe hinzufügen.

  3. 3
    Scope setzen

    Standort, Sprache, Gerät und Schwellenwerte wählen.

  4. 4
    Validieren

    Ersten Scan mit bekannter Seite/Query prüfen.

Häufig gestellte Fragen