কন্টাক্ট প্রপার্টি

কন্টাক্টের জন্য কাস্টম ফিল্ড ঠিক করুন — যেমন অ্যাকাউন্টের ধরন, অঞ্চল বা চুক্তির স্তর — এবং সেগুলো উইজেটের মাধ্যমে পাঠান। প্রপার্টিগুলো কন্টাক্টের প্রোফাইলে দেখা যায়, অপারেটররা সেগুলো সম্পাদনা করতে পারেন এবং Inbox-এ সেগুলো দিয়ে ফিল্টার করা যায়।

সংক্ষেপে#

কন্টাক্ট প্রপার্টি দিয়ে আপনি বিল্ট-ইন ফিল্ডের (email, name, userId) বাইরেও কথোপকথনের সঙ্গে কাঠামোবদ্ধ তথ্য যুক্ত করতে পারেন। মুক্ত-আকারের metadata-র বিপরীতে প্রপার্টির নির্দিষ্ট স্কিমা থাকে — টাইপ, লেবেল ও যাচাইসহ, অনেকটা HubSpot বা Salesforce-এর কাস্টম ফিল্ডের মতো।

স্কিমা ঠিক করুন

Agent Settings-এ string, number, enum, boolean, date, url-এর মতো টাইপ দিয়ে প্রপার্টির সংজ্ঞা তৈরি করুন

উইজেট থেকে পাঠান

Respondo.identify() দিয়ে প্রপার্টির মান পাঠান — সেগুলো নিজে থেকেই সংরক্ষিত ও প্রদর্শিত হয়

ফিল্টার ও সম্পাদনা

Inbox-এ প্রপার্টির মান ধরে কথোপকথন ফিল্টার করুন। অপারেটররা কন্টাক্টের প্রোফাইলে গিয়ে কন্টাক্টের অ্যাট্রিবিউট দেখতে ও সম্পাদনা করতে পারেন।

প্রপার্টি সংজ্ঞায়িত করা#

প্রতিটি এজেন্টের জন্য প্রপার্টি ঠিক করা হয় 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	ভবিষ্যতের ফিল্টার-নিয়ন্ত্রণের জন্য সংরক্ষিত; সংজ্ঞার সঙ্গে জমা থাকে, কিন্তু Inbox-এর ফিল্টার-পিকার আপাতত সংজ্ঞায়িত সব প্রপার্টিই দেখায় (ডিফল্ট: 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 → ব্যাজ)।

ইন্টিগ্রেশন স্নিপেট#

অন্তত একটি প্রপার্টি সংজ্ঞায়িত করলেই Agent Settings → Contact Properties-এ Integration Snippet নিজে থেকে দেখা যায় — আপনার সব প্রপার্টি-কী আগে থেকেই বসানো থাকে। Copy-তে ক্লিক করে সেটি নিয়ে আপনার অ্যাপ্লিকেশনে বসিয়ে দিন। তৈরি হওয়া স্নিপেটে পরিচয় যাচাইয়ের (HMAC-SHA256) জন্য একটি userHash প্লেসহোল্ডারও থাকে।

মান কীভাবে সংরক্ষিত হয়#

প্রপার্টির মান কথোপকথনের metadata JSONB ফিল্ডে cp_ প্রিফিক্সসহ সংরক্ষিত হয়। যেমন, account_type কী-এর প্রপার্টি সংরক্ষিত হয় cp_account_type নামে।

প্রতিটি বার্তার সঙ্গেই প্রপার্টি হালনাগাদ হয় — উইজেট নতুন মান পাঠালে সেগুলো আগের মানের জায়গায় বসে। ফলে প্রপার্টির মানে সবসময় আপনার অ্যাপ্লিকেশনের সর্বশেষ তথ্যই থাকে।

Inbox-এ ফিল্টার করা#

Inbox-এর ফিল্টার বার বা সংরক্ষিত View দিয়ে প্রপার্টির মান ধরে কথোপকথন ফিল্টার করুন। একটি Property শর্ত যোগ করুন, নাম ধরে প্রপার্টিটি বাছুন — পিকারটি আপনার সব এজেন্টের প্রতিটি সংজ্ঞা দেখায় এবং সংজ্ঞাহীন কাঁচা কী-ও নেয় — তারপর একটি মান বেছে নিন। টাইপ করার সময় মানের ঘরটি পর্যবেক্ষণ করা মান ও enum-এর মানগুলো পরামর্শ হিসেবে দেখায়।

API-এর দিক থেকে, কথোপকথন-তালিকার এন্ডপয়েন্টগুলো একটি cp.<key>=<value> কোয়েরি প্যারামিটার নেয় (attr.<key>-এর হুবহু উপনাম)। কোনো ফ্রি-টেক্সট কোয়েরি সিনট্যাক্স নেই:

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

মান সম্পাদনা#

প্রপার্টির মান সেট করে আপনার অ্যাপ্লিকেশন — উইজেট ইন্টিগ্রেশন বা API-এর মাধ্যমে — আর কথোপকথনের বিস্তারিত প্যানেলে সেগুলো শুধু-পড়ার। প্যানেল থেকে কন্টাক্টের প্রোফাইলে যাওয়ার লিঙ্ক আছে, যেখানে অপারেটররা কন্টাক্টের অ্যাট্রিবিউট দেখতে ও সম্পাদনা করতে পারেন (Contacts → কন্টাক্ট → Attributes)।

প্রপার্টি বনাম মেটাডেটা

বৈশিষ্ট্য	properties	metadata
স্কিমা	Agent Settings-এ টাইপসহ ঠিক করা হয়	মুক্ত-আকারের কী-ভ্যালু জোড়া
ফিল্টার করা যায়	হ্যাঁ, ফিল্টার বার / সংরক্ষিত View দিয়ে (API: `cp.<key>` প্যারামিটার)	না
অপারেটর সম্পাদনা করতে পারেন	না — মান আসে আপনার অ্যাপ্লিকেশন থেকে; কন্টাক্টের অ্যাট্রিবিউট সম্পাদনা হয় কন্টাক্টের প্রোফাইলে	না
টাইপ অনুযায়ী প্রদর্শন	হ্যাঁ (ব্যাজ, লিঙ্ক, তারিখ, boolean)	কেবল সাধারণ টেক্সট
স্বয়ংক্রিয় পরামর্শ	হ্যাঁ, ফিল্টারের মানের ঘরে মানের পরামর্শ দেয়	না

যেসব ফিল্ড প্রয়োজনমতো যোগ করা হয় এবং যেগুলোয় ফিল্টার বা টাইপ-ভিত্তিক প্রদর্শন লাগে না, তাদের জন্য metadata ব্যবহার করুন। যে কাঠামোবদ্ধ তথ্য আপনার টিম সেগমেন্টেশন ও কাজের প্রবাহে সক্রিয়ভাবে ব্যবহার করবে, তার জন্য properties।