Webhooks

Webhooks machen TeamVis zur Quelle der Wahrheit für Personen-/ Karten-Daten und lassen andere Systeme automatisch reagieren — ohne dass du sie selbst pollen musst.

Events

Acht Event-Typen sind aktuell verdrahtet:

Event	Wann
`employee.created`	neue Karte angelegt
`employee.updated`	Karte gespeichert (mit `changed_fields`)
`employee.deleted`	Karte gelöscht
`employee.activated`	Karte sichtbar geschaltet
`employee.deactivated`	Karte ausgeblendet
`lead.created`	jemand füllt das Lead-Formular auf einer Karte aus
`position.created`	neue Stelle im Organigramm
`position.updated`	Stelle bearbeitet

Payload-Format

{
  "event": "employee.updated",
  "occurred_at": "2026-05-06T11:42:30.123Z",
  "data": {
    "id": "uuid-…",
    "slug": "erika-mustermann",
    "changed_fields": ["phone_mobile", "linkedin_url"]
  }
}

Header:

Content-Type: application/json
X-TeamVis-Event: employee.updated
X-TeamVis-Signature: sha256=<hex>

Die Signatur ist ein HMAC-SHA256 über den Body, mit dem Secret aus der Subscription als Schlüssel. Der Empfänger validiert das, um sicherzustellen, dass die Anfrage tatsächlich von TeamVis stammt.

Subscription anlegen

Konfiguration → Webhooks → Anlegen:

Name (z.B. „Teams-Nachricht bei neuer Karte”)
URL des Empfängers
Events: ein oder mehrere aus der Liste oben
Secret: zufällige 32+ Zeichen — TeamVis generiert einen Vorschlag

Use-Cases

Microsoft Power Automate

Da Stadtwerke meist M365-Lizenzen haben, ist Power Automate der einfachste Weg:

Neuer Flow → Trigger „Wenn eine HTTP-Anfrage empfangen wird”
Trigger-URL kopieren → in TeamVis als Webhook-URL eintragen
Im Flow: Body parsen, Aktionen ausführen (Teams-Nachricht, SharePoint-Update, …)

Telefonanlage syncen

Webhook-Empfänger ist ein kleiner Service, der bei employee.updated die Telefonbuch-API der Anlage (3CX, Auerswald, OpenScape) aktualisiert.

Slack/Teams-Notification

Empfänger ist eine Webhook-URL des Channels. Nach employee.created schickt TeamVis das Payload, ein Bot formatiert es als Card-Nachricht.

Backup / Audit-Spiegel

employee.* und position.* an ein zweites Log-System spiegeln — für Compliance-Auditoren, die die Original-Quelle nicht direkt sehen sollen.

Auslieferungs-Log

Konfiguration → Webhooks → Subscription öffnen zeigt die letzten Auslieferungsversuche mit Status-Code, Response-Body, Fehler. Praktisch für Debugging.

Limits

10 Sekunden Timeout pro Auslieferung — langsame Empfänger fallen raus
Kein Auto-Retry bei 5xx — Retry baut der Empfänger selbst (z.B. Power Automate „bei Fehler erneut versuchen”)
Fire-and-forget: blockiert nicht das Speichern in TeamVis
Bei einem inaktiven Webhook wird nichts ausgeliefert