# Événements d’espace de travail

> Définissez des événements d’espace de travail et le type de chaque propriété, pour que tous les systèmes qui les envoient restent cohérents. Types de propriétés, validation et modification d’une définition.

Un événement d’espace de travail est un événement que votre espace de travail déclare avant que quiconque l’envoie : son nom, un titre facultatif et les propriétés qu’il contient, chacune avec un type. Les événements de ce type sont envoyés sous la forme `w:<name>`, et Emailit rejette ceux qui ne correspondent pas. Cette page explique comment les définir et comment fonctionne la validation.

Si vous ne voulez pas déclarer de structure, envoyez plutôt un [événement personnalisé](/fr/docs/events/#three-scopes-of-events) (`c:<name>`). Les événements d’espace de travail et les événements personnalisés sont inclus dans les forfaits Pro, Business et Custom.

## Définir un événement d’espace de travail

**Tableau de bord**

  1. **Ouvrez les événements d’espace de travail.** Accédez à **Email API → Events**, sélectionnez l’onglet **Workspace events**, puis **Define workspace event**.

  2. **Nommez l’événement.** Saisissez un **Name**, par exemple `customer.type`. Il est envoyé sous la forme `w:customer.type`. Ajoutez si vous le souhaitez un **Title**, affiché dans les chronologies et les sélecteurs, et une **Description** pour votre équipe.

  3. **Ajoutez des propriétés.** Sélectionnez **Add property** pour chaque valeur que les émetteurs doivent ou peuvent inclure. Donnez-lui un nom, choisissez son **Type** et activez **Required** si chaque événement doit la contenir. Un titre et une description sont facultatifs.

  4. **Créez l’événement.** Sélectionnez **Create**. Pour le vérifier, sélectionnez **Send test** sur la définition : **Send event** s’ouvre avec l’événement déjà choisi.

**API**

  Appelez [Créer un événement d’espace de travail](/fr/docs/api-reference/workspace-events/create/) avec une clé API **Full Access** :

```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" }
    ]
  }'
```

Envoyez-le ensuite comme n’importe quel autre événement, avec le script de suivi ou l’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" } }'
```

## Types de propriétés

| Type | Accepte | Enregistré sous la forme |
| --- | --- | --- |
| `string` | Une chaîne JSON, de 2 000 caractères au maximum. | La chaîne |
| `number` | Un nombre JSON. Les nombres entre guillemets, comme `"42"`, sont rejetés. | Le nombre |
| `date` | Une date ISO 8601 (`2026-10-01`) ou une date et heure (`2026-10-01T12:00:00Z`), ou un horodatage en millisecondes. Les années antérieures à 1900 sont rejetées. | Une date et heure ISO 8601 en UTC |
| `boolean` | `true` ou `false`. | Le booléen |

## Vérification des événements

Lorsqu’un événement `w:` arrive, Emailit compare ses `properties` à la définition :

- Chaque propriété doit figurer dans la définition. Les propriétés inconnues sont rejetées : une faute de frappe ne passe donc pas inaperçue.
- Les propriétés obligatoires doivent être présentes et ne pas valoir `null`.
- Une propriété facultative peut être omise, ou envoyée avec la valeur `null` pour indiquer qu’elle est vide.
- Chaque valeur doit correspondre à son type.

Un événement `w:` dont le nom n’est pas défini est rejeté lui aussi. L’API répond `422`, avec chaque problème indexé par son chemin, par exemple `properties.since`. Le script de suivi ignore les événements invalides et, avec le [débogage](/fr/docs/events/tracking-script/#debug) activé, en consigne la raison.

## Modifier ou supprimer une définition

Dans l’onglet **Workspace events**, sélectionnez **Edit** ou **Delete** sur une définition. Avec l’API, utilisez [Mettre à jour un événement d’espace de travail](/fr/docs/api-reference/workspace-events/update/) et [Supprimer un événement d’espace de travail](/fr/docs/api-reference/workspace-events/delete/).

- Une définition ne vérifie que les nouveaux événements. Les événements déjà enregistrés conservent les propriétés qu’ils avaient.
- Modifier les propriétés remplace toute la liste. Les émetteurs qui envoient encore une propriété supprimée reçoivent des erreurs : mettez-les donc à jour avant ou en même temps.
- Renommer l’événement change le type à envoyer. Les événements enregistrés conservent l’ancien type, et les nouveaux événements qui portent l’ancien nom sont rejetés.
- La suppression conserve les événements enregistrés, et les nouveaux événements de ce type sont rejetés jusqu’à ce que vous le définissiez de nouveau.

## Limites

Un espace de travail peut définir autant d’événements d’espace de travail que son forfait compte de [types d’événements](/fr/docs/events/#limits) : 100 sur Pro et 1 000 sur Business, sans limite sur Custom. Un événement de plus renvoie `422` avec le `code` `workspace_events_limit`. Chaque événement d’espace de travail a 50 propriétés au maximum. Les noms comptent 100 caractères au maximum, les noms de propriétés 64, les titres 120 et les descriptions 1 000.

## Voir aussi

  - [Suivi des événements](/fr/docs/events/): Portées, noms et destination des événements.
  - [API des événements d’espace de travail](/fr/docs/api-reference/workspace-events/): Créer, lister, mettre à jour et supprimer des définitions.

---
Source: https://emailit.com/fr/docs/events/workspace-events/