ஆவணங்கள்

தொடர்புப் பண்புகள்

கணக்கு வகை, பிராந்தியம், ஒப்பந்த நிலை போன்ற தனிப்பயன் புலங்களைத் தொடர்புகளுக்கு வரையறுத்து, விட்ஜெட் வழியாக அனுப்புங்கள். பண்புகள் தொடர்பின் சுயவிவரத்தில் காட்டப்படும், அலுவலர்கள் அவற்றைத் திருத்தலாம், இன்பாக்ஸில் வடிகட்டவும் முடியும்.

மேலோட்டம்#

உள்ளமைந்த புலங்களுக்கு (email, name, userId) அப்பால், கட்டமைக்கப்பட்ட தரவை உரையாடல்களுடன் இணைக்க தொடர்புப் பண்புகள் உதவுகின்றன. கட்டற்ற metadata-விலிருந்து வேறுபட்டு, பண்புகளுக்கு வகைகள், சிட்டைகள், சரிபார்ப்பு கொண்ட வரையறுக்கப்பட்ட திட்டம் உண்டு — HubSpot அல்லது Salesforce-இல் உள்ள தனிப்பயன் புலங்களைப் போல.

திட்டத்தை வரையறுங்கள்

string, number, enum, boolean, date, url போன்ற வகைகளுடன் Agent Settings-இல் பண்பு வரையறைகளை உருவாக்குங்கள்

விட்ஜெட்டிலிருந்து அனுப்புங்கள்

Respondo.identify() வழியாக பண்பு மதிப்புகளை அனுப்புங்கள் — அவை தானாகவே சேமிக்கப்பட்டுக் காட்டப்படும்

வடிகட்டலும் திருத்தமும்

இன்பாக்ஸில் பண்பு மதிப்புகளின்படி உரையாடல்களை வடிகட்டுங்கள். தொடர்பின் சுயவிவரத்தில் அலுவலர்கள் தொடர்பின் attributes-ஐப் பார்க்கவும் திருத்தவும் முடியும்.

பண்புகளை வரையறுத்தல்#

ஒவ்வொரு முகவருக்கும் தனித்தனியாக, 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_valuesenum வகைக்கு — அனுமதிக்கப்பட்ட மதிப்புகளின் பட்டியல். எடுத்துக்காட்டு: ["starter", "pro", "enterprise"]
is_filterableஎதிர்கால வடிகட்டல் கட்டுப்பாட்டுக்காக ஒதுக்கப்பட்டது; வரையறையுடன் சேமிக்கப்படுகிறது, ஆனால் இன்பாக்ஸ் வடிகட்டித் தேர்வி தற்போது வரையறுக்கப்பட்ட எல்லாப் பண்புகளையும் பட்டியலிடுகிறது (இயல்பு: true)
is_visibleஎதிர்காலக் காட்சிக் கட்டுப்பாட்டுக்காக ஒதுக்கப்பட்டது; வரையறையுடன் சேமிக்கப்படுகிறது, ஆனால் UI-இல் இன்னும் அமல்படுத்தப்படவில்லை (இயல்பு: true)
ஒரு முகவருக்கு அதிகபட்சம் 50 பண்புகள். அமைப்புகள் திரையில் இழுத்து-விடுவதன் மூலம் பண்புகளின் வரிசையை மாற்றலாம்.

விட்ஜெட்டிலிருந்து அனுப்புதல்#

Respondo.identify()-இன் properties புலத்தில் பண்பு மதிப்புகளை அனுப்புங்கள். சாவிகள் Agent Settings-இல் உள்ள பண்பு வரையறைகளுடன் பொருந்த வேண்டும்.

விட்ஜெட் இணைப்புjavascript
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 (சரமாக அனுப்பப்படுகிறது)
    is_partner: 'true',           // boolean (சரமாக அனுப்பப்படுகிறது)
    contract_end: '2026-12-31',   // date
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});
எல்லாப் பண்பு மதிப்புகளும் சரங்களாகவே அனுப்பப்படுகின்றன. வகைக்கேற்ற காட்சியை டாஷ்போர்டு கையாளுகிறது (எ.கா. boolean → Yes/No, url → கிளிக் செய்யக்கூடிய இணைப்பு, enum → பேட்ஜ்).

இணைப்புத் துணுக்கு#

