Contacteigenschappen

Met Contacteigenschappen kun je gestructureerde data aan gesprekken koppelen, naast de ingebouwde velden (email, naam, userId). Anders dan vrije metadata hebben eigenschappen een gedefinieerd schema met types, labels en validatie — vergelijkbaar met aangepaste velden in HubSpot of Salesforce.

Eigenschappen worden per agent gedefinieerd in Agentinstellingen → Contacteigenschappen. Elke eigenschap heeft:

Geef eigenschapswaarden door in het veld properties van Respondo.identify(). De keys moeten overeenkomen met de eigenschapsdefinities uit de Agentinstellingen.

Respondo.identify({
  email: 'user@example.com',
  name: 'Jane Smith',
  userId: 'usr_456',
  properties: {
    account_type: 'enterprise',   // enum
    region: 'eu-west',            // string
    monthly_spend: '15000',       // number (doorgegeven als string)
    is_partner: 'true',           // boolean (doorgegeven als string)
    contract_end: '2026-12-31',   // date
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});

Het Integratiesnippet verschijnt automatisch onder Agentinstellingen → Contacteigenschappen zodra je minstens één eigenschap hebt gedefinieerd, met al je eigenschap-keys vooraf ingevuld. Klik op Kopiëren om het over te nemen en plak het in je applicatie. Het gegenereerde snippet bevat ook een userHash-placeholder voor identiteitsverificatie (HMAC-SHA256).

Eigenschapswaarden worden opgeslagen in het metadata JSONB-veld van het gesprek met een cp_-prefix. Bijvoorbeeld: een eigenschap met key account_type wordt opgeslagen als cp_account_type.

Eigenschappen worden bij elk bericht bijgewerkt — als de widget nieuwe waarden verstuurt, overschrijven ze de bestaande. Dit betekent dat eigenschapswaarden altijd de meest recente data uit je applicatie weerspiegelen.

Filter gesprekken op eigenschapswaarden via de filterbalk van de Inbox of een opgeslagen weergave. Voeg een voorwaarde Eigenschap toe, kies de eigenschap op naam — de kiezer toont elke definitie van al je agents en accepteert ook een ruwe key zonder definitie — en kies vervolgens een waarde. Het waardeveld stelt tijdens het typen waargenomen waarden en eventuele enum-waarden voor.

Via de API accepteren de lijst-endpoints voor gesprekken een cp.<key>=<value> queryparameter (een exacte alias van attr.<key>). Er is geen vrije-tekst querysyntaxis:

GET /api/v1/conversations?cp.account_type=enterprise

Eigenschapswaarden worden ingesteld door je applicatie — via de widgetintegratie of de API — en zijn alleen-lezen in het gespreksdetailpaneel. Het paneel linkt naar het profiel van het contact, waar medewerkers de attributen van het contact kunnen bekijken en bewerken (Contacten → contact → Attributen).