Команда для добавления пользователя в общий список контактов. После множественных добавлений или изменений нужно будет вызвать MCIAPI_CS_CommonContactsRebuild, чтобы обновить кеши контактов у онлайн-пользователей, либо подождать, пока система сделает это автоматически.

 

Синтаксис

{

 "cmd"       : "001B",

 "ServerKey" : "iddqd",

 "APIStype"  : "mydata",

 "UIN"       : 17,

 "GroupID"   : 24

}

 

Параметры

Параметр

Тип

Значение

ServerKey

string

ключ Integration API, задаётся в настройках сервера;

APIStype

string

тип интеграции. Можно задавать произвольную строку;

UIN

integer

идентификатор пользователя, >0;

GroupID

integer

идентификатор подразделения в общем списке контактов. Его можно узнать с помощью запроса MCIAPI_CS_GetDepartmentIDByTextPath.

 

Результат работы

{

  "cmd"     : "001B",

  "UIN"     : 17,

  "GroupID" : 24

}

 

Поле

Тип

Значение

cmd

string

HEX-номер команды, которая была успешно выполнена;

UIN

integer

идентификатор пользователя, который был добавлен в общий список контактов;

GroupID

integer

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

 

Возможные ошибки

#5, MCIAPI_Error_WrongIntegrationKey

#19, MCIAPI_Error_UINNotFound

#28, MCIAPI_Error_CannotWorkWithRobot

#31, MCIAPI_Error_WrongDepartmentID

#34, MCIAPI_Error_CommonContactsIsEmpty

#35, MCIAPI_Error_UINIsAlreadyInCommonContactList
 

Ещё посмотреть

MCIAPI_CS_CommonContactsRebuild

MCIAPI_CS_GetDepartmentIDByTextPath

MCIAPI_CS_MoveUserToDepartment