Стандартные поля объектов CRM

Ниже перечислены стандартные поля объектов CRM, возвращаемые блоком Найти объект Cloud Contact.

Примечание: пользовательские поля сохраняются с префиксом custom_.

История действий

_id

Идентификатор данного объекта истории действий.

Пример: _id: ObjectId("58c37dc25be74141236fc250")

account_id

Для действий с электронной почтой возвращает внутренний идентификатор точки входа почтового сценария.

Пример: account_id: "B5A69B62-9E37-48A0-8864-5E71E19148EE"

assigned_by_first_name

Зарезервировано.

assigned_by_last_name

Зарезервировано.

assigned_by_user_id

Зарезервировано.

assigned_from_first_name

Зарезервировано.

assigned_from_last_name

Зарезервировано.

assigned_from_user_id

Зарезервировано.

case_ids

Возвращает идентификаторы заявок, к которым относится данное действие. Учитывайте следующее:

• Для решения заявки по чату или голосовому каналу может потребоваться несколько обращений.
• Для писем и заметок допускается только одна заявка.

Пример: case_ids: [ObjectId("58b744a27477eb6d1076e645")]

created_time

Для чатов и голосовых вызовов возвращает время начала обращения, то есть момент его первого обнаружения системой. Для писем и заметок возвращает время создания записи, например получения входящего или отправки исходящего письма.

Пример: created_time: ISODate("2016-10-14T01:39:38.326Z")

direction

Для действий по обработке обращений указывает направление с учетом канала. Возможные значения: INBOUND, OUTBOUND, REPLY, FORWARD, AUTO_ACK.

Учитывайте следующее:

• Для чатов отображается INBOUND или OUTBOUND.
• Для писем возможны INBOUND, OUTBOUND, REPLY, FORWARD и AUTO_ACK.
• Для голосовых вызовов отображается INBOUND или OUTBOUND.

Пример: direction: "OUTBOUND"

email_id

Для действий с электронной почтой возвращает идентификатор текущего почтового обращения.

Пример: email_id: ObjectId("579a651f7477eb3c65b652d8")

event

Зарезервировано.

flagged

Указывает, отмечена ли запись истории действий флажком в истории заявки.

Пример: flagged: false

global_interaction_id

Для действий по обработке обращений возвращает глобальный идентификатор обращения (GIID).

Пример: global_interaction_id: "E9FF0804-A1E9-47CF-8D2F-60E684B21657"

has_voice_recording

Если запись голосовых вызовов включена, указывает наличие аудиозаписи данного обращения.

Пример: has_voice_recording: false

media_type

Возвращает тип обращения: EMAIL, CHAT, VOICE, CASE или NOTES.

Пример: media_type: "EMAIL"

original_email

Для действий с электронной почтой возвращает идентификатор исходного почтового обращения в заявке.

Пример: original_email_id: ObjectId("5790099c7477eb673f327780")

parties

Возвращает массив сведений об участниках действия. Тип участника может принимать значения CONTACT, SCENARIO, USER или UNIDENTIFIED. Значение USER относится к операторам и супервизорам.

Пример:

parties: [
 	{
 	 	party_type: 'USER',
 	 	user_id: "93B68CAB-9271-4B0A-AFB6-B9238CD36875",
 	 	first_name: "Edna",
 	 	last_name: "Partee",
 	 	notes: "",
 	 	disposition: "Product sold",
 	 	party_id: "58c1e0297477eb3f8d6552ec",
	 	start_time: ISODate("2017-03-14T19:15:06.784Z"),
 	 	duration: 338,
 	 	custom_address_verified: true,
 	 	custom_name_verified: true
 	 	service_id: "72452D33-A7B4-4A1A-914A-AFA4076A76C3",
 	}

 	{
 	 	party_type: 'CONTACT',
 	 	contact_id: ObjectId("552856a7e4b0acb4156ddd11"),
 	 	first_name: "John",
 	 	last_name: "Doe",
 	 	email: "john.doe@example.com",
 	 	party_id: "58c1e7137477eb3f8d655322",
 	 	start_time: ISODate("2017-03-14T19:15:44.784Z"),
 	 	duration: 300
	}

 	{
 	 	party_type: 'UNIDENTIFIED',
 	 	first_name: 'Wireless',
 	 	last_name:'Caller',
 	 	phone: '14155551212'
 	}

 	{
 	 	party_type: 'SCENARIO',
 	 	custom_address_verified: true,
 	 	custom_name_verified: true
 	}
]

