Messaging

If you need translation feature, see below.

Message translation feature is provided through Google Cloud Translation. To use this feature, register an appropriate Google Cloud Service Account Key on our dashboard.

• Setting translationLanguage property in TPMessageRetrievalParams object with language code (ISO-639) retrieves message with its translated text.

• Setting translationLanguage property in TPMessageSendParams with language code (ISO-639) when sending message will automatically translate the message text.

• Supported languages (ISO-639) can be found here.

• Calling 'getTranslatedText' on TPMessage object will return a Key-Value map. Translated text(value) can be accessed from the map by using language code (used in 'translationLanguage(s)' parameter) as key.

1. Get Messages

Messages are sorted by most recent (default).

Setting translationLanguage property in TPMessageRetrievalParams object will return TPMessage objects with translated texts via success block (success closure).

• Use this to translate channel messages from the past.

• For realtime message translation, see this.

• TPMessageRetrievalParams class is available starting from TalkPlus Unity SDK v0.5.3.

var messageParams = new TPMessageRetrievalParams(channel);
messageParams.lastMessage = lastMessage;
messageParams.orderBy = TPMessageOrderBy.TPOrderByLatest;
messageParams.translationLanguage = translationLanguage;
        
TalkPlusApi.GetMessages(messageParams, 
   (List<TPMessage> tpMessages, bool hasNext) => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});

2. View Messages With File Upload

View messages with file attachment.

Messages are sorted by most recent (default).

Setting translationLanguage property in TPMessageRetrievalParams object will return TPMessage objects with translated texts via success block (success closure).

• Use this to translate channel messages from the past.

• For realtime message translation, see this.
• TPMessageRetrievalParams class is available starting from TalkPlus Unity SDK v0.5.3.

var messageParams = new TPMessageRetrievalParams(channel);
messageParams.lastMessage = lastMessage;
messageParams.orderBy = TPMessageOrderBy.TPOrderByLatest;
messageParams.translationLanguage = translationLanguage;

TalkPlusApi.GetFileMessages(messageParams, 
   (List<TPMessage> tpMessages, bool hasNext) => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});

3. Send Message

The following message types are supported: text, hidden, custom.

• Push notification is not sent for hidden message type.

• admin, admin_hidden message type can only be sent from TalkPlus dashboard or by calling REST API.

• If you have users you want to mention, you can pass an array of user IDs in the mentions field.

• You can enter up to 10 key-value pairs in data field. The maximum size of key is 128 characters and the maximum size of value is 1024 characters. Both key and value must be strings.

• Both message text and data cannot be empty when sending a message.

• The maximum size of message text is 8192 characters.

• The maximum file upload size is 15MB.

  • If you need to handle files bigger than 15MB, see this.

• Emojis supported by UTF-8 can be used in message text.

• For custom emojis, required values can be put into message text then parsed directly.

Setting translationLanguages property in TPMessageSendParams object will return TPMessage objects with translated texts via ''success block (success closure). Message recipient will be able to check the message via "messageReceived" callback event.

• TPMessageSendParams class is available starting from TalkPlus Unity SDK v0.5.3.

Send Message

var sendParams = new TPMessageSendParams(channel, 
      TPMessageType.TPMessageText, 
      TPMessageContentType.TPMessageContentText);
sendParams.textMessage = textMessage;
sendParams.mentionUserIDs = mentionUserIDs;
sendParams.metaData = metaData;
sendParams.parentMessageId = parentMessageId;
sendParams.translationLanguages = translationLanguages;
            
TalkPlusApi.SendMessage(sendParams, 
   (TPMessage tpMessage) => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});

Send message with file

var sendParams = new TPMessageSendParams(channel, 
      TPMessageType.TPMessageText, 
      TPMessageContentType.TPMessageContentFile);
sendParams.filePath = filePath;
            
TalkPlusApi.SendMessage(sendParams, 
   (TPMessage tpMessage) => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});

Manually set fileUrl

var sendParams = new TPMessageSendParams(channel, 
      TPMessageType.TPMessageText, 
      TPMessageContentType.TPMessageContentText);
sendParams.textMessage = textMessage;
sendParams.fileUrl = fileUrl;
            
TalkPlusApi.SendMessage(sendParams, 
   (TPMessage tpMessage) => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});

4. Get Message

View a single message.

var messageParams = new TPMessageRetrievalParams(channel);
messageParams.messageId = messageId;
messageParams.translationLanguage = translationLanguage;

TalkPlusApi.GetMessage(messageParams, 
   (TPMessage tpMessage) => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});

5. Reply To Message

Reply to another message.

var sendParams = new TPMessageSendParams(channel, 
      TPMessageType.TPMessageText, 
      TPMessageContentType.TPMessageContentText);
sendParams.textMessage = "hello";
sendParams.parentMessageId = "anotherMessageIdThatIamReplyingTo";
            
TalkPlusApi.SendMessage(sendParams, 
   (TPMessage tpMessage) => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});

6. Mark As Read

You can mark a channel as read.

TalkPlusApi.MarkAsReadChannel(channel, (TPChannel tpChannel) => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});

7. React To Message

You can add/remove reaction to a message.

• reaction must be alphanumeric and between 1 and 64 characters long.

• Each message can have up to 10 reaction types.

• Each reaction type can contain up to 100 user IDs.

// add reaction
TalkPlusApi.AddMessageReaction(tpMessage, "happy", (TPMessage tpMessage) => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});

// remove reaction
TalkPlusApi.RemoveMessageReaction(tpMessage, "happy", (TPMessage tpMessage) => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});

// see reactions in message object
tpMessage.getReactions();
/*
{
    "happy": [
        "user1",
        "user2"
    ],
    "sad": [
        "user3"
    ]
}
*/

8. Get Unread Message Count

You can find out how many members have not read a particular message.

 tpChannel.GetMessageUnreadCount(tpMessage);

9. Delete Message

You can delete your own message.

TalkPlusApi.DeleteMessage(channel, message, () => {
   // SUCCESS
}, (int statusCode, Exception e) => {
   // FAILURE
});