குறைந்தது ஒரு பண்பையாவது வரையறுத்ததும், Integration Snippet Agent Settings → Contact Properties பகுதியில் தானாகவே தோன்றும் — உங்கள் எல்லாப் பண்புச் சாவிகளும் முன்பே நிரப்பப்பட்டிருக்கும். Copy என்பதை அழுத்தி அதை எடுத்து உங்கள் செயலியில் ஒட்டுங்கள். உருவாக்கப்படும் துணுக்கில் அடையாளச் சரிபார்ப்புக்கான (HMAC-SHA256) userHash placeholder-உம் இருக்கும்.

மதிப்புகளின் சேமிப்பு#

பண்பு மதிப்புகள் உரையாடலின் metadata JSONB புலத்தில் cp_ முன்னொட்டுடன் சேமிக்கப்படுகின்றன. எடுத்துக்காட்டாக, account_type சாவி கொண்ட பண்பு cp_account_type ஆகச் சேமிக்கப்படும்.

ஒவ்வொரு செய்திக்கும் பண்புகள் புதுப்பிக்கப்படுகின்றன — விட்ஜெட் புதிய மதிப்புகளை அனுப்பினால், அவை ஏற்கெனவே உள்ளவற்றை மேலெழுதும். எனவே பண்பு மதிப்புகள் எப்போதும் உங்கள் செயலியின் சமீபத்திய தரவைப் பிரதிபலிக்கும்.

இன்பாக்ஸில் வடிகட்டல்#

இன்பாக்ஸ் வடிகட்டிப் பட்டி அல்லது சேமித்த View வழியாகப் பண்பு மதிப்புகளின்படி உரையாடல்களை வடிகட்டுங்கள். Property நிபந்தனையைச் சேர்த்து, பண்பைப் பெயரால் தேர்ந்தெடுங்கள் — தேர்வி உங்கள் எல்லா முகவர்களிலும் உள்ள ஒவ்வொரு வரையறையையும் பட்டியலிடுகிறது; வரையறை இல்லாத மூலச் சாவியையும் ஏற்கிறது — பிறகு ஒரு மதிப்பைத் தேர்வு செய்யுங்கள். நீங்கள் தட்டச்சு செய்யும்போதே மதிப்புப் புலம் கண்டறியப்பட்ட மதிப்புகளையும் enum மதிப்புகளையும் பரிந்துரைக்கிறது.

API வழியாக, conversations list endpoint-கள் cp.<key>=<value> வினவல் அளவுருவை ஏற்கின்றன (attr.<key>-இன் நேரடி மாற்றுப்பெயர்). தடையற்ற உரை வினவல் தொடரியல் எதுவும் இல்லை:

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

மதிப்புகளைத் திருத்துதல்#

பண்பு மதிப்புகளை உங்கள் செயலியே அமைக்கிறது — விட்ஜெட் இணைப்பு அல்லது API வழியாக; உரையாடல் விவரங்கள் பலகத்தில் அவை படிக்க-மட்டும். பலகம் தொடர்பின் சுயவிவரத்திற்கு இணைக்கிறது; அங்கே அலுவலர்கள் தொடர்பின் attributes-ஐப் பார்க்கவும் திருத்தவும் முடியும் (Contacts → தொடர்பு → Attributes).

properties-உம் metadata-வும்

அம்சம்propertiesmetadata
திட்டம்வகைகளுடன் Agent Settings-இல் வரையறுக்கப்படுகிறதுகட்டற்ற சாவி-மதிப்பு இணைகள்
வடிகட்டக்கூடியதாஆம், வடிகட்டிப் பட்டி / சேமித்த View-கள் வழியாக (API: cp.<key> அளவுரு)இல்லை
அலுவலர்கள் திருத்த முடியுமாஇல்லை — மதிப்புகள் உங்கள் செயலியிலிருந்து வருகின்றன; தொடர்பு attributes தொடர்பின் சுயவிவரத்தில் திருத்தப்படுகின்றனஇல்லை
வகைக்கேற்ற காட்சிஆம் (பேட்ஜ்கள், இணைப்புகள், தேதிகள், boolean மதிப்புகள்)வெற்று உரை மட்டுமே
தானியங்கு நிரப்பல்ஆம், வடிகட்டி மதிப்புப் புலத்தில் மதிப்புப் பரிந்துரைகள்இல்லை
வடிகட்டலோ வகைக்கேற்ற காட்சியோ தேவைப்படாத தற்காலிகப் புலங்களுக்கு metadata-ஐப் பயன்படுத்துங்கள். பிரிவாக்கத்திற்கும் பணிப்பாய்வுக்கும் உங்கள் குழு தீவிரமாகப் பயன்படுத்தும் கட்டமைக்கப்பட்ட தரவுக்கு properties-ஐப் பயன்படுத்துங்கள்.