رابطے کی خصوصیات

رابطے کی خصوصیات کی مدد سے آپ بلٹ اِن خانوں (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 کے نام سے محفوظ ہوتی ہے۔

خصوصیات ہر پیغام پر تازہ ہوتی ہیں — اگر ویجٹ نئی قدریں بھیجے تو وہ پرانی قدروں کی جگہ لے لیتی ہیں۔ یعنی خصوصیت کی قدریں ہمیشہ آپ کی ایپلیکیشن کا تازہ ترین ڈیٹا دکھاتی ہیں۔

خصوصیت کی قدروں کے حساب سے گفتگوئیں Inbox کی فلٹر بار یا کسی محفوظ View سے چھانیں۔ Property شرط شامل کریں، خصوصیت اس کے نام سے چنیں — چننے والا آپ کے تمام ایجنٹس کی ہر تعریف دکھاتا ہے اور ایسی خام کلید بھی قبول کرتا ہے جس کی کوئی تعریف نہیں — پھر قدر منتخب کریں۔ لکھتے وقت قدر کا خانہ دیکھی گئی قدریں اور enum کی قدریں تجویز کرتا ہے۔

API پر گفتگوؤں کی فہرست کے endpoints ایک cp.<key>=<value> کوئری پیرامیٹر قبول کرتے ہیں (attr.<key> کا ہو بہو متبادل)۔ آزاد متن کا کوئی کوئری سنٹیکس نہیں:

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

خصوصیت کی قدریں آپ کی ایپلیکیشن مقرر کرتی ہے — ویجٹ انٹیگریشن یا API کے ذریعے — اور گفتگو کی تفصیل والے پینل میں یہ صرف پڑھنے کے لیے ہوتی ہیں۔ پینل رابطے کے پروفائل کا لنک دیتا ہے، جہاں نمائندے رابطے کی attributes دیکھ اور بدل سکتے ہیں (Contacts → رابطہ → Attributes)۔