Platzhalter

Mit Platzhaltern setzt Du Werte aus dem auslösenden Datensatz in die URL und – im Format Benutzerdefiniert – in den Inhalt eines Webhooks ein.

Syntax

Ein Platzhalter steht in doppelten geschweiften Klammern. Leerzeichen innerhalb der Klammern sind erlaubt, {{ contact.name }} und {{contact.name}} sind gleichwertig.

{{ contact.name }}
{{ task.team.name }}
{{ contact.addresses[0].city }}
{{ changes.task.title.new }}

Der Pfad beginnt mit einem Bereich wie task, protocol, contact, event, actor, account, resource oder changes.
Weitere Stufen trennst Du mit Punkten. Ab der zweiten Stufe sind auch Bindestriche erlaubt – wichtig für Kontaktdetails (siehe unten).
Einzelne Einträge einer Liste erreichst Du mit [0], [1] usw.

Die Variablenliste im Editor

Im Format Benutzerdefiniert zeigt der Editor neben der Vorlage alle Variablen, die für die gewählte Ressource verfügbar sind, gruppiert nach Ressource, Details, Ereignis, Auslöser, Account und Änderungen. Klicke auf eine Variable oder zieh sie in den Editor. Über Variable suchen findest Du eine Variable schnell.

Häufig gebrauchte Variablen:

Variable	Inhalt
`{{ event.type }}`	`created`, `updated` oder `deleted`
`{{ event.occurred_at }}`	Zeitpunkt des Ereignisses
`{{ actor.name }}`	Wer die Änderung ausgelöst hat
`{{ account.name }}`	Name Deines Accounts
`{{ resource.url }}`	Link zum Datensatz in Centrics; kann leer sein
`{{ changes }}`	Geänderte Felder (nur bei „Aktualisiert“)

resource.url kann leer sein. In einer URL führt das zu einem Vorlagenfehler (siehe unten). Im Inhalt wird der Wert null, bzw. in einem längeren Text eine leere Zeichenfolge.

Den alten und neuen Wert eines geänderten Felds erreichst Du über changes.<Feld>.old und changes.<Feld>.new, z. B. {{ changes.task.title.old }}.

Kontaktdetails

Die Felder, die Du für Kontaktdetails selbst angelegt hast, erscheinen in der Gruppe Details mit ihrem Namen. Im Platzhalter werden sie über die ID des Formularfelds angesprochen, die wie eine UUID aussieht:

{{ contact.details.3f2a9c1e-7b4d-4e8a-9f10-2c5b6d7e8f90 }}

Die ID musst Du nicht abtippen: Ein Klick auf das Feld in der Variablenliste fügt den richtigen Platzhalter ein.

Externe Referenzen

Unter external_refs stehen die IDs, unter denen ein Datensatz in verknüpften Systemen bekannt ist – für Aufgaben, Protokolle und Kontakte:

{{ contact.external_refs.sevdesk }}
{{ task.external_refs.hubspot_crm }}

Für jede Referenz Deines Accounts gibt es eine solche Variable: die eingebaute Referenz sevdesk und alle Referenzen, die Du selbst angelegt hast. Gefüllt werden sie durch eine Verknüpfung, bei sevdesk auch durch den Kontakt-Import.

Platzhalter im Inhalt

Im Format Benutzerdefiniert darfst Du Platzhalter in jedem Text-Wert des JSON verwenden.

Steht der Platzhalter allein in einem Wert, behält er seinen Typ: Zahlen bleiben Zahlen, true/false bleiben Wahrheitswerte, Listen und Objekte werden als JSON eingesetzt, ein Feld ohne Wert bleibt null.
Steht er zusammen mit anderem Text, wird der Wert als Text eingesetzt. Ein Feld ohne Wert wird dabei zu einem leeren Text.

{
  "id": "{{ contact.id }}",
  "public": "{{ contact.public }}",
  "addresses": "{{ contact.addresses }}",
  "label": "Kontakt {{ contact.number }}: {{ contact.name }}"
}

Hier wird public zu true oder false, addresses zu einer Liste und label zu einem Text.

Beim Speichern prüft Centrics, ob alle Variablen bekannt sind. Fällt eine Variable später weg – etwa weil Du ein Kontaktdetail-Feld gelöscht hast –, wird sie als null gesendet. Die Zustellung läuft trotzdem und vermerkt im Protokoll eine Warnung.

Platzhalter in der URL

In der URL gelten strengere Regeln:

Platzhalter sind nur in Pfad und Query erlaubt. Schema und Host sind fest, z. B. https://erp.example.com. So kann kein Wert aus einem Datensatz eine Anfrage an einen anderen Server umleiten.
Werte werden URL-kodiert eingesetzt. Ein /, ? oder # im Wert verändert die URL also nicht, sondern wird als %2F, %3F bzw. %23 gesendet.
Ein Platzhalter in der URL muss einen einzelnen Wert ergeben, keine Liste und kein Objekt.

https://erp.example.com/contacts/{{ contact.id }}?name={{ contact.name }}