ਸੰਪਰਕ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ

ਸੰਪਰਕ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਨਾਲ ਤੁਸੀਂ ਬਣੇ-ਬਣਾਏ ਖ਼ਾਨਿਆਂ (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
  }
});

ਜਿਵੇਂ ਹੀ ਤੁਸੀਂ ਘੱਟੋ-ਘੱਟ ਇੱਕ ਵਿਸ਼ੇਸ਼ਤਾ ਤੈਅ ਕਰ ਲੈਂਦੇ ਹੋ, Integration Snippet Agent Settings → Contact Properties ਹੇਠ ਆਪੇ ਦਿਸ ਪੈਂਦਾ ਹੈ — ਤੁਹਾਡੀਆਂ ਸਾਰੀਆਂ ਵਿਸ਼ੇਸ਼ਤਾ-ਕੁੰਜੀਆਂ ਪਹਿਲਾਂ ਤੋਂ ਭਰੀਆਂ ਹੁੰਦੀਆਂ ਹਨ। Copy ਦਬਾ ਕੇ ਇਸ ਨੂੰ ਲਵੋ ਅਤੇ ਆਪਣੀ ਐਪਲੀਕੇਸ਼ਨ ਵਿੱਚ ਚਿਪਕਾ ਦਿਓ। ਬਣੇ ਸਨਿੱਪਟ ਵਿੱਚ ਪਛਾਣ ਦੀ ਪੁਸ਼ਟੀ (HMAC-SHA256) ਲਈ userHash ਪਲੇਸਹੋਲਡਰ ਵੀ ਹੁੰਦਾ ਹੈ।

ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਦੇ ਮੁੱਲ ਗੱਲਬਾਤ ਦੇ metadata JSONB ਖ਼ਾਨੇ ਵਿੱਚ cp_ ਅਗੇਤਰ ਨਾਲ ਸਾਂਭੇ ਜਾਂਦੇ ਹਨ। ਮਿਸਾਲ ਵਜੋਂ, account_type ਕੁੰਜੀ ਵਾਲੀ ਵਿਸ਼ੇਸ਼ਤਾ cp_account_type ਵਜੋਂ ਸਾਂਭੀ ਜਾਂਦੀ ਹੈ।

ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਹਰ ਸੁਨੇਹੇ ਨਾਲ ਤਾਜ਼ਾ ਹੁੰਦੀਆਂ ਹਨ — ਜੇ ਵਿਜੇਟ ਨਵੇਂ ਮੁੱਲ ਭੇਜਦਾ ਹੈ, ਤਾਂ ਉਹ ਪੁਰਾਣਿਆਂ ਦੀ ਥਾਂ ਲੈ ਲੈਂਦੇ ਹਨ। ਇਸ ਦਾ ਮਤਲਬ ਹੈ ਕਿ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਦੇ ਮੁੱਲ ਹਮੇਸ਼ਾ ਤੁਹਾਡੀ ਐਪਲੀਕੇਸ਼ਨ ਦਾ ਸਭ ਤੋਂ ਨਵਾਂ ਡਾਟਾ ਦਿਖਾਉਂਦੇ ਹਨ।

ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਦੇ ਮੁੱਲ ਮੁਤਾਬਕ ਗੱਲਬਾਤਾਂ ਇਨਬਾਕਸ ਦੀ ਫ਼ਿਲਟਰ ਪੱਟੀ ਜਾਂ ਸਾਂਭੇ View ਰਾਹੀਂ ਛਾਂਟੋ। Property ਸ਼ਰਤ ਜੋੜੋ, ਨਾਂ ਨਾਲ ਵਿਸ਼ੇਸ਼ਤਾ ਚੁਣੋ — ਚੋਣਕਾਰ ਤੁਹਾਡੇ ਸਾਰੇ ਏਜੰਟਾਂ ਦੀਆਂ ਸਾਰੀਆਂ ਪਰਿਭਾਸ਼ਾਵਾਂ ਵਿਖਾਉਂਦਾ ਹੈ ਅਤੇ ਬਿਨਾਂ ਪਰਿਭਾਸ਼ਾ ਵਾਲੀ ਕੱਚੀ ਕੁੰਜੀ ਵੀ ਲੈ ਲੈਂਦਾ ਹੈ — ਫਿਰ ਮੁੱਲ ਚੁਣੋ। ਲਿਖਦੇ ਸਮੇਂ ਮੁੱਲ ਵਾਲਾ ਖ਼ਾਨਾ ਵੇਖੇ ਗਏ ਮੁੱਲ ਅਤੇ enum ਦੇ ਮੁੱਲ ਸੁਝਾਉਂਦਾ ਹੈ।

API ਰਾਹੀਂ, ਗੱਲਬਾਤਾਂ ਦੀ ਸੂਚੀ ਵਾਲੇ ਐਂਡਪੌਇੰਟ cp.<key>=<value> ਕਿਊਰੀ ਪੈਰਾਮੀਟਰ ਲੈਂਦੇ ਹਨ (attr.<key> ਦਾ ਹੂ-ਬ-ਹੂ ਬਦਲ)। ਕੋਈ ਲਿਖਤੀ ਕਿਊਰੀ ਸਿੰਟੈਕਸ ਨਹੀਂ ਹੈ:

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

ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਦੇ ਮੁੱਲ ਤੁਹਾਡੀ ਐਪਲੀਕੇਸ਼ਨ ਸੈੱਟ ਕਰਦੀ ਹੈ — ਵਿਜੇਟ ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਜਾਂ API ਰਾਹੀਂ — ਅਤੇ ਗੱਲਬਾਤ ਦੇ ਵੇਰਵਿਆਂ ਵਾਲੇ ਪੈਨਲ ਵਿੱਚ ਇਹ ਸਿਰਫ਼-ਪੜ੍ਹਨ ਲਈ ਹੁੰਦੇ ਹਨ। ਪੈਨਲ ਸੰਪਰਕ ਦੇ ਪ੍ਰੋਫ਼ਾਈਲ ਦਾ ਲਿੰਕ ਦਿੰਦਾ ਹੈ, ਜਿੱਥੇ ਸਹਾਇਤਾ ਕਰਮੀ ਸੰਪਰਕ ਦੀਆਂ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਵੇਖ ਅਤੇ ਸੋਧ ਸਕਦੇ ਹਨ (Contacts → ਸੰਪਰਕ → Attributes)।