Real-time Messaging

Stay connected with your community through instant, reliable communication.

VSROS Messaging delivers a full-featured communication platform powered by WebSocket technology for instant message delivery. Create private conversations or group chats with up to 50 members. Pin important messages, track online presence of your friends, and never miss a message with push notifications. The messaging system integrates seamlessly with the rest of the platform — mention users, share threads, and collaborate in real time.

✦ Key Features

01

Private one-on-one conversations with real-time delivery

02

Group chats supporting up to 50 members with admin controls

03

Message pinning — pin important messages to the top of any conversation

04

Real-time online presence indicators for friends and group members

05

Push notifications for new messages across all devices

06

Message search with full-text search across conversation history

07

WebSocket-powered delivery with automatic reconnection

08

Read receipts and typing indicators

09

File and image sharing within conversations

10

Conversation management — archive, mute, or delete conversations

📋 In Detail

💬

Private Conversations

Start a private conversation with any user. Messages are delivered instantly via WebSocket and persisted to the database for cross-device synchronization.

👥

Group Chats

Create group chats with multiple members. Assign admins, manage participants, and collaborate with your team or community in real time.

📌

Pinned Messages

Pin important messages so they're always easy to find. Pinned conversations appear at the top of your inbox for quick access.

🟢

Presence System

See who's online in real time. The presence system tracks user activity and displays green indicators for active users across the platform.

🔔

Smart Notifications

Never miss a message. Push notifications are sent instantly for new messages, with intelligent batching to avoid notification spam.

🔌

WebSocket Engine

Built on a robust WebSocket architecture with automatic reconnection, message queuing, and offline message delivery when you come back online.

🔌

Connect

Step 1

Establish a WebSocket connection to the VSROS server

🔐

Authenticate

Step 2

Send your JWT token to verify identity

🚪

Join Room

Step 3

Join a chat room or create a new one

💬

Send & Receive

Step 4

Exchange real-time messages with end-to-end encryption

👋

Disconnect

Step 5

Gracefully close the connection with session state preserved

ℹ️
🔒 Encryption
All messages are encrypted with AES-256 in transit and at rest. Private conversations support end-to-end encryption (E2EE) with ephemeral keys.
WebSocket Connection Example
javascript
1import { io } from 'socket.io-client';
2
3const socket = io('wss://vsros.com/api/v1/messaging', {
4 auth: { token: 'YOUR_JWT_TOKEN' },
5 transports: ['websocket']
6});
7
8socket.on('connect', () => {
9 console.log('Connected to VSROS messaging');
10 socket.emit('join_room', { roomId: 'general-chat' });
11});
12
13socket.on('new_message', (message) => {
14 console.log(`[${message.sender}]: ${message.content}`);
15});
16
17socket.emit('send_message', {
18 roomId: 'general-chat',
19 content: 'Hello from the API! 👋'
20});