Anleitung · Für Entwickler

Eigener Webhook: n8n, Make, Zapier und eigene Systeme

VISIWING schickt Ereignisse als JSON an deine Adresse. Mit Signatur, damit du prüfen kannst, dass sie wirklich von VISIWING kommen.

Fürn8n, Make, Zapier und eigene Systeme

Voraussetzungen

  • Eine https-Adresse, die POST-Anfragen annimmt.
  • Ein VISIWING-Konto.

So geht es

  1. Empfangsadresse anlegen

    • n8n: Knoten Webhook, Methode POST.
    • Make: Modul Webhooks, Custom webhook.
    • Zapier: Webhooks by Zapier, Catch Hook.
    • Eigene Systeme: eine öffentliche https-Adresse. Adressen im internen Netz nimmt VISIWING nicht an.

  2. In VISIWING eintragen

    Unter Schnittstellen, Benachrichtigungen die Art Eigener Webhook wählen, die Adresse einfügen, die Ereignisse wählen und anlegen. Das Geheimnis für die Signatur erscheint nur einmal: kopieren und sicher ablegen.

  3. Signatur prüfen

    Jede Nachricht trägt die Kopfzeilen X-Visiwing-Ereignis, X-Visiwing-Zustellung, X-Visiwing-Zeit und X-Visiwing-Signatur. Nachrichten mit einer Zeit älter als fünf Minuten verwerfen.

    import hashlib, hmac

def echt(geheimnis: str, zeit: str, rohtext: bytes, signatur: str) -> bool:
    erwartet = "sha256=" + hmac.new(geheimnis.encode(), zeit.encode() + b"." + rohtext, hashlib.sha256).hexdigest()
    return hmac.compare_digest(erwartet, signatur)

  4. Test senden

    Test senden schickt ein Ereignis signal.neu mit der erfundenen Firma Muster Mobility.

Ereignis messung.fertig

Beispiel mit der erfundenen Firma Muster Mobility

{
  "ereignis": "messung.fertig",
  "zeit": "2026-10-16T10:15:00+00:00",
  "daten": {
    "domain": "muster-mobility.de",
    "name": "Muster Mobility",
    "score": 61,
    "status": "Genannt",
    "genannt": 22,
    "antworten": 48,
    "vergleich": { "vorher": 57, "jetzt": 61, "differenz": 4, "schwankung": 4.0, "ueber_schwankung": false },
    "report": "https://…/?job=…"
  }
}

Ereignis signal.neu

Beispiel mit der erfundenen Firma Muster Mobility

{
  "ereignis": "signal.neu",
  "zeit": "2026-10-16T10:15:05+00:00",
  "daten": {
    "domain": "muster-mobility.de",
    "name": "Muster Mobility",
    "signale": [
      { "titel": "Muster Mobility steigt auf Platz 3", "prioritaet": "hoch", "begruendung": "…" }
    ],
    "link": "https://…/?view=signale"
  }
}

Gut zu wissen

  • Antworte mit HTTP 2xx. Bei Fehlern versucht VISIWING es nach 30 Sekunden und nach 2 Minuten erneut. Lehnt deine Adresse mit 4xx ab, gibt es keinen weiteren Versuch.
  • Für die andere Richtung, also Score holen oder Messung starten, nimmst du die API.

Trennen und Datenschutz

In VISIWING das Ziel löschen. Ein neues Ziel bekommt ein neues Geheimnis.

VISIWING sieht nur, was der Assistent oder dein System abfragt, nie deinen Chatverlauf. Schlüssel und Zugänge speichern wir nur als Prüfwert.