MyChat Integration API: MCAPI_CS_AddUserToCommonContacts

MyChat Integration API: MCIAPI_CS_AddUserToCommonContacts

Команда для добавления пользователя в общий список контактов. После множественных добавлений или изменений нужно будет вызвать 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" : 27

}

 

Поле

Тип

Значение

Cmd

integer

номер команды, которая была успешно выполнена, равно 27 (HEX 001B).

 

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

#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