Редактирование контакта в адресной книге
Метод | update.contacts |
---|---|
Описание | Редактирование контакта в адресной книге |
Кому доступен | Агент, Клиент |
Возможно частичное обновление. Если обновляется массив данных, то переданный массив будет полностью заменять существующий.
Параметры запроса
Название | Тип | Обязательный | Допустимые значения | Описание |
---|---|---|---|---|
access_token |
string | да | Ключ сессии аутентификации | |
id |
number | да | Уникальный идентификатор контакта в адресной книге | |
user_id |
number | нет | Уникальный идентификатор пользователя клиента агента от имени которого делается запрос Является обязательным для агентаДля получения списка пользователей клиента необходимо использовать метод "get.customer_users" |
|
first_name |
string | нет | Имя контакта | |
last_name |
string | да | Фамилия контакта | |
patronymic |
string | нет | Отчество контакта | |
emails |
array | нет | Максимум 10 адресов | Адрес электронной почты контакта. E-mail должен быть уникальным в списке. |
phone_numbers |
array | да | Максимум 10 номеров | Список номеров контакта в формате E164 Номер должен быть уникальным в списке. |
personal_manager_id |
number | нет | Персональный менеджер - это сотрудник, отвечающий за работу с клиентом. При создании сценария "Переадресация на персонального менеджера" звонки клиентов будут поступать персональным менеджерам без дополнительных настроек списка номеров вызывающего абонента и списка телефонов сотрудников. Для получения списка сотрудников используется метод "get.employees" |
|
organization_id |
number | нет | Уникальный идентификатор организации. Для получения списка организаций см. метод см. метод "get.contact_organizations" . |
|
groups |
array | нет | Список уникальных идентификаторов групп в которых состоит контакт, см. метод "get.group_contacts" . |
JSON структура запроса
{
"jsonrpc":"2.0",
"method":"update.contacts",
"id":"number",
"params":{
"access_token":"string",
"id":"number",
"user_id":"number",
"last_name":"string",
"first_name":"string",
"patronymic":"string",
"emails":[
"email"
],
"groups":[
"group_id"
],
"phone_numbers":[
"number"
],
"personal_manager_id":"number",
"organization_id":"number"
}
}
JSON структура ответа
{
"jsonrpc":"2.0",
"id":"number",
"result":{
}
}
Список возвращаемых ошибок
Смотрим раздел "Список ошибок для методов с глаголом update"