Send a Message

Once a user is logged in, you can send text messages to other users (1:1) or to groups.

Message Flow

Send a User Message

Send a text message to a specific user by their UID.

Blueprint
C++

Get a reference to the CometChat Subsystem
Call the Send Message Async node
Wire the On Success and On Failure pins

Parameter	Type	Description
Receiver Uid	`FString`	The UID of the user to send the message to
Text	`FString`	The message body

On Success returns an FCometChatMessage with the sent message details (including the server-assigned Id and SentAt timestamp).

#include "AsyncActions/CometChatSendMessageAction.h"

void AMyActor::SendDirectMessage()
{
    auto* Action = UCometChatSendMessageAction::SendMessageAsync(
        this,
        TEXT("cometchat-uid-2"),   // Receiver UID
        TEXT("Hey, want to play?") // Message text
    );
    Action->OnSuccess.AddDynamic(this, &AMyActor::OnMessageSent);
    Action->OnFailure.AddDynamic(this, &AMyActor::OnMessageFailed);
    Action->Activate();
}

void AMyActor::OnMessageSent(const FCometChatMessage& Message)
{
    UE_LOG(LogTemp, Log, TEXT("Message sent! ID: %s"), *Message.Id);
}

void AMyActor::OnMessageFailed(const FString& Error)
{
    UE_LOG(LogTemp, Error, TEXT("Send failed: %s"), *Error);
}

Send a Group Message

Send a text message to a group by its GUID.

Blueprint
C++

Call the Send Group Message Async node.

Parameter	Type	Description
Guid	`FString`	The unique identifier of the target group
Text	`FString`	The message body

On Success returns an FCometChatMessage.

#include "AsyncActions/CometChatSendGroupMessageAction.h"

void AMyActor::SendToGroup()
{
    auto* Action = UCometChatSendGroupMessageAction::SendGroupMessageAsync(
        this,
        TEXT("group-abc-123"),       // Group GUID
        TEXT("Team, ready up!")      // Message text
    );
    Action->OnSuccess.AddDynamic(this, &AMyActor::OnGroupMessageSent);
    Action->OnFailure.AddDynamic(this, &AMyActor::OnGroupMessageFailed);
    Action->Activate();
}

void AMyActor::OnGroupMessageSent(const FCometChatMessage& Message)
{
    UE_LOG(LogTemp, Log, TEXT("Group message sent! ID: %s"), *Message.Id);
}

void AMyActor::OnGroupMessageFailed(const FString& Error)
{
    UE_LOG(LogTemp, Error, TEXT("Group send failed: %s"), *Error);
}

The FCometChatMessage Struct

Both send operations return an FCometChatMessage on success. Here’s a quick reference of the key fields:

Property	Type	Description
`Id`	`FString`	Server-assigned unique message ID
`SenderUid`	`FString`	UID of the sender (the logged-in user)
`ReceiverUid`	`FString`	UID of the receiver (user UID or group GUID)
`Text`	`FString`	The message body
`SentAt`	`int64`	Unix timestamp when the message was sent
`Type`	`FString`	`text` for text messages
`ReceiverType`	`FString`	`user` for 1:1, `group` for group messages
`ConversationId`	`FString`	Unique conversation identifier

For the full struct definition, see Key Concepts → FCometChatMessage.

Next Steps

Receive Messages

Fetch message history and listen for incoming messages in real time.

Groups

Create and manage groups before sending group messages.

Authentication

Messaging

Users & Groups

Reference

Message Flow

Send a User Message

Send a Group Message

The FCometChatMessage Struct

Next Steps

Receive Messages

Groups

Authentication

Messaging

Users & Groups

Reference

Documentation Index

​Message Flow

​Send a User Message

​Send a Group Message

​The FCometChatMessage Struct

​Next Steps

Receive Messages

Groups

Message Flow

Send a User Message

Send a Group Message

The FCometChatMessage Struct

Next Steps