Sifa za mwasiliani

Fafanua sehemu maalum kwa mawasiliano yako — kama aina ya akaunti, eneo, au ngazi ya mkataba — na uzipitishe kupitia wijeti. Sifa huonyeshwa kwenye wasifu wa mwasiliani, zinaweza kuhaririwa na maafisa, na kuchujwa katika Kikasha.

Muhtasari#

Sifa za mwasiliani hukuruhusu kuambatisha data iliyopangwa kwenye mazungumzo zaidi ya sehemu zilizojengwa ndani (email, name, userId). Tofauti na metadata isiyo na muundo maalum, sifa zina skima iliyofafanuliwa yenye aina, lebo, na uthibitishaji — sawa na sehemu maalum katika HubSpot au Salesforce.

Fafanua skima

Tengeneza fafanuzi za sifa katika Agent Settings kwa aina kama string, number, enum, boolean, date, url

Pitisha kutoka wijeti

Tuma thamani za sifa kupitia Respondo.identify() — huhifadhiwa na kuonyeshwa kiotomatiki

Chuja na hariri

Chuja mazungumzo kwa thamani za sifa katika Kikasha. Maafisa wanaweza kuona na kuhariri sifa za mwasiliani kwenye wasifu wa mwasiliani.

Kufafanua sifa#

Sifa hufafanuliwa kwa kila wakala katika Agent Settings → Contact Properties. Kila sifa ina:

Sehemu	Maelezo
key	Kitambulisho cha kipekee kinachotumika katika msimbo. Huzalishwa kiotomatiki kutoka kwenye lebo (kinaweza kuhaririwa). Herufi ndogo, tarakimu na alama ya chini; lazima kianze na herufi; herufi 2-63. Funguo za mfumo (`user_id`, `visitor_id`, `timezone`, `page_url`, …) zimehifadhiwa. Mfano: `account_type`
label	Jina linalosomeka na binadamu linaloonyeshwa katika dashibodi. Mfano: "Account Type"
type	Aina ya thamani: `string`, `number`, `boolean`, `enum`, `date`, `url`
enum_values	Kwa aina ya `enum` — orodha ya thamani zinazoruhusiwa. Mfano: `["starter", "pro", "enterprise"]`
is_filterable	Imehifadhiwa kwa udhibiti wa vichujio wa baadaye; huhifadhiwa pamoja na fasili, lakini kichaguzi cha vichujio cha Kikasha kwa sasa huorodhesha sifa zote zilizofafanuliwa (chaguo-msingi: true)
is_visible	Imehifadhiwa kwa udhibiti wa uonyeshaji wa baadaye; huhifadhiwa pamoja na fasili lakini bado haitekelezwi katika kiolesura (chaguo-msingi: true)

Hadi sifa 50 kwa kila wakala. Sifa zinaweza kupangwa upya kwa kuburuta na kuachia ndani ya kiolesura cha mipangilio.

Pitisha thamani za sifa katika sehemu ya properties ya Respondo.identify(). Funguo lazima zilingane na fafanuzi za sifa kutoka Agent Settings.

Muunganisho wa wijetijavascript

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

Thamani zote za sifa hupitishwa kama string. Dashibodi hushughulikia uonyeshaji kulingana na aina (mfano, boolean → Yes/No, url → kiungo kinachobofyeka, enum → beji).

Kijisehemu cha muunganisho#

Kijisehemu cha muunganisho huonekana kiotomatiki chini ya Agent Settings → Contact Properties mara tu unapofafanua angalau sifa moja, kikiwa na funguo zako zote za sifa zimejazwa tayari. Bofya Copy kukichukua na ukibandike ndani ya programu yako. Kijisehemu kinachozalishwa pia hujumuisha nafasi ya userHash kwa uthibitishaji wa utambulisho (HMAC-SHA256).

Jinsi thamani zinavyohifadhiwa#

Thamani za sifa huhifadhiwa katika sehemu ya JSONB ya metadata ya mazungumzo zikiwa na kiambishi cp_. Kwa mfano, sifa yenye ufunguo account_type huhifadhiwa kama cp_account_type.

Sifa husasishwa kwa kila ujumbe — ikiwa wijeti itatuma thamani mpya, hufunika zile zilizopo tayari. Hii ina maana thamani za sifa daima huakisi data ya karibuni zaidi kutoka programu yako.

Kuchuja katika Kikasha#

Chuja mazungumzo kwa thamani za sifa ukitumia upau wa vichujio wa Kikasha au Mwonekano uliohifadhiwa. Ongeza sharti la Property, chagua sifa kwa jina — kichaguzi huorodhesha kila fasili katika mawakala wako wote na pia hukubali ufunguo ghafi usio na fasili — kisha chagua thamani. Sehemu ya thamani hupendekeza thamani zilizoonekana na thamani zozote za enum unapoandika.

Kupitia API, endpoint za orodha ya mazungumzo hukubali kigezo cha hoja cha cp.<key>=<value> (jina mbadala kamili la attr.<key>). Hakuna sintaksia ya hoja ya maandishi huru:

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

Kuhariri thamani#

Thamani za sifa huwekwa na programu yako — kupitia muunganisho wa wijeti au API — na ni za kusoma tu katika paneli ya maelezo ya mazungumzo. Paneli huunganisha kwenye wasifu wa mwasiliani, ambapo maafisa wanaweza kuona na kuhariri sifa za mwasiliani (Contacts → mwasiliani → Attributes).

Sifa dhidi ya metadata

Kipengele	properties	metadata
Skima	Hufafanuliwa katika Agent Settings pamoja na aina	Jozi za ufunguo-thamani zisizo na muundo
Inaweza kuchujwa	Ndiyo, kupitia upau wa vichujio / Mionekano iliyohifadhiwa (API: kigezo cha `cp.<key>`)	Hapana
Inaweza kuhaririwa na maafisa	Hapana — thamani hutoka kwenye programu yako; sifa za mwasiliani huhaririwa kwenye wasifu wa mwasiliani	Hapana
Uonyeshaji kwa aina	Ndiyo (beji, viungo, tarehe, boolean)	Maandishi ya kawaida pekee
Kujaza kiotomatiki	Ndiyo, mapendekezo ya thamani katika sehemu ya thamani ya kichujio	Hapana

Tumia metadata kwa sehemu za papo hapo zisizohitaji kuchujwa au uonyeshaji kwa aina. Tumia properties kwa data iliyopangwa ambayo timu yako itaitumia kikamilifu kwa ugawaji wa makundi na mtiririko wa kazi.