Zum Inhalt springen
Centrics Hilfe

Überblick

Ein Webhook schickt automatisch eine HTTP-Anfrage an ein anderes System, sobald in Centrics eine Aufgabe, ein Protokoll oder ein Kontakt angelegt, geändert oder gelöscht wird. So hältst Du zum Beispiel Deine Buchhaltung oder Dein CRM auf dem Stand von Centrics, ohne Daten doppelt zu pflegen. Du legst fest, an welche Adresse die Anfrage geht, bei welchen Ereignissen sie ausgelöst wird und wie ihr Inhalt aussieht.

Ressourcen und Ereignisse

Abschnitt betitelt „Ressourcen und Ereignisse“

Jeder Webhook gehört zu genau einer Ressource und reagiert auf eines oder mehrere Ereignisse:

Ressource Erstellt Aktualisiert Gelöscht
Aufgabe ✓ ✓ ✓
Protokoll ✓ ✓ ✓
Kontakt ✓ ✓ ✓

Ein paar Besonderheiten:

  • Entwürfe: Aufgaben und Protokolle, die noch nicht veröffentlicht sind, lösen keine Webhooks aus. Das Veröffentlichen zählt als „Erstellt“, das Zurücknehmen der Veröffentlichung als „Gelöscht“. Kontakte haben keine Entwürfe.
  • Wiederherstellen: Stellst Du einen gelöschten Datensatz wieder her, kommt das als „Erstellt“ an.
  • Filter: Du kannst einen Webhook auf bestimmte Teams und Typen einschränken. Wechselt ein Datensatz in den Filter hinein, erhält der Webhook ein „Erstellt“; verlässt er ihn, ein „Gelöscht“ – jeweils nur, wenn der Webhook dieses Ereignis abonniert hat. Kontakte gehören zu keinem Team, dort gibt es nur den Typ-Filter.

Wer Webhooks einrichten kann

Abschnitt betitelt „Wer Webhooks einrichten kann“

Webhooks verwaltest Du in Centrics unter Management im Tab Webhooks. Dafür brauchst Du die Rolle Manager.

Webhooks sind eine Funktion, die für Deinen Account freigeschaltet sein muss. Siehst Du den Tab Webhooks nicht, obwohl Du Manager bist, ist die Funktion für Deinen Account noch nicht aktiv. Die Freischaltung nimmt das Centrics-Team vor.

Grenzen

Abschnitt betitelt „Grenzen“

Es gelten diese Grenzen:

Was Grenze
Webhooks pro Account 5 (gelöschte zählen nicht)
Eigene Header pro Webhook 10
Größe der JSON-Vorlage 65.536 Byte (64 KiB)
Name des Webhooks 120 Zeichen
Länge der URL 2.048 Zeichen
Zeitlimit pro Anfrage 10 Sekunden (davon 5 Sekunden für den Verbindungsaufbau)
Aufbewahrung des Zustellprotokolls 30 Tage

Wie Centrics Änderungen bündelt, wann es erneut zustellt und wann ein Webhook automatisch abgeschaltet wird, liest Du unter Zustellung & Fehler.

Weiterlesen

Abschnitt betitelt „Weiterlesen“