Skip to Content
FeaturesIntegrationen

Integrationen Geplant (v1.1)

Lass Visz relevante Ereignisse aus deinem Workspace direkt in die Tools pushen, in denen dein Team ohnehin arbeitet — als Slack-Nachricht oder signierten Webhook an deine eigenen Systeme.

Wo im Dashboard

Einstellungen → Integrationen — hier verbindest du Slack, hinterlegst ausgehende Webhook-Endpoints und wählst je Ziel aus, welche Ereignisse es empfangen soll.

Kernkonzept

Integrationen sind ausgehend: Wenn im Workspace etwas Nennenswertes passiert, stellt Visz eine einzelne Notification an jedes verbundene Ziel zu. Zwei Kanäle sind gebaut, weitere Sync-Integrationen folgen mit v1.1.

  • Slack — verbinde einen Incoming-Webhook und wähle über eine Alert-Liste, welche Ereignis-Typen in deinen Channel gepostet werden. Jede Nachricht trägt ein Deep-Link-Button zurück in die App.
  • Signierter Webhook — ein generischer POST an eine URL deiner Wahl, pro Endpoint gefiltert nach Ereignis-Typen. Jede Ziel-URL wird SSRF-geprüft (interne/private Adressen werden blockiert), und jeder Request ist HMAC-signiert.
  • Shopify — eine OAuth-App: nach dem Verbinden aktivierst du Visz mit einem Klick als App-Embed im Theme-Editor — kein Code, kein manuelles Einfügen.

Zustellungen sind datenminimiert: Der Payload enthält nur pseudonyme IDs, Typ, Severity und einen bereits maskierten title — nie einen Ereignis-Body oder rohe PII. Fehlgeschlagene Zustellungen werden mit Backoff wiederholt und jeder Versuch protokolliert.

Signierte Webhooks

Jeder ausgehende Webhook trägt einen X-Visz-Signature-Header — Stripe-artig, inklusive Timestamp gegen Replay:

X-Visz-Signature: t=1781804392,v1=<hex>

Der v1-Wert ist HMAC-SHA256(secret, "<t>.<rawBody>"); verifiziere ihn, bevor du dem Payload vertraust. Der JSON-Body hat ein stabiles, minimales Schema — event, notification_id, severity, site_id, subject, title, occurred_at — wobei event einer der Typen frustration_spike, error_spike, blocked_purchase, conversion_drop, mention, assignment, weekly_summary oder status_alert ist.

Verwandt

Zuletzt aktualisiert:

Zuletzt aktualisiert am