Mga Katangian ng Contact

Magtakda ng custom na field para sa mga contact — tulad ng uri ng account, rehiyon, o antas ng kontrata — at ipasa ang mga ito sa widget. Ipinapakita ang mga katangian sa profile ng contact, naeedit ng mga tagasuporta, at nasasala sa Inbox.

Pangkalahatang-ideya#

Sa Mga Katangian ng Contact, puwede kayong magkabit ng nakaayos na datos sa mga usapan bukod pa sa mga likas na field (email, name, userId). Hindi tulad ng malayang metadata, may tiyak na schema ang mga katangian — may uri, label, at validation — katulad ng mga custom field sa HubSpot o Salesforce.

Itakda ang schema

Gumawa ng mga kahulugan ng katangian sa Mga Setting ng Ahente gamit ang mga uri tulad ng string, number, enum, boolean, date, url

Ipasa mula sa widget

Ipadala ang mga halaga ng katangian sa pamamagitan ng Respondo.identify() — awtomatiko itong naiimbak at naipapakita

Salain at i-edit

Salain ang mga usapan ayon sa halaga ng katangian sa Inbox. Puwedeng tingnan at i-edit ng mga tagasuporta ang mga attribute ng contact sa profile ng contact.

Pagtatakda ng mga Katangian#

Nakatakda ang mga katangian kada ahente sa Mga Setting ng Ahente → Mga Katangian ng Contact. Bawat katangian ay may:

Field	Paglalarawan
key	Natatanging identifier na ginagamit sa code. Awtomatikong nabubuo mula sa label (naeedit). Maliliit na titik, numero at underscore; dapat magsimula sa titik; 2-63 karakter. Nakareserba ang mga system key (`user_id`, `visitor_id`, `timezone`, `page_url`, …). Halimbawa: `account_type`
label	Pangalang nababasa ng tao na ipinapakita sa dashboard. Halimbawa: "Account Type"
type	Uri ng halaga: `string`, `number`, `boolean`, `enum`, `date`, `url`
enum_values	Para sa uring `enum` — listahan ng mga pinapayagang halaga. Halimbawa: `["starter", "pro", "enterprise"]`
is_filterable	Nakareserba para sa hinaharap na kontrol ng filter; naiimbak kasama ng depinisyon, pero kasalukuyang inililista ng filter picker ng Inbox ang lahat ng nakatakdang katangian (default: true)
is_visible	Nakareserba para sa hinaharap na kontrol ng pagpapakita; naiimbak kasama ng depinisyon pero hindi pa ipinapatupad sa UI (default: true)

Hanggang 50 katangian kada ahente. Puwedeng baguhin ang pagkakasunod-sunod ng mga katangian sa pamamagitan ng drag-and-drop sa settings UI.

Ipasa ang mga halaga ng katangian sa field na properties ng Respondo.identify(). Kailangang tumugma ang mga key sa mga kahulugan ng katangian mula sa Mga Setting ng Ahente.

Integrasyon ng widgetjavascript

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 (ipinapasa bilang string)
    is_partner: 'true',           // boolean (ipinapasa bilang string)
    contract_end: '2026-12-31',   // date
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});

Ipinapasa bilang string ang lahat ng halaga ng katangian. Ang dashboard na ang bahala sa pagpapakita ayon sa uri (halimbawa, boolean → Yes/No, url → naki-click na link, enum → badge).

Snippet ng Integrasyon#

Kusang lumilitaw ang Snippet ng Integrasyon sa ilalim ng Mga Setting ng Ahente → Mga Katangian ng Contact kapag nakapagtakda na kayo ng kahit isang katangian, kung saan nakalagay na ang lahat ng key ng katangian ninyo. Pindutin ang Copy para kunin ito at i-paste sa aplikasyon ninyo. May kasama ring userHash na placeholder ang nabuong snippet para sa pagpapatunay ng identity (HMAC-SHA256).

Paano naiimbak ang mga halaga#

Naiimbak ang mga halaga ng katangian sa JSONB field na metadata ng usapan, may prefix na cp_. Halimbawa, ang katangian na may key na account_type ay naiimbak bilang cp_account_type.

Ina-update ang mga katangian sa bawat mensahe — kung magpapadala ang widget ng bagong halaga, papalitan nito ang dati. Ibig sabihin, palaging sinasalamin ng mga halaga ng katangian ang pinakabagong datos mula sa aplikasyon ninyo.

Pagsala sa Inbox#

Salain ang mga usapan ayon sa halaga ng katangian gamit ang filter bar ng Inbox o ang naka-save na View. Magdagdag ng kondisyong Property, piliin ang katangian ayon sa pangalan — inililista ng picker ang bawat depinisyon sa lahat ng ahente ninyo at tumatanggap din ito ng raw na key na walang depinisyon — pagkatapos ay pumili ng halaga. Nagmumungkahi ang field ng halaga ng mga naobserbahang halaga at ng anumang enum na halaga habang nagta-type kayo.

Sa API, tumatanggap ang mga endpoint ng listahan ng usapan ng query parameter na cp.<key>=<value> (eksaktong alias ng attr.<key>). Walang malayang query syntax:

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

Pag-edit ng mga Halaga#

Itinatakda ng aplikasyon ninyo ang mga halaga ng katangian — sa pamamagitan ng integrasyon ng widget o ng API — at read-only ang mga ito sa panel ng detalye ng usapan. May link ang panel patungo sa profile ng contact, kung saan puwedeng tingnan at i-edit ng mga tagasuporta ang mga attribute ng contact (Contacts → contact → Attributes).

properties kumpara sa metadata

Katangian	properties	metadata
Schema	Nakatakda sa Mga Setting ng Ahente kasama ang mga uri	Malayang pares ng key at halaga
Nasasala	Oo, sa filter bar / mga naka-save na View (API: `cp.<key>` na param)	Hindi
Naeedit ng mga tagasuporta	Hindi — galing sa aplikasyon ninyo ang mga halaga; ineedit ang mga attribute ng contact sa profile ng contact	Hindi
Pagpapakita ayon sa uri	Oo (badge, link, petsa, boolean)	Payak na teksto lang
Autocomplete	Oo, may mungkahing halaga sa field ng halaga ng filter	Hindi

Gamitin ang metadata para sa mga pansamantalang field na hindi kailangang salain o ipakita ayon sa uri. Gamitin ang properties para sa nakaayos na datos na aktibong gagamitin ng koponan ninyo sa segmentasyon at daloy ng trabaho.