Segmente & berechnete Traits

Segmente

GET /v1/segments listet jedes Segment mit einer Live-Kontaktanzahl auf. GET /v1/segments/schema liefert die Felder und Operatoren, die der Regel-Builder anbieten kann, sodass sich eine eigene Oberfläche gegen dasselbe Schema bauen lässt, das auch das Dashboard verwendet.

Vor dem Speichern eines Segments können Sie in der Vorschau sehen, wie viele Kontakte ein Regelsatz trifft — beide Credential-Typen funktionieren hier, ein API-Key oder ein Dashboard-JWT aus 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öst ein gespeichertes Segment in die tatsächlichen Mitgliedskontakte auf.

Vorschau, Auflisten und Auflösen benötigen den Scope read; ein Segment anzulegen, zu ändern oder zu löschen benötigt write. Ein Key mit nur read, der POST /v1/segments aufruft, erhält 403 insufficient_scope mit Nennung des fehlenden Scopes. Keys ohne Scope-Liste behalten den vollen Zugriff.

Berechnete Traits

Traits (/v1/traits) sind kundenseitig definierte Aggregationen über Events, Nachrichten und Bestellungen — z. B. „Bestellungen der letzten 90 Tage" oder „durchschnittlicher Bestellwert" — die direkt auf jedem Kontakt materialisiert werden, sodass sie in Segmentregeln als trait:<key> abfragbar sind, genau wie im Churn-Score-Beispiel oben.