# Workspace-Events

> Definieren Sie Workspace-Events und den Typ jeder Eigenschaft, damit alle Systeme, die sie senden, einheitlich bleiben. Behandelt Eigenschaftstypen, Validierung und das Ändern einer Definition.

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](/de/docs/events/#three-scopes-of-events) (`c:<name>`). Workspace-Events und eigene Events sind in den Tarifen Pro, Business und Custom enthalten.

## Workspace-Event definieren

**Weboberfläche**

  1. **Workspace-Events öffnen.** Öffnen Sie **Email API → Events**, wählen Sie den Tab **Workspace events** und dann **Define workspace event**.

  2. **Event benennen.** Geben Sie unter **Name** einen Namen wie `customer.type` ein. Gesendet wird das Event als `w:customer.type`. Fügen Sie bei Bedarf einen **Title** hinzu, der in Zeitleisten und Auswahllisten erscheint, und eine **Description** für Ihr Team.

  3. **Eigenschaften hinzufügen.** Wählen Sie **Add property** für jeden Wert, den sendende Systeme angeben müssen oder dürfen. Geben Sie ihm einen Namen, wählen Sie seinen **Type** und aktivieren Sie **Required**, wenn jedes Event ihn enthalten muss. Titel und Beschreibung sind optional.

  4. **Event erstellen.** Wählen Sie **Create**. Zum Prüfen wählen Sie bei der Definition **Send test**: Das öffnet **Send event** mit dem bereits ausgewählten Event.

**API**

  Rufen Sie [Workspace-Event erstellen](/de/docs/api-reference/workspace-events/create/) mit einem API-Schlüssel mit **Full Access** auf:

```bash
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:

```bash
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

| Typ | Akzeptiert | Gespeichert als |
| --- | --- | --- |
| `string` | Einen JSON-String mit bis zu 2.000 Zeichen. | Der String |
| `number` | Eine JSON-Zahl. Zahlen in Anführungszeichen wie `"42"` werden abgelehnt. | Die Zahl |
| `date` | Ein Datum nach ISO 8601 (`2026-10-01`), ein Datum mit Uhrzeit (`2026-10-01T12:00:00Z`) oder einen Zeitstempel in Millisekunden. Jahre vor 1900 werden abgelehnt. | Ein Datum mit Uhrzeit nach ISO 8601 in UTC |
| `boolean` | `true` oder `false`. | Der Boolean |

## 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](/de/docs/events/tracking-script/#debug) 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](/de/docs/api-reference/workspace-events/update/) und [Workspace-Event löschen](/de/docs/api-reference/workspace-events/delete/).

- 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](/de/docs/events/#limits) 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

  - [Event-Tracking](/de/docs/events/): Scopes, Namen und wohin Events gelangen.
  - [API für Workspace-Events](/de/docs/api-reference/workspace-events/): Definitionen erstellen, auflisten, aktualisieren und löschen.

---
Quelle: https://emailit.com/de/docs/events/workspace-events/