కాంటాక్ట్ ప్రాపర్టీలు

అంతర్నిర్మిత ఫీల్డ్‌లకు (email, name, userId) అదనంగా నిర్మాణాత్మక డేటాను సంభాషణలకు జతచేయడానికి కాంటాక్ట్ ప్రాపర్టీలు ఉపయోగపడతాయి. స్వేచ్ఛా రూపంలో ఉండే metadata కంటే భిన్నంగా, ప్రాపర్టీలకు రకాలు, లేబుళ్లు, వాలిడేషన్‌తో కూడిన నిర్దిష్ట స్కీమా ఉంటుంది — HubSpot లేదా Salesforceలోని కస్టమ్ ఫీల్డ్‌ల లాంటిది.

ప్రతి ఏజెంట్‌కు విడిగా Agent Settings → Contact Properties లో ప్రాపర్టీలను నిర్వచిస్తారు. ప్రతి ప్రాపర్టీకి ఇవి ఉంటాయి:

Respondo.identify() లోని properties ఫీల్డ్‌లో ప్రాపర్టీ విలువలను పంపండి. కీలు Agent Settingsలోని ప్రాపర్టీ నిర్వచనాలతో సరిపోలాలి.

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 (passed as string)
    is_partner: 'true',           // boolean (passed as string)
    contract_end: '2026-12-31',   // date
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});

కనీసం ఒక ప్రాపర్టీని నిర్వచించాక, Agent Settings → Contact Properties కింద ఇంటిగ్రేషన్ స్నిప్పెట్ ఆటోమేటిక్‌గా కనిపిస్తుంది — మీ ప్రాపర్టీ కీలన్నీ అందులో ముందే నిండి ఉంటాయి. Copy నొక్కి దాన్ని తీసుకుని మీ అప్లికేషన్‌లో అతికించండి. తయారైన స్నిప్పెట్‌లో గుర్తింపు ధ్రువీకరణ (HMAC-SHA256) కోసం userHash ప్లేస్‌హోల్డర్ కూడా ఉంటుంది.

ప్రాపర్టీ విలువలు సంభాషణ యొక్క metadata JSONB ఫీల్డ్‌లో cp_ ఉపసర్గతో నిల్వ అవుతాయి. ఉదాహరణకు, account_type కీ ఉన్న ప్రాపర్టీ cp_account_type గా భద్రమవుతుంది.

ప్రతి మెసేజ్‌తోనూ ప్రాపర్టీలు తాజా అవుతాయి — విడ్జెట్ కొత్త విలువలు పంపితే, అవి పాత విలువలను భర్తీ చేస్తాయి. అంటే ప్రాపర్టీ విలువలు ఎప్పుడూ మీ అప్లికేషన్‌లోని తాజా డేటానే చూపుతాయి.

ఇన్‌బాక్స్ ఫిల్టర్ బార్ ద్వారా లేదా సేవ్ చేసిన View ద్వారా ప్రాపర్టీ విలువల ప్రకారం సంభాషణలను వడపోయండి. Property షరతును జోడించి, పేరుతో ప్రాపర్టీని ఎంచుకోండి — పికర్ మీ ఏజెంట్లందరి నిర్వచనాలనూ చూపుతుంది, నిర్వచనం లేని ముడి కీని కూడా అంగీకరిస్తుంది — ఆపై విలువను ఎంచుకోండి. మీరు టైప్ చేస్తుండగానే విలువ ఫీల్డ్ గమనించిన విలువలను, enum విలువలను సూచిస్తుంది.

API ద్వారా అయితే, conversations జాబితా ఎండ్‌పాయింట్‌లు cp.<key>=<value> క్వెరీ పారామీటర్‌ను అంగీకరిస్తాయి (attr.<key> కు కచ్చితమైన మారుపేరు). ఫ్రీ-టెక్స్ట్ క్వెరీ సింటాక్స్ లేదు:

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

ప్రాపర్టీ విలువలను మీ అప్లికేషనే సెట్ చేస్తుంది — విడ్జెట్ ఇంటిగ్రేషన్ లేదా API ద్వారా — సంభాషణ వివరాల ప్యానెల్‌లో అవి చదవడానికి-మాత్రమే. ప్యానెల్ కాంటాక్ట్ ప్రొఫైల్‌కు లింక్ ఇస్తుంది; అక్కడ ఆపరేటర్లు కాంటాక్ట్ అట్రిబ్యూట్‌లను చూడవచ్చు, సవరించవచ్చు (Contacts → కాంటాక్ట్ → Attributes).