Segmenter og beregnede traits

Segmenter

GET /v1/segments lister hvert segment med et live kontaktantall. GET /v1/segments/schema returnerer feltene og operatorene regelbyggeren kan tilby, slik at et eget grensesnitt kan bygges mot det samme skjemaet som dashbordet bruker.

Før du lagrer et segment, kan du forhåndsvise hvor mange kontakter et regelsett treffer — begge legitimasjonstypene virker her, en API-nøkkel eller et dashbord-JWT fra POST /v1/auth/login:

curl -X POST https://api.wezend.com/v1/segments/preview \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rules": [{ "field": "trait:churn_score", "op": "gt", "value": 0.7 }] }'

GET /v1/segments/:id/contacts løser opp et lagret segment til de faktiske medlemskontaktene.

Forhåndsvisning, listing og oppslag krever read-scope; å opprette, oppdatere eller slette et segment krever write. En nøkkel med bare read som kaller POST /v1/segments, får 403 insufficient_scope med den manglende scopen navngitt. Nøkler utstedt uten scope-liste beholder full tilgang.

Beregnede traits

Traits (/v1/traits) er kundedefinerte aggregeringer over hendelser, meldinger og ordrer — f.eks. "ordrer siste 90 dager" eller "gjennomsnittlig ordreverdi" — materialisert direkte på hver kontakt, slik at de kan spørres på som trait:<key> i segmentregler, akkurat som churn score-eksempelet over.