pinned

Указывает, закреплена ли запись истории действий в истории заявки.

Пример: pinned: false

services

Перечисляет сервисы, участвовавшие в действии. Это отдельное свойство, не совпадающее с parties, поскольку сервис может участвовать в потерянном обращении или самообслуживании без участия оператора.

Пример:

services: [		
	{
		service_id: "72452D33-A7B4-4A1A-914A-AFA4076A76C3",
		service_name: "Maintenance Renewal"
	}
]

subject

Возвращает тему разговора.

Пример: subject: "TEST SUBJECT"

tenant_id

Возвращает идентификатор контакт-центра.

Пример: tenant_id: "EB95E6C6-A7A9-4581-83E7-7336FB8FC377"

thread_id

Возвращает идентификатор цепочки писем, если он настроен.

Пример: thread_id: "JX54YYN91FZH"

transferred_from_first_name

Зарезервировано.

transferred_from_last_name

Зарезервировано.

transferred_from_user_id

Зарезервировано.

Заявка

_id

Идентификатор данного объекта заявки.

Пример: _id: ObjectId("58c37dc25be74141236fc251")

case_number

Номер заявки, заданный в Рабочем месте оператора.

Пример: case_number: "2451"

case_status

Возвращает одно из состояний заявки: New — новая, Open — открыта, Pending — ожидает, Resolved — решена, Closed — закрыта.

Пример: case_status: "Pending"

case_title

Для почтовой заявки заголовок копируется из темы исходного письма. Оператор может изменить его при редактировании заявки.

Пример: case_title: "Mid-april Bulk email #1060 on Mon Oct 19 15:49:28 PDT 2015"

category_id

Возвращает идентификатор категории заявки.

Пример: category_id: "560AC234-D124-458F-8DFB-C11ADF48F1D2"

category_name

Возвращает настроенную категорию заявки.

Пример: category_name: "Maintenance Renewal"

cc

Перечисляет контакты, добавленные в копию.

Пример:

cc: [	
	{	
		contact_id: "5800375a7477eb4f25c630a7",
		first_name: "Jane",
		last_name: "Doe"
	}	
]

created_time

Время первоначального создания заявки, по GMT.

Пример: created_time: ISODate("2015-10-19T22:50:22.565Z")

customer_update_time

Для электронной почты указывает время получения последнего письма клиента. Для голосовых вызовов и чатов совпадает со свойством modified_time.

Пример: customer_update_time: ISODate("2016-11-03T23:49:41.454Z")

is_flagged

Указывает, отмечена ли заявка флажком. Этот признак не связан с флажком обращения.

Пример: is_flagged: true

is_pinned

Указывает, закреплена ли заявка. Этот признак не связан с закреплением писем.

Пример: is_pinned: true

modified_time

Время последнего изменения заявки или добавления в нее нового действия. Обычно соответствует завершению обращения, когда выполняется обновление. Время указано по GMT.

Пример: modified_time: ISODate("2016-11-03T23:49:41.454Z")

open_time

Время открытия заявки оператором, то есть перехода из состояния New в Open.

Пример: open_time: ISODate("2015-10-19T22:51:22.565Z")

pending_reason

Возвращает настроенные в контакт-центре причины ожидания Pending. Они присутствуют только у заявки в состоянии Pending.

Пример: pending_reason: "Waiting for info from customer"

pending_time

Время последнего перехода заявки в состояние Pending. Свойство pending_time присутствует только у заявок в состояниях Pending, Resolved и Closed. При нескольких переходах в Pending указывается время последнего перехода.

Пример: pending_time: ISODate("2015-10-19T22:53:22.565Z")

priority

Зарезервировано.

reporter_first_name

Имя заявителя, то есть клиента или другого человека, обратившегося в контакт-центр, на момент получения этих данных.

Пример: reporter_first_name: "John"

reporter_id

Идентификатор заявителя, то есть клиента или другого человека, обратившегося в контакт-центр. Берется из контакта исходного обращения заявки.

Пример: reporter_id: ObjectId("5581ef0de4b02187dd0a555f")

reporter_last_name

Фамилия заявителя, то есть клиента или другого человека, обратившегося в контакт-центр, на момент получения этих данных.

Пример: reporter_last_name: «Doe”

resolved_time

Время перевода заявки в состояние Resolved. Используется для автоматического перехода в Closed. Свойство resolved_time присутствует только у заявок в состояниях Resolved и Closed. При нескольких переходах в Resolved указывается время последнего перехода.

Пример: resolved_time: ISODate("2016-11-03T23:49:41.454Z")

response_sla_start_time

Зарезервировано.

response_sla_target_time

Зарезервировано.

response_sla_time

Зарезервировано.

sentiment

Числовая оценка тональности последнего обращения клиента. На основании анализа тональности она показывает, насколько негативным или позитивным было обращение.

Пример: sentiment: 0.97

tenant_id

Возвращает идентификатор контакт-центра.

Пример: tenant_id: "EB95E6C6-A7A9-4581-83E7-7336FB8FC377"

users

Перечисляет операторов, участвовавших в обработке этой заявки.

Пример:

users: [		
		user_id: "93B68CAB-9271-4B0A-AFB6-B9238CD36875"
]

Компания

_id

Идентификатор данного объекта компании.

Пример: _id: ObjectId("58c37dc25be74141236fc252")

company_name

Название компании, заданное в Рабочем месте оператора.

Пример: company_name: "Warehousing Inc. 4"

created_time

Время первоначального создания объекта компании, по GMT.

Пример: created_time: ISODate("2015-03-24T23:57:13.440Z")

employees

Численность сотрудников компании, заданная в Рабочем месте оператора.

Пример: employees: "123"

modified_time

Время последнего изменения объекта компании, по GMT.

Пример: modified_time: ISODate("2016-10-06T21:22:29.850Z")

revenue

Выручка компании, заданная в Рабочем месте оператора.

Пример: revenue: "100 million"

tenant_id

Возвращает идентификатор контакт-центра.

Пример: tenant_id: "EB95E6C6-A7A9-4581-83E7-7336FB8FC377"

web_url

URL веб-сайта компании, заданный в Рабочем месте оператора.

Пример: web_url: "www.example.com"

Контакт

_id

Идентификатор данного объекта контакта.

Пример: _id: ObjectId("58c37dc25be74141236fc253")

addresses

Адреса контакта, заданные в Рабочем месте оператора. Возможные типы: PRIMARY, BILLING, SHIPPING и OTHER.

Пример:

addresses: [		
	{	
		type: "PRIMARY",
		postcode: "90670",
		state: "CA",
		city: "Santa Fe Springs",
		address_line1: "1111 Bayhill Dr.",
		address_line2: "Suite 275",
		country: "USA",
		id: "579936537477eb39496a4bea"
	}	
]

bpo_client_id

Зарезервировано.

company_id

Возвращает идентификатор компании, с которой связан контакт.

Пример: company_id: ObjectId("5511f9d9e4b0033ff9b8bc99")

created_time

Время первоначального создания контакта, по GMT.

Пример: created_time: ISODate("2015-04-10T23:03:03.322Z")

dob

Дата рождения контакта (DOB), заданная в Рабочем месте оператора.

Пример: dob: ISODate("2001-08-14T00:00:00.000Z")

emails

Адреса электронной почты контакта, заданные в Рабочем месте оператора. Возможные типы: PRIMARY, BUSINESS и PRIVATE.

Пример:

emails: [		
	{	
		type: "PRIMARY",
		email_address: "something@contact-center.example",
		id: "579936537477eb39496a4be9"
	}	
]

external_ids

Зарезервировано.

first_name

Имя контакта, заданное в Рабочем месте оператора.

Пример: first_name: "Jeanne"

last_name

Фамилия контакта, заданная в Рабочем месте оператора.

Пример: last_name: "Wengler"

messengers

Сведения о мессенджере контакта: название или тип мессенджера, например LINE, идентификатор учетной записи интеграции контакт-центра и внешний идентификатор контакта в мессенджере.

Пример:

messengers [
	{
		type: "line",
		id: "3289396573",
		user_id: "U6b4b0a5c0e5a0269fcba1b06ccf09ea5"
	},
	{
		type: "facebook",
		id: "4937586736",
		user_id: "X7a3c1b6d1f6b1370gdcb2c17bbg10fb6"
	}
]

modified_time

Время последнего изменения контакта, по GMT.

Пример: modified_time: ISODate("2016-09-24T00:11:48.205Z")

phone

Номера телефонов контакта, заданные в Рабочем месте оператора. Возможные типы: BUSINESS, HOME, MOBILE и FAX.

Пример:

phones: [		
	{	
		type: "MOBILE",
		phone: "16505551212",
		id: "579fff287477eb45790af319"
	},	
	{	
		type: "HOME",
		phone: "14155551212",
		id: "57e2d6437477eb660c92899d"
	},	
]

picture

Фотография контакта.

position

Должность контакта, заданная в Рабочем месте оператора.

Пример: position: "Sr. Support Engineer"

segment

Сегмент контакта, заданный в Рабочем месте оператора.

Пример: segment: "Gold"

social_links

Зарезервировано.

summary

Краткое описание контакта, заданное в Рабочем месте оператора.

Пример: summary: "Jeanne works in the main office M - Th; off-site office F"

tenant_id

Возвращает идентификатор контакт-центра.

Пример: tenant_id: "EB95E6C6-A7A9-4581-83E7-7336FB8FC377"

title

Обращение к контакту, заданное в Рабочем месте оператора.

Пример: title: "Miss"

Электронное письмо

_id

Идентификатор данного объекта письма.

Пример: _id: ObjectId("58c37dc25be74141236fc254")

CC

Возвращает имена и адреса электронной почты из поля Cc в виде массива объектов, если поле присутствует в письме.

Пример:

CC: [
             {
                  “name”: “Alice B”, 
                  “address”: “alice@b.com”
             }
    ]

From

Возвращает имена и адреса электронной почты из поля Отправитель (From) в виде массива объектов.

Пример:

From: [
                {
                     “name”: “Alice B”, 
                     “address”: “alice@b.com”
                }
      ]

HTML

Возвращает строку с HTML-телом письма, если оно присутствует. Если в объекте письма несколько частей HTML, возвращает массив.

Пример:

html: "<div class=\"x-eml-message x-eml-level-0\" lang=\"EN-US\" link=\"blue\" vlink=\"purple\"> \n <meta http-equiv=\"Content-Type\" content=\"text/html; charset=us-ascii\" />\n <meta name=\"Generator\" content=\"Microsoft Word 14 (filtered medium)\" />\n <style><!--\r\n/* Font Definitions */\r\n@font-face\r\n\t{font-family:\"Cambria Math\";\r\n\tpanose-1:2 4 5 3 5 4 6 3 2 4;}\r\n@font-face\r\n\t{font-family:Calibri;\r\n\tpanose-1:2 15 5 2 2 2 4 3 2 4;}\r\n/* Style Definitions */\r\np.MsoNormal, li.MsoNormal, div.MsoNormal\r\n\t{margin:0in;\r\n\tmargin-bottom:.0001pt;\r\n\tfont-size:11.0pt;\r\n\tfont-family:\"Calibri\",\"sans-serif\";}\r\na:link, span.MsoHyperlink\r\n\t{mso-style-priority:99;\r\n\tcolor:blue;\r\n\ttext-decoration:underline;}\r\na:visited, span.MsoHyperlinkFollowed\r\n\t{mso-style-priority:99;\r\n\tcolor:purple;\r\n\ttext-decoration:underline;}\r\nspan.EmailStyle17\r\n\t{mso-style-type:personal-compose;\r\n\tfont-family:\"Calibri\",\"sans-serif\";\r\n\tcolor:windowtext;}\r\n.MsoChpDefault\r\n\t{mso-style-type:export-only;\r\n\tfont-family:\"Calibri\",\"sans-serif\";}\r\n@page WordSection1\r\n\t{size:8.5in 11.0in;\r\n\tmargin:1.0in 1.0in 1.0in 1.0in;}\r\ndiv.WordSection1\r\n\t{page:WordSection1;}\r\n--></style>\n <!--[if gte mso 9]><xml>\r\n<o:shapedefaults v:ext=\"edit\" spidmax=\"1026\" />\r\n</xml><![endif]-->\n <!--[if gte mso 9]><xml>\r\n<o:shapelayout v:ext=\"edit\">\r\n<o:idmap v:ext=\"edit\" data=\"1\" />\r\n</o:shapelayout></xml><![endif]-->\n <div class=\"WordSection1\">\n  <p class=\"MsoNormal\">\n   <o:p>\n     \n   </o:p></p>\n </div>\n</div>"

Subject

Возвращает строку из поля Тема письма, если поле присутствует.

Пример: Subject : "10/20 attempt #3"

Text

Возвращает строку с текстовым телом письма, если оно присутствует. Если в объекте письма несколько текстовых частей, возвращает массив.

Пример: text : "\r\n\r\n"

To

Возвращает адреса электронной почты и имена, если они доступны, из поля Получатель (To) в виде массива объектов.

Пример:

To: [
           {
                “address”: “alice@b.com”
           }

]

|