కాంటాక్ట్ ప్రాపర్టీలు
కాంటాక్ట్ల కోసం కస్టమ్ ఫీల్డ్లు — అకౌంట్ రకం, ప్రాంతం, కాంట్రాక్ట్ స్థాయి వంటివి — నిర్వచించి వాటిని విడ్జెట్ ద్వారా పంపండి. ఈ ప్రాపర్టీలు కాంటాక్ట్ ప్రొఫైల్లో కనిపిస్తాయి, ఆపరేటర్లు వాటిని సవరించవచ్చు, ఇన్బాక్స్లో ఫిల్టర్ చేయవచ్చు.
అవలోకనం
అంతర్నిర్మిత ఫీల్డ్లకు (email, name, userId) అదనంగా నిర్మాణాత్మక డేటాను సంభాషణలకు జతచేయడానికి కాంటాక్ట్ ప్రాపర్టీలు ఉపయోగపడతాయి. స్వేచ్ఛా రూపంలో ఉండే metadata కంటే భిన్నంగా, ప్రాపర్టీలకు రకాలు, లేబుళ్లు, వాలిడేషన్తో కూడిన నిర్దిష్ట స్కీమా ఉంటుంది — HubSpot లేదా Salesforceలోని కస్టమ్ ఫీల్డ్ల లాంటిది.
స్కీమా నిర్వచించండి
string, number, enum, boolean, date, url వంటి రకాలతో Agent Settingsలో ప్రాపర్టీ నిర్వచనాలు సృష్టించండి
విడ్జెట్ నుంచి పంపండి
Respondo.identify() ద్వారా ప్రాపర్టీ విలువలు పంపండి — అవి ఆటోమేటిక్గా భద్రపరచబడి ప్రదర్శించబడతాయి
ఫిల్టర్ & సవరణ
ఇన్బాక్స్లో ప్రాపర్టీ విలువల ప్రకారం సంభాషణలను వడపోయండి. కాంటాక్ట్ ప్రొఫైల్లో ఆపరేటర్లు కాంటాక్ట్ అట్రిబ్యూట్లను చూడవచ్చు, సవరించవచ్చు.
ప్రాపర్టీలను నిర్వచించడం
ప్రతి ఏజెంట్కు విడిగా Agent Settings → Contact Properties లో ప్రాపర్టీలను నిర్వచిస్తారు. ప్రతి ప్రాపర్టీకి ఇవి ఉంటాయి:
| ఫీల్డ్ | వివరణ |
|---|---|
| key | కోడ్లో వాడే ప్రత్యేక గుర్తింపు. లేబుల్ నుంచి ఆటోమేటిక్గా తయారవుతుంది (సవరించవచ్చు). చిన్న అక్షరాలు, అంకెలు, అండర్స్కోర్లు; అక్షరంతో మొదలవ్వాలి; 2-63 అక్షరాలు. సిస్టమ్ కీలు (user_id, visitor_id, timezone, page_url, …) రిజర్వ్ చేయబడ్డాయి. ఉదాహరణ: account_type |
| label | డ్యాష్బోర్డ్లో కనిపించే, మనిషికి అర్థమయ్యే పేరు. ఉదాహరణ: "Account Type" |
| type | విలువ రకం: string, number, boolean, enum, date, url |
| enum_values | enum రకానికి — అనుమతించిన విలువల జాబితా. ఉదాహరణ: ["starter", "pro", "enterprise"] |
| is_filterable | భవిష్యత్ ఫిల్టర్ నియంత్రణ కోసం రిజర్వ్ చేయబడింది; నిర్వచనంతో పాటు నిల్వ అవుతుంది, కానీ ఇన్బాక్స్ ఫిల్టర్ పికర్ ప్రస్తుతం నిర్వచించిన అన్ని ప్రాపర్టీలనూ చూపిస్తుంది (డిఫాల్ట్: true) |
| is_visible | భవిష్యత్ ప్రదర్శన నియంత్రణ కోసం రిజర్వ్ చేయబడింది; నిర్వచనంతో పాటు నిల్వ అవుతుంది కానీ UIలో ఇంకా అమలు కావడం లేదు (డిఫాల్ట్: true) |
విడ్జెట్ నుంచి పంపడం
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).
ప్రాపర్టీలు vs మెటాడేటా
| లక్షణం | properties | metadata |
|---|---|---|
| స్కీమా | Agent Settingsలో రకాలతో నిర్వచిస్తారు | స్వేచ్ఛా రూప కీ-విలువ జతలు |
| ఫిల్టర్ చేయగలదా | అవును, ఫిల్టర్ బార్ / సేవ్ చేసిన Views ద్వారా (API: cp.<key> పారామ్) | లేదు |
| ఆపరేటర్లు సవరించగలరా | లేదు — విలువలు మీ అప్లికేషన్ నుంచి వస్తాయి; కాంటాక్ట్ అట్రిబ్యూట్లను కాంటాక్ట్ ప్రొఫైల్లో సవరిస్తారు | లేదు |
| రకాన్ని బట్టి ప్రదర్శన | అవును (బ్యాడ్జ్లు, లింక్లు, తేదీలు, బూలియన్లు) | సాదా టెక్స్ట్ మాత్రమే |
| ఆటోకంప్లీట్ | అవును, ఫిల్టర్ విలువ ఫీల్డ్లో విలువల సూచనలు | లేదు |
metadata వాడండి. మీ బృందం విభజన, పని ప్రవాహం కోసం చురుగ్గా వాడే నిర్మాణాత్మక డేటాకు properties వాడండి.