MyChat Integration API: MCIAPI_CS_SendPrivateMessage, отправить приватное сообщение

MyChat Integration API: MCIAPI_CS_SendPrivateMessage, отправить приватное сообщение

Отправить текстовое приватное сообщение любому пользователю MyChat.

 

Синтаксис

{

 "cmd"       : "0002",

 "ServerKey" : "iddqd",

 "APIStype"  : "mydata",

 

 "UserFrom"  : "0",

 "UserTo"    : "user@test.com",

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

 "MsgType"   : 1

}

 

Если "UserFrom" и "UserTo" будут совпадать (вы пытаетесь отправить сообщение самому себе), тогда вместо отправителя будет автоматически подставлен UIN=0 (встроенный робот).

 

Параметры

Параметр

Тип

Значение

cmd

string

"0002", номер команды MCIAPI_CS_SendPrivateMessage;

ServerKey

string

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

APIStype

string

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

UserFrom

string

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

UserTo

string

получатель сообщения. Можно задавать UIN, email или ник пользователя;

Msg

string

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

MsgType

integer

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

 

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

{

 "cmd"   : "0002",

 "State" : 0,

 "UINTo" : 17

}

 

Поле

Тип

Значение

cmd

string

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

State

integer

текущий сетевой статус получателя сообщения;

UINTo

integer

уникальный идентификатор получателя сообщения, UIN.

 

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

#2, MCIAPI_Error_WrongSenderUser

#3, MCIAPI_Error_WrongReceiverUser

#4, MCIAPI_Error_EmptyMessage

#5, MCIAPI_Error_WrongIntegrationKey

#11, MCIAPI_Error_WrongDomainUserReceiver

#12, MCIAPI_Error_WrongDomainUserSender

 

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

MCIAPI_CS_AddBBSMessage

MCIAPI_CS_SendChannelMessage