MyChat Integration API: MCIAPI_CS_SendChannelMessage, отправка сообщения в конференцию

MyChat Integration API: MCIAPI_CS_SendChannelMessage, отправка сообщения в конференцию

Отправить текстовое сообщение без шрифтового оформления в конференцию от имени произвольного пользователя. Этот пользователь должен быть онлайн и находиться в этой конференции.

 

Синтаксис

{

 "cmd"       : "0004",

 "ServerKey" : "iddqd",

 "APIStype"  : "mydata",

 

 "UserFrom"  : "0",

 "UID"       : 12,

 "Msg"       : "bla-bla-bla",

 "MsgType"   : 1

}

 

Параметры

Параметр

Тип

Значение

cmd

string

"0004", номер команды MCIAPI_CS_SendChannelMessage;

ServerKey

string

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

APIStype

string

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

UserFrom

string

пользователь-отправитель. По умолчанию "0". Можно задавать UIN, email или ник пользователя. Пользователь обязательно должен реально присутствовать в конференции;

UID

integer

уникальный числовой идентификатор текстовой конференции (UID). Можно посмотреть в списке активных конференций на сервере;

Msg

string

текст сообщения;

MsgType

integer

тип сообщения, необязательный параметр. Если тип сообщения — не простой текст, тогда в Msg будет JSON объект или многострочный текст.

 

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

{

 "сmd"     : "0004",

 "UINFrom" : 0,

 "UID"     : 12

}

 

Поле

Тип

Значение

cmd

string

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

UINFrom

integer

уникальный идентификатор отправителя сообщения (UIN), который определил сервер по входящему параметру UserFrom;

UID

integer

уникальный идентификатор текстовой конференции, куда было успешно отправлено сообщение.

 

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

#2, MCIAPI_Error_WrongSenderUser

#5, MCIAPI_Error_WrongIntegrationKey

#6, MCIAPI_Error_UnknownUID

#7, MCIAPI_Error_UserNotInChannel

#12, MCIAPI_Error_WrongDomainUserSender

 

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

MCIAPI_CS_AddBBSMessage

MCIAPI_CS_SendPrivateMessage