PostChatMessage

Sends a potentially richer member chat message. By convention, content should contain a field named text for plain-text content. Returns the id of the message created.

Service	Operation
chat	POST_CHAT_MESSAGE

Method Parameters

Parameter	Description
channelId	The chat channel to post to
contentJson	The json content of the message. Split into chatMessage and jsonRich for plain text and json content respectively.
recordInHistory	Set to false if the message shouldn't be recorded to history. Useful for sending non-conversational messages, like when users join a room, etc.

Usage

http://localhost:3000

C#

string channelId = "22817:gl:CHAT_TRADE"; // APP_ID:CHANNEL_TYPE:CHANNEL_ID
string text = "Looking to sell a couch for 105 gold coins.";
Dictionary<string, object> sellItem = new Dictionary<string, object>
{
    {"ITEM_TYPE", "COUCH"},
    {"ITEM_ID", "d05a5b9d-374e-41e2-a498-c7387bf15c76"},
    {"PRICE", "105"},
    {"CURRENCY", "GOLDCOINS"}
};
Dictionary<string, object> rich = new Dictionary<string, object>
{
    {"SELL_ITEM", sellItem}
};
var contentJson = JsonFx.Json.JsonWriter.Serialize(new Dictionary<string, object>
{
    {"rich", rich},
    {"text", text}
});

bool recordInHistory = true;
SuccessCallback successCallback = (response, cbObject) =>
{
    Dictionary<string, object> jsonMessage =
        (Dictionary<string, object>) JsonFx.Json.JsonReader.Deserialize(response);
    Dictionary<string, object> jsonData = (Dictionary<string, object>) jsonMessage["data"];

    var msgId = jsonData["msgId"].ToString();
    string logMessage = string.Join(" | ", new[] {msgId});
    Debug.Log(logMessage); // 783733181125648
};
FailureCallback failureCallback = (status, code, error, cbObject) =>
{
    Debug.Log(string.Format("[PostChatMessage Failed] {0}  {1}  {2}", status, code, error));
};

_bc.ChatService.PostChatMessage(channelId, contentJson, recordInHistory,
    successCallback, failureCallback);

C++

const char *channelId = "55555:gl:bcDev";
const char *contentJson = "{\"text\":\"Hello world\",\"custom\":{\"somethingCustom\":\"wow\"}}";
bool recordInHistory = true;
_bc->getChatService()->postChatMessage(channelId, contentJson, recordInHistory, this);

Objective-C

NSString *channelId = @"55555:gl:bcDev";
NSString *contentJson = @"{\"text\":\"Hello world\",\"custom\":{\"somethingCustom\":\"wow\"}}";
bool recordInHistory = true;
BCCompletionBlock successBlock;      // define callback
BCErrorCompletionBlock failureBlock; // define callback

[[_bc chatService] postChatMessage:channelId
                contentJson:contentJson
            recordInHistory:recordInHistory
            completionBlock:successBlock
       errorCompletionBlock:failureBlock
                   cbObject:nil];

Java

String channelId = "22817:gl:CHAT_TRADE"; // APP_ID:CHANNEL_TYPE:CHANNEL_ID
String contentJson = "{\"text\":\"Hello world\",\"custom\":{\"somethingCustom\":\"wow\"}}";
boolean recordInHistory = true;
this; // implements IServerCallback

_bc.getChatService().postChatMessage(channelId, contentJson, recordInHistory, this);

public void serverCallback(ServiceName serviceName, ServiceOperation serviceOperation, JSONObject jsonData)
{
    System.out.print(String.format("Success | %s", jsonData.toString()));
}
public void serverError(ServiceName serviceName, ServiceOperation serviceOperation, int statusCode, int reasonCode, String jsonError)
{
    System.out.print(String.format("Failed | %d %d %s", statusCode,  reasonCode, jsonError.toString()));
}

JavaScript

var channelId = "22817:gl:CHAT_TRADE"; // APP_ID:CHANNEL_TYPE:CHANNEL_ID
var contentJson = {text: "Looking to sell a couch for 105 gold coins.", SELL_ITEM: {ITEM_TYPE: "COUCH"}};
var rnecordIHistory = true;

_bc.chat.postChatMessage(channelId, contentJson, recordInHistory, result =>
{
    var status = result.status;
    console.log(status + " : " + JSON.stringify(result, null, 2));
});

Dart

var  channelId = "22817:gl:CHAT_TRADE";
var  contentJson = {text: "Looking to sell a couch for 105 gold coins.", SELL_ITEM: {ITEM_TYPE: "COUCH"}};
var rnecordIHistory = true;

ServerResponse result = await _bc.chatService.postChatMessage(channelId:channelId, contentJson:contentJson, rnecordIHistory:rnecordIHistory);

if (result.statusCode == 200) {
    print("Success");
} else {
    print("Failed ${result.error['status_message'] ?? result.error}");
}

Cloud Code

var chatProxy = bridge.getChatServiceProxy();
var contentJson = {};
contentJson.text = "Hellooooo!";
var rnecordIHistory = true;

var postResult = chatProxy.postChatMessage( channelId, contentJson, rnecordIHistory);
if (postResult.status == 200 ) {
    // Success!
}

Raw

{
    "service": "chat",
    "operation": "POST_CHAT_MESSAGE",
    "data": {
        "channelId": "55555:gl:bcDev",
        "content": {
            "text": "Hello world",
            "custom": {
                "somethingCustom": "wow"
            }
        },
        "recordInHistory": true
    }
}

JSON Response

{
    "status": 200,
    "data": {
        "msgId": "783347769003570"
    }
}

Common Error Code

Status Codes

Code	Name	Description
40601	RTT_NOT_ENABLED	RTT must be enabled for this feature
40603	CHAT_UNRECOGNIZED_CHANNEL	The specified channel is invalid