คุณสมบัติของผู้ติดต่อ (Contact Properties)

คุณสมบัติของผู้ติดต่อช่วยให้คุณแนบข้อมูลที่มีโครงสร้างเข้ากับบทสนทนา นอกเหนือจากฟิลด์ที่มีมาให้ (email, name, userId) ต่างจาก metadata ที่เป็นรูปแบบอิสระ คุณสมบัติจะมี schema ที่กำหนดไว้พร้อมชนิดข้อมูล ป้ายกำกับ และการตรวจสอบความถูกต้อง — คล้ายกับฟิลด์ที่กำหนดเองใน HubSpot หรือ Salesforce

คุณสมบัติถูกกำหนดต่อเอเจนต์ใน Agent Settings → Contact Propertiesแต่ละคุณสมบัติมี:

ส่งค่าคุณสมบัติในฟิลด์ properties ของ Respondo.identify()key ต้องตรงกับนิยามคุณสมบัติจาก 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 (ส่งเป็น string)
    is_partner: 'true',           // boolean (ส่งเป็น string)
    contract_end: '2026-12-31',   // date
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});

Integration Snippet จะปรากฏโดยอัตโนมัติใต้ Agent Settings → Contact Properties เมื่อคุณกำหนดคุณสมบัติไว้อย่างน้อยหนึ่งรายการ โดยกรอก key คุณสมบัติทั้งหมดของคุณไว้ล่วงหน้าแล้ว คลิก Copy เพื่อคัดลอกและวางลงในแอปพลิเคชันของคุณ สไนปเป็ตที่สร้างขึ้นยังมี placeholder userHash สำหรับการยืนยันตัวตน (HMAC-SHA256) ด้วย

ค่าคุณสมบัติถูกจัดเก็บในฟิลด์ JSONB metadataของบทสนทนา โดยมีคำนำหน้า cp_ ตัวอย่างเช่น คุณสมบัติที่มี key account_type จะถูกจัดเก็บเป็น cp_account_type

คุณสมบัติจะถูกอัปเดตในทุกข้อความ — หากวิดเจ็ตส่งค่าใหม่มา ค่าเหล่านั้นจะเขียนทับค่าเดิม หมายความว่าค่าคุณสมบัติจะสะท้อนข้อมูลล่าสุดจากแอปพลิเคชันของคุณเสมอ

กรองบทสนทนาตามค่าคุณสมบัติโดยใช้แถบตัวกรองของกล่องข้อความหรือมุมมองที่บันทึกไว้ (View) เพิ่มเงื่อนไข Property เลือกคุณสมบัติตามชื่อ — ตัวเลือกจะแสดงทุกนิยามจากเอเจนต์ทั้งหมดของคุณ และยังรับ key ดิบที่ไม่มีนิยามด้วย — แล้วเลือกค่า ช่องค่าจะแนะนำค่าที่เคยพบและค่า enum ขณะที่คุณพิมพ์

ผ่าน API, endpoint รายการบทสนทนารับพารามิเตอร์คิวรี cp.<key>=<value> (alias ที่เทียบเท่ากับ attr.<key> ทุกประการ) ไม่มีไวยากรณ์คิวรีข้อความอิสระ:

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

ค่าคุณสมบัติถูกกำหนดโดยแอปพลิเคชันของคุณ — ผ่านการผสานรวมวิดเจ็ตหรือ API — และเป็นแบบอ่านอย่างเดียวในแผงรายละเอียดบทสนทนา แผงนี้ลิงก์ไปยังโปรไฟล์ของผู้ติดต่อ ที่ซึ่งเจ้าหน้าที่สามารถดูและแก้ไขแอตทริบิวต์ของผู้ติดต่อได้ (Contacts → ผู้ติดต่อ → Attributes)