Workspace-Events

Ein Workspace-Event ist ein Event, das Ihr Workspace festlegt, bevor es jemand sendet: Name, optionaler Titel und die Eigenschaften, die es enthält, jede mit einem Typ. Events dieses Typs werden als w:<name> gesendet, und Emailit lehnt die ab, die nicht dazu passen. Diese Seite erklärt, wie Sie sie definieren und wie die Validierung funktioniert.

Wenn Sie keine Struktur festlegen möchten, senden Sie stattdessen ein eigenes Event (c:<name>). Workspace-Events und eigene Events sind in den Tarifen Pro, Business und Custom enthalten.

Workspace-Event definieren

curl -X POST https://api.emailit.com/v2/workspace/events \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "customer.type",
    "title": "Customer type",
    "properties": [
      { "name": "segment", "type": "string", "required": true },
      { "name": "since", "type": "date" }
    ]
  }'

Senden Sie es dann wie jedes andere Event, mit dem Tracking-Skript oder per API:

curl -X POST https://api.emailit.com/v2/events \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "w:customer.type", "email": "jane@example.com", "properties": { "segment": "b2b", "since": "2026-10-01" } }'

Eigenschaftstypen

Wie Events geprüft werden

Wenn ein w:-Event eintrifft, vergleicht Emailit seine properties mit der Definition:

• Jede Eigenschaft muss in der Definition stehen. Unbekannte Eigenschaften werden abgelehnt, damit ein Tippfehler nicht unbemerkt bleibt.
• Erforderliche Eigenschaften müssen vorhanden und dürfen nicht null sein.
• Eine optionale Eigenschaft kann weggelassen oder als null gesendet werden, um anzugeben, dass sie leer ist.
• Jeder Wert muss zu seinem Typ passen.

Ein w:-Event, dessen Name nicht definiert ist, wird ebenfalls abgelehnt. Die API antwortet mit 422 und führt jedes Problem unter seinem Pfad auf, etwa properties.since. Das Tracking-Skript verwirft ungültige Events und protokolliert bei aktiviertem Debug-Modus den Grund.

Definition ändern oder löschen

Wählen Sie im Tab Workspace events bei einer Definition Edit oder Delete. Per API verwenden Sie Workspace-Event aktualisieren und Workspace-Event löschen.

• Eine Definition prüft nur neue Events. Bereits gespeicherte Events behalten ihre bisherigen Eigenschaften.
• Wenn Sie die Eigenschaften ändern, wird die gesamte Liste ersetzt. Systeme, die eine entfernte Eigenschaft weiterhin senden, erhalten Fehler. Aktualisieren Sie sie daher vorher oder gleichzeitig.
• Eine Umbenennung ändert den Typ, der gesendet wird. Gespeicherte Events behalten den alten Typ, und neue Events mit dem alten Namen werden abgelehnt.
• Beim Löschen bleiben die gespeicherten Events erhalten, und neue Events dieses Typs werden abgelehnt, bis Sie ihn erneut definieren.

Limits

Ein Workspace kann so viele Workspace-Events definieren, wie sein Tarif Event-Typen umfasst: 100 bei Pro und 1.000 bei Business, ohne Limit bei Custom. Ein weiteres gibt 422 mit code workspace_events_limit zurück. Jedes Workspace-Event hat bis zu 50 Eigenschaften. Namen haben bis zu 100 Zeichen, Eigenschaftsnamen bis zu 64, Titel bis zu 120 und Beschreibungen bis zu 1.000.

Siehe auch