Редактирование сотрудника

Метод	`update.employees`
Описание	Создание сотрудника
Кому доступен	Агент, Клиент

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

Параметры запроса

Название	Тип	Обязательный	Допустимые значения	Описание
`access_token`	string	да		Ключ сессии аутентификации
`id`	number	да		Уникальный идентификатор сотрудника
`user_id`	number	нет		Уникальный идентификатор пользователя клиента агента от имени которого делается запрос Является обязательным для агента Для получения списка пользователей клиента необходимо использовать метод "get.customer_users"
`first_name`	string	нет		Имя сотрудника
`last_name`	string	да		Фамилия сотрудника
`patronymic`	string	нет		Отчество сотрудника
`status`	enum	нет	available break do_not_disturb not_at_workplace not_at_work auto_out_call unknown	Параметр будет удален в ближайшее время. Используйте вместо него параметр status_id Статус сотрудника available - Доступен break - Перерыв do_not_disturb - Не беспокоить not_at_workplace - Нет на месте not_at_work - Нет на работе auto_out_call - Исходящий обзвон unknown - Неизвестно
`status_id`	number	нет		Уникальный идентификатор статуса. Для получения полного списка статусов необходимо использовать метод "get.statuses"
`calls_available`	boolean	нет	`true`, `false`	Параметр будет удален в ближайшее время. Используйте вместо него параметры: in_external_allowed_call_directions, in_internal_allowed_call_directions Доступность для звонков
`allowed_in_call_types`	array	нет	internal external	Параметр будет удален в ближайшее время. Используйте вместо него параметры: in_external_allowed_call_directions, in_internal_allowed_call_directions Какие типы входящих звонков разрешены сотруднику internal - внутренние звонки от сотрудников компании external - внешние звонки от клиентов
`in_external_allowed_call_directions`	array	нет	in out	Какие направления вызовов разрешены сотруднику для входящих внешних звонков in - входящие вызовы out - исходящие вызовы
`in_internal_allowed_call_directions`	array	нет	in out	Какие направления вызовов разрешены сотруднику для входящих внутренних звонков in - входящие вызовы out - исходящие вызовы
`allowed_out_call_types`	array	нет	internal external	Параметр будет удален в ближайшее время. Используйте вместо него параметры: out_external_allowed_call_directions, out_internal_allowed_call_directions Какие типы исходящих звонков разрешены сотруднику internal - внутренние звонки на сотрудников компании external - звонки за пределы компании
`out_external_allowed_call_directions`	array	нет	in out	Какие направления вызовов разрешены сотруднику для исходящих внешних звонков in - входящие вызовы out - исходящие вызовы
`out_internal_allowed_call_directions`	array	нет	in out	Какие направления вызовов разрешены сотруднику для исходящих внутренних звонков in - входящие вызовы out - исходящие вызовы
`email`	string	нет		Адрес электронной почты сотрудника
`call_recording`	enum	нет	`all` - для всех звонков; `in` - только для входящих; `out` - только для исходящих; `off` - отключена	Статус записи разговоров Зависит от компонента `"recording"`
`schedule_id`	number	нет		График активности
Тренер
`coach`	object	нет		Тренер для сотрудника Зависит от компонента `"trainer"`
`coach_always_enabled`	boolean	нет	`true`, `false`	При активации опции все входящие звонки сотрудника будут дублироваться его тренеру. Значение `"true"` возможно установить если задан параметр `"coach_id"`.
`coach_id`	number	нет		Уникальный идентификатор тренера
Группы в которых состоит сотрудник
`groups`	array	нет		Список уникальных идентификаторов групп в которых состоит сотрудник
Телефоны
`phone_numbers`	array	да	10 штук	Список телефонов сотрудника Важно понимать, что при создании нового сотрудника номер уже может существовать у другого сотрудника и если номеру переданы новые параметры, то они будут так же обновлены уже существующему номеру
`phone_number`	string	да		Номер телефона сотрудника
`channels_count`	number	нет	От 1 до 150	Количество линий на телефоне
`dial_time`	number	нет	От 1 до 100	Время дозвона по телефону
`status`	enum	нет	`active`, `inactive`	Статус номера.
Внутренний номер
`extension`	object	нет		Внутренний номер сотрудника
`extension_phone_number`	string	да	Максимальная длина 5	Внутренний номер
`extension_voice_mail_enabled`	boolean	да	`true`, `false`	В случае, если все номера, указанные для этого сотрудника в списке телефонов, заняты, то звонящему абоненту будет предложено оставить голосовое сообщение.
`extension_queue_enabled`	boolean	да	`true`, `false`	В случае, если все номера, указанные для этого сотрудника в списке телефонов, заняты, то звонящий абонент встанет в очередь на повторный дозвон до телефонов в списке и будет ждать первый освободившийся номер.
Является ли сотрудник оператором чата
`operator`	object	нет		Оператор рабочего места Зависит от компонента `"consultant"`
`operator_display_name`	string	нет		Имя оператора в чате
`operator_login`	string	да		Логин сотрудника для входа в приложение «Рабочее место оператора»
`operator_password`	string	да	Минимальная длина 8	Пароль сотрудника для входа в приложение «Рабочее место оператора»
`operator_position_id`	number	нет		Должность сотрудника в подписи
`operator_offline_message_enabled`	boolean	нет	`true`, `false`	Разрешено ли обрабатывать заявки
`operator_invite_to_chat_enabled`	boolean	нет	`true`, `false`	Разрешено ли приглашать в чат
`operator_chat_enabled`	boolean	нет	`true`, `false`	Разрешено ли участвовать в чатах с посетителями
`operator_sites`	array	нет		Список уникальных идентификаторов сайтов для которых доступен сотрудник.

JSON структура запроса

Копировать

{
 "jsonrpc":"2.0",
 "id":"number",
 "method":"update.employees",
 "params":{
  "access_token":"string",
  "user_id":"number",
  "first_name":"string",
  "last_name":"string",
  "patronymic":"string",
  "status": "enum",
  "calls_available":"boolean",
  "allowed_in_call_types": "array",
  "in_external_allowed_call_directions": "array",
  "in_internal_allowed_call_directions": "array",
  "allowed_out_call_types": "array",
  "out_external_allowed_call_directions": "array",
  "out_internal_allowed_call_directions": "array",
  "email":"string",
  "groups":[
   "group_id"
  ],
  "call_recording":"enum",
  "schedule_id":"number",
  "coach":{
   "coach_always_enabled":"boolean",
   "coach_id":"number"
  },
  "phone_numbers":[
   {
    "phone_number":"string",
    "channels_count":"number",
    "dial_time":"number",
    "status":"enum"
   }
  ],
  "extension":{
   "extension_phone_number":"string",
   "extension_voice_mail_enabled":"boolean",
   "extension_queue_enabled":"boolean"
  },
  "operator":{
   "operator_login":"string",
   "operator_display_name": "string",
   "operator_password":"string",
   "operator_position_id":"number",
   "operator_offline_message_enabled":"boolean",
   "operator_invite_to_chat_enabled":"boolean",
   "operator_chat_enabled":"boolean",
   "operator_sites":[
    "site_id"
   ]
  }
 }
}

JSON структура ответа

Копировать

{
 "jsonrpc":"2.0",
 "id":"number",
 "result":{

 }
}

Список возвращаемых ошибок

Смотрим раздел "Список ошибок для методов с глаголом update"

Оборудование

Редактирование сотрудника

Параметры запроса

JSON структура запроса

JSON структура ответа

Список возвращаемых ошибок