Skip to content

Добавление контакта в адресную книгу

Метод create.contacts
Описание Добавление контакта в адресную книгу
Кому доступен Агент, Клиент

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

Название Тип Обязательный Допустимые значения Описание
access_token string да Ключ сессии аутентификации
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"

Параметры ответа

Название Тип Обязательный Описание
id number да Уникальный идентификатор контакта в адресной книге

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

{
  "jsonrpc":"2.0",
  "method":"create.contacts",
  "id":"number",
  "params":{
    "access_token":"string",
    "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":{
    "id":"number"
  }
}

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

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