Message Reactions API for Unreal SDK

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 reaction events on that channel. They can also fetch past message reactions from Message Persistence independently or when they fetch original messages.

Usage in Blueprints and C++

Terminology

All message reactions in code are collectively called message reactions in the docs and the term applies both to reacting to a message (through emojis) and acting on a message (by deleting it).

Add Message Reaction

Requires Message Persistence

This method requires that Message Persistence is enabled for your key in the Admin Portal.

Add a reaction to a published message.

Method(s)

Blueprint

C++

PubnubSubsystem->AddMessageAction(
    FString Channel, 
    FString MessageTimeToken, 
    EPubnubActionType ActionType,  
    FString Value,
    FOnAddMessageActionsResponse OnAddMessageActionResponse
);

* required

Parameter	Description
Channel * Type: FString	The channel to publish the message reaction to.
MessageTimeToken * Type: FString	The timetoken of a published message to apply the reaction to.
ActionType * Type: EPubnubActionType	Enum action type. Available values: pbactypReaction pbactypReceipt pbactypCustom pbactypEdited pbactypDeleted
Value * Type: FString	A String describing the action to be added.
OnAddMessageActionResponse * Type: FOnAddMessageActionsResponse	The callback function used to handle the result.

Basic Usage

Reference code

This example is a self-contained code snippet ready to be run. It includes necessary imports and executes methods with console logging. Use it as a reference when working with other examples in this document.

MyGameMode.h

// NOTE: This example requires correct PubnubSDK configuration in plugins settings and adding "PubnubLibrary" to PublicDependencyModuleNames in your build.cs
// More info in the documentation: https://www.pubnub.com/docs/sdks/unreal/api-reference/configuration

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/GameModeBase.h"
#include "MyGameMode.generated.h"

/**
 * 
 */
UCLASS()
//Replace MYPROJECT with name of your project
class MYPROJECT_API AMyGameMode : public AGameModeBase

show all 24 lines

MyGameMode.cpp

#include "MyGameMode.h"
#include "PubnubSubsystem.h"
#include "Kismet/GameplayStatics.h"

void AMyGameMode::AddMessageReactionExample()
{
	// Get PubnubSubsystem from the game instance
	UGameInstance* GameInstance = UGameplayStatics::GetGameInstance(this);
	UPubnubSubsystem* PubnubSubsystem = GameInstance->GetSubsystem<UPubnubSubsystem>();

	// Ensure user ID is set
	PubnubSubsystem->SetUserID("my_user_id");

	FString Channel = "randomChannel";
	FString MessageTimeToken = "5610547826969050";

show all 30 lines

Returns

This method returns the FOnAddMessageActionsResponse struct.

FOnAddMessageActionsResponse

Field	Type	Description
MessageActionTimetoken	FString	Timetoken indicating when the message reaction was added.

Remove Message Reaction

Requires Message Persistence

This method requires that Message Persistence is enabled for your key in the Admin Portal.

Remove a previously added reaction from a published message. Returns an empty response.

Method(s)

Blueprint

C++

PubnubSubsystem->RemoveMessageAction(
    FString Channel, 
    FString MessageTimeToken, 
    FString ActionTimeToken
);

* required

Parameter	Description
Channel * Type: FString	The channel the message reaction was published to.
MessageTimeToken * Type: FString	The timetoken of a published message to delete the reaction of.
ActionTimeToken * Type: FString	The timetoken of the published action to delete.

Basic Usage

#include "Kismet/GameplayStatics.h"
#include "PubnubSubsystem.h"

UGameInstance* GameInstance = UGameplayStatics::GetGameInstance(this);
UPubnubSubsystem* PubnubSubsystem = GameInstance->GetSubsystem<UPubnubSubsystem>();

FString Channel = "randomChannel";
FString MessageTimeToken = "5610547826969050";
FString MessageTimeToken = "15610547826970050";

// Add the message reaction
PubnubSubsystem->RemoveMessageAction(Channel, MessageTimeToken, ActionTimeToken);

Returns

This method doesn't have any return value.

Get Message Reactions

Requires Message Persistence

This method requires that Message Persistence is enabled for your key in the Admin Portal.

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

Truncated response

Number of message reactions in the response may be truncated when internal limits are hit. If the response is truncated, a more property will be returned with additional parameters. Send iterative calls to Message Persistence adjusting the parameters to fetch more message reactions.

Method(s)

Blueprint

Response variants

You can also call the GetMessageActions_JSON() variant of this method to get an FOnPubnubResponse which contains pure JSON.

C++

Response variants

You can also call the GetMessageActions_JSON() variant of this method to get an FOnPubnubResponse which contains pure JSON.

PubnubSubsystem->GetMessageActions(
    FString Channel, 
    FString Start, 
    FString End, 
    int SizeLimit, 
    FOnGetMessageActionsResponse OnGetMessageActionsResponse
);

* required

Parameter	Description
Channel * Type: FString	The channel the message reaction was published to.
Start Type: FString	Previously-returned cursor bookmark for fetching the next page. Use "" if you don’t want to paginate with a start bookmark.
End Type: FString	Previously-returned cursor bookmark for fetching the previous page. Ignored if you also supply the start parameter. Use "" if you don’t want to paginate with an end bookmark.
SizeLimit Type: int	Number of objects to return in response. Available values: 1 - 100. If you set 0, the default value of 100 is used.
OnGetMessageActionsResponse * Type: FOnGetMessageActionsResponse	The callback function used to handle the result.

Basic Usage

#include "Kismet/GameplayStatics.h"
#include "PubnubSubsystem.h"

UGameInstance* GameInstance = UGameplayStatics::GetGameInstance(this);
UPubnubSubsystem* PubnubSubsystem = GameInstance->GetSubsystem<UPubnubSubsystem>();

// Create a pubnub response delegate
// you MUST implement your own callback function to handle the response
FOnGetMessageActionsResponse OnGetMessageActionsResponse;
OnGetMessageActionsResponse.BindDynamic(this, &AMyActor::OnGetMessageActionsResponse);

FString Channel = "randomChannel";
FString Start = "";
FString End = "";

show all 17 lines

Returns

This method returns the FOnGetMessageActionsResponse struct.

FOnGetMessageActionsResponse

Field	Type	Description
Status	int	HTTP code of the result of the operation.
MessageActions	TArray<FPubnubMessageActionData>&	An array of FPubnubMessageActionData structs which are the message reactions sent on a given channel.

JSON Response

{
  "status": 200, 
  "data": [{
    "messageTimetoken": "17198286823798098", 
    "type": "reaction", 
    "uuid": "User1", 
    "value": "happy", 
    "actionTimetoken": "17198286996058878"
  }]
}

History with Message Reactions

You can choose to return message reactions when fetching historical message. Refer to Fetch History for more details.