Connection Status

The CometChat SDK maintains a persistent WebSocket connection for real-time events. The OnConnectionStateChanged delegate lets you track the connection lifecycle and show appropriate UI (e.g., a “Reconnecting…” banner).

Listen for Connection Changes

Blueprint
C++

Get a reference to the CometChat Subsystem
Drag off and search for On Connection State Changed
Use Bind Event to connect it to a custom event
The custom event receives an ECometChatConnectionState enum value

void AMyActor::BeginPlay()
{
    Super::BeginPlay();

    UCometChatSubsystem* Chat = GetGameInstance()->GetSubsystem<UCometChatSubsystem>();
    Chat->OnConnectionStateChanged.AddDynamic(this, &AMyActor::HandleConnection);
}

void AMyActor::HandleConnection(ECometChatConnectionState State)
{
    switch (State)
    {
    case ECometChatConnectionState::Connected:
        UE_LOG(LogTemp, Log, TEXT("Connected — real-time events active"));
        HideConnectionBanner();
        break;

    case ECometChatConnectionState::Disconnected:
        UE_LOG(LogTemp, Warning, TEXT("Disconnected — no real-time events"));
        ShowConnectionBanner(TEXT("Connection lost"));
        break;

    case ECometChatConnectionState::Reconnecting:
        UE_LOG(LogTemp, Warning, TEXT("Reconnecting..."));
        ShowConnectionBanner(TEXT("Reconnecting..."));
        break;
    }
}

ECometChatConnectionState

Value	Description
`Connected`	WebSocket is active. Real-time events (messages, presence, typing, receipts) are flowing.
`Disconnected`	WebSocket is closed. No real-time events will be received until reconnection.
`Reconnecting`	The SDK detected a disconnect and is automatically attempting to reconnect.

Reconnection Behavior

The SDK handles reconnection automatically:

When the WebSocket drops (network change, server timeout, etc.), the state moves to Reconnecting
The SDK retries with exponential backoff
On successful reconnection, the state moves back to Connected
If reconnection fails permanently, the state moves to Disconnected

UI pattern: Show a subtle banner at the top of your chat screen when the state is Disconnected or Reconnecting. Hide it when Connected fires again. This gives players confidence that the chat system is working.

While disconnected, you can still call async nodes like Get Messages Async — those use HTTP requests, not the WebSocket. Only real-time push events are affected by the connection state.

Authentication

Messaging

Users & Groups

Reference

Listen for Connection Changes

ECometChatConnectionState

Reconnection Behavior

Next Steps

Real-Time Events

API Reference

Authentication

Messaging

Users & Groups

Reference

Documentation Index

​Listen for Connection Changes

​ECometChatConnectionState

​Reconnection Behavior

​Next Steps

Real-Time Events

API Reference

Listen for Connection Changes

ECometChatConnectionState

Reconnection Behavior

Next Steps