Événements client

Les offres à déclencheur événement s’appliquent hors ticket : 100 points à l’inscription, un coupon d’anniversaire, un bonus quand un client franchit un palier.

Envoyer un événement

POST /v1/events (clé d’API avec la portée events:write) :

{
  "type": "signup",
  "customer": { "type": "card", "value": "2600000012345" },
  "occurredAt": "2026-11-09T10:42:13+01:00",
  "storeCode": "S042",
  "channel": "pos",
  "payload": { "optinMarketing": true }
}

Types : signup, card_created, birthday, anniversary_signup, status_changed, segment_entered, segment_left, counter_threshold, custom (avec customType).

Le moteur enregistre l’événement, évalue immédiatement les offres concernées et valide leurs effets sans phase d’attente. La réponse est un résultat d’évaluation en mode commit.

Idempotence

Envoyez toujours un Idempotency-Key ; la forme recommandée est <type>:<référence externe>:<date>, par exemple birthday:CRM-778812:2026-11-09. Un événement rejoué ne crédite pas deux fois.

Autres sources d’événements

• le studio (fiche client → « envoyer un événement ») et l’API hub POST /workspaces/{ws}/customers/{id}/events ;
• les connecteurs de synchronisation (enregistrements de type événement) ;
• les tâches planifiées : customers.birthdays émet les anniversaires du jour, segments.compute peut émettre les entrées et sorties de segment ;
• les offres elles-mêmes, par l’action custom_event.

Filtrer sur le contenu

Le critère event filtre sur le contenu de l’événement (payload), par exemple path: "optinMarketing", op: "eq", value: true.