Message Actions API for PubNub Cocoa Swift SDK

This SDK has been replaced by a new PubNub Swift SDK written purely in Swift. Check it out here

Add or remove actions on published messages to build features like receipts, reactions, or to associate custom metadata to messages. Clients can subscribe to a channel to receive message action events on that channel. They can also fetch past message actions from Message Persistence independently or when they fetch original messages.

Add Message Action

Requires Message Persistence add-on

This method requires that the Message Persistence add-on is enabled for your key in the Admin Portal. Read the support page on enabling add-on features on your keys.

Description

Add an action on a published message. Returns the added action in the response.

Method(s)

To Add a Message Action you can use the following method(s) in the Swift SDK:

open func addMessageAction(with: PNAddMessageActionRequest, completion: PNAddMessageActionCompletionBlock?)
ParameterTypeRequiredDescription
requestPNAddMessageActionRequestYesAdd message action request with all information about new message action which will be passed to PubNub service.
closurePNAddMessageActionCompletionBlockNoAdd message action request completion closure.

PNAddMessageActionRequest

ParameterTypeRequiredDescription
typeStringYesWhat feature this message action represents. Maximum 15 characters.
valueStringYesValue which should be added with message action type.
channelStringYesName of channel which stores the message for which action should be added.
messageTimetokenNSNumberYesTimetoken (PubNub's high precision timestamp) of message to which action should be added.

Basic Usage

let request = PNAddMessageActionRequest(channel: "chat", messageTimetoken: 1234567890)
request.type = "reaction"
request.value = "smile"

self.client.addMessageAction(with: request, completion: { status in
if !status.isError {
/**
* Message action successfully added.
* Created message action information available here: status.data.action
*/
} else {
if status.statusCode == 207 {
// Message action has been added, but event not published.
} else {
/**
show all 23 lines

Response

Response objects which is returned by client when add message action Message Action API is used:

open class PNAddMessageActionData : PNServiceData {
// Added message action.
open var action: PNMessageAction? { get }
}

open class PNAddMessageActionStatus : PNAcknowledgmentStatus {
// Add message action request processed information.
open var data: PNAddMessageActionData { get }
}

Add Message Action (Builder Pattern)

Requires Message Persistence add-on

This method requires that the Message Persistence add-on is enabled for your key in the Admin Portal. Read the support page on enabling add-on features on your keys.

Description

Add an action on a published message. Returns the added action in the response.

Method(s)

To Add a Message Action you can use the following method(s) in the Swift SDK:

addMessageAction().channel(String).messageTimetoken(NSNumber).type(String).value(String).performWithCompletion(PNAddMessageActionCompletionBlock?)
ParameterTypeRequiredDescription
channelStringYesName of channel which store message for which action should be added.
messageTimetokenNSNumberYesTimetoken of message for which action should be added.
typeStringYesWhat feature this message action represents.
valueStringYesValue which should be stored along with message action.
closurePNAddMessageActionCompletionBlockNoAdd message action request completion closure.

Basic Usage

self.client.addMessageAction()
.channel("chat")
.name(1234567890)
.type("reaction")
.value("smile")
.performWithCompletion({ status in
if !status.isError {
/**
* Message action successfully added.
* Created message action information available here: status.data.action
*/
} else {
if status.statusCode == 207 {
// Message action has been added, but event not published.
} else {
show all 24 lines

Response

Response objects which is returned by client when add message action Message Action API is used:

open class PNAddMessageActionData : PNServiceData {
// Added message action.
open var action: PNMessageAction? { get }
}

open class PNAddMessageActionStatus : PNAcknowledgmentStatus {
// Add message action request processed information.
open var data: PNAddMessageActionData { get }
}

Remove Message Action

Requires Message Persistence add-on

This method requires that the Message Persistence add-on is enabled for your key in the Admin Portal. Read the support page on enabling add-on features on your keys.

Description

Remove a peviously added action on a published message. Returns an empty response.

Method(s)

To Remove a Message Action you can use the following method(s) in the Swift SDK:

open func removeMessageAction(with: PNRemoveMessageActionRequest, completion: PNRemoveMessageActionCompletionBlock?)
ParameterTypeRequiredDescription
requestPNRemoveMessageActionRequestYesRemove message action request with information about existing message action.
closurePNRemoveMessageActionCompletionBlockNoRemove message action request completion closure.

PNRemoveMessageActionRequest

ParameterTypeRequiredDescription
actionTimetokenNSNumberYesMessage action addition timetoken.
channelNSStringYesName of channel which store message for which action should be removed.
messageTimetokenNSNumberYesTimetoken (PubNub's high precision timestamp) of message to which action should be removed.

Basic Usage

let request = PNRemoveMessageActionRequest(channel: "chat", messageTimetoken: 1234567890)
request.actionTimetoken = 1234567891

self.client.removeMessageAction(with: request, completion: { status in
if !status.isError {
// Message action successfully removed.
} else {
/**
* Handle remove message action error. Check 'category' property to find out possible
* issue because of which request did fail.
*
* Request can be resent using: status.retry()
*/
}
})

Response

Response objects which is returned by client when remove message action Message Action API is used:

open class PNErrorData : PNServiceData {
// Stringified error information.
open var information: String { get }
}

open class PNAcknowledgmentStatus : PNErrorStatus {
// Whether status object represent error or not.
open var isError: Bool { get }

// Additional information related to error status object.
open var data: PNErrorData { get }
}

Remove Message Action (Builder Pattern)

Requires Message Persistence add-on

This method requires that the Message Persistence add-on is enabled for your key in the Admin Portal. Read the support page on enabling add-on features on your keys.

Description

Remove a peviously added action on a published message. Returns an empty response.

Method(s)

removeMessageAction().channel(String).messageTimetoken(NSNumber).actionTimetoken(NSNumber).performWithCompletion(PNRemoveMessageActionCompletionBlock?)
ParameterTypeRequiredDescription
channelStringYesName of channel which store message for which action should be removed.
messageTimetokenNSNumberYesTimetoken of message for which action should be removed.
actionTimetokenNSNumberYesAction addition timetoken.
closurePNCreateSpaceCompletionBlockNoRemove message action request completion closure.

Basic Usage

self.client.removeMessageAction()
.channel("channel")
.messageTimetoken(1234567890)
.actionTimetoken(1234567891)
.performWithCompletion({ status in
if !status.isError {
// Message action successfully removed.
} else {
/**
* Handle remove message action error. Check 'category' property to find out possible
* issue because of which request did fail.
*
* Request can be resent using: status.retry()
*/
}
show all 16 lines

Response

Response objects which is returned by client when remove message action Message Action API is used:

open class PNErrorData : PNServiceData {
// Stringified error information.
open var information: String { get }
}

open class PNAcknowledgmentStatus : PNErrorStatus {
// Whether status object represent error or not.
open var isError: Bool { get }

// Additional information related to error status object.
open var data: PNErrorData { get }
}

Get Message Actions

Requires Message Persistence add-on

This method requires that the Message Persistence add-on is enabled for your key in the Admin Portal. Read the support page on enabling add-on features on your keys.

Description

Get a list of message actions in a channel. Returns a list of actions sorted by the action's timetoken in ascending order.

Method(s)

To Get Message Actions you can use the following method(s) in the Swift SDK:

open func fetchMessageActions(with: PNFetchMessageActionsRequest, completion: PNFetchMessageActionsCompletionBlock)
ParameterTypeRequiredDescription
requestPNFetchMessageActionsRequestYesFetch message actions request with all information which should be used to fetch existing messages actions.
closurePNFetchMessageActionsCompletionBlockYesFetch message actions request completion closure.

PNFetchMessageActionsRequest

ParameterTypeRequiredDescription
startNSNumberYesReturn values will be less than start.
endNSNumberYesReturn values will be greater than or equal to end.
limitUIntYesNumber of messages actions to return in response.
channelStringYesName of channel from which list of message actions should be retrieved.

Basic Usage

self.client.fetchMessageActions()
.channel("chat")
.start(1234567891)
.limit(200)
.performWithCompletion({ (result, status) in
if !(status?.isError ?? false) {
/**
* Message actions successfully fetched.
* Result object has following information:
* result.data.actions - list of message action instances
* result.data.start - fetched messages actions time range start (oldest message
* action timetoken).
* result.data.end - fetched messages actions time range end (newest action timetoken).
*/
} else {
show all 23 lines

Response

Response objects which is returned by client when fetch message actions Message Action API is used:

open class PNFetchMessageActionsData : PNServiceData {
// List of fetched messages actions.
open var actions: [PNMessageAction] { get }

/**
* Fetched messages actions time range start (oldest message action timetoken).
*
* This timetoken can be used as 'start' value to fetch older messages actions.
*/
open var start: NSNumber { get }

// Fetched messages actions time range end (newest action timetoken).
open var end: NSNumber { get }
}

show all 19 lines

Error response which is used in case of Message Action API call failure:

open class PNErrorData : PNServiceData {
// Stringified error information.
open var information: String { get }
}

open class PNErrorStatus : PNStatus {
// Whether status object represent error or not.
open var isError: Bool { get }

// Additional information related to error status object.
open var data: PNErrorData { get }
}

Get Message Actions (Builder Pattern)

Requires Message Persistence add-on

This method requires that the Message Persistence add-on is enabled for your key in the Admin Portal. Read the support page on enabling add-on features on your keys.

Description

Get a list of message actions in a channel. Returns a list of actions sorted by the action's timetoken in ascending order.

Method(s)

To Get Message Actions you can use the following method(s) in the Swift SDK:

fetchMessageActions().channel(String).start(NSNumber).end(NSNumber).limit(UInt).performWithCompletion(PNFetchMessageActionsCompletionBlock)
ParameterTypeRequiredDescription
channelStringYesName of channel from which list of messages actions should be retrieved.
startNSNumberNoMessage action timetoken denoting the start of the range requested. Return values will be less than start.
endNSNumberNoMessage action timetoken denoting the end of the range requested. Return values will be greater than or equal to end.
limitUIntNoNumber of message actions to return in response.
closurePNFetchMessageActionsCompletionBlockYesFetch message actions request completion closure.

Basic Usage

self.client.fetchMessageActions()
.channel("chat")
.start(1234567891)
.limit(200)
.performWithCompletion({ (result, status) in
if !(status?.isError ?? false) {
/**
* Message actions successfully fetched.
* Result object has following information:
* result.data.actions - list of message action instances
* result.data.start - fetched messages actions time range start (oldest message
* action timetoken).
* result.data.end - fetched messages actions time range end (newest action timetoken).
*/
} else {
show all 23 lines

Response

Response objects which is returned by client when fetch message actions Message Action API is used:

open class PNFetchMessageActionsData : PNServiceData {
// List of fetched messages actions.
open var actions: [PNMessageAction] { get }

/**
* Fetched messages actions time range start (oldest message action timetoken).
*
* This timetoken can be used as 'start' value to fetch older messages actions.
*/
open var start: NSNumber { get }

// Fetched messages actions time range end (newest action timetoken).
open var end: NSNumber { get }
}

show all 19 lines

Error response which is used in case of Message Action API call failure:

open class PNErrorData : PNServiceData {
// Stringified error information.
open var information: String { get }
}

open class PNErrorStatus : PNStatus {
// Whether status object represent error or not.
open var isError: Bool { get }

// Additional information related to error status object.
open var data: PNErrorData { get }
}
Last updated on