ஆவணங்கள்

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

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

மேலோட்டம்

உள்ளமைந்த புலங்களுக்கு (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-ஐப் பயன்படுத்துங்கள்.