Events & Real-Time

Chatify dispatches broadcast events for every real-time interaction. All events implement ShouldBroadcastNow (dispatched synchronously, no queue needed).

Channels

Events are sent on two types of private channels:

Event reference

MessageSent

Dispatched when a new message is sent.

MessageUpdated

Dispatched when a message is edited.

MessageDeleted

Dispatched when a message is deleted.

ConversationRead

Dispatched when a user marks a conversation as read.

ConversationInboxUpdated

Dispatched to update a user's inbox (new message arrived, conversation updated, etc.).

UserTyping

Dispatched when a user starts or stops typing.

UserPresenceChanged

Dispatched when a user comes online or goes offline. Sent to each user who shares a conversation with them.

UserBlockChanged

Dispatched when a user blocks or unblocks another user. Sent to both parties.

GroupParticipantsChanged

Dispatched when participants are added, removed, or their roles change in a group.

GroupMembershipRevoked

Dispatched to a user who has been removed from a group. Sent only to the removed user.

Listening on the frontend

The bundled UI handles all events automatically. If you are building a custom frontend, subscribe to channels using Laravel Echo:

import Echo from 'laravel-echo';
import Pusher from 'pusher-js';

const echo = new Echo({
    broadcaster: 'pusher',
    key: 'your-pusher-key',
    cluster: 'mt1',
    forceTLS: true,
    authEndpoint: '/api/chatify/v1/broadcasting/auth',
});

// Listen for new messages in a conversation
echo.private(`chatify.conversation.${conversationId}`)
    .listen('.MessageSent', (data) => {
        console.log('New message:', data);
    })
    .listen('.UserTyping', (data) => {
        console.log('Typing:', data);
    })
    .listen('.ConversationRead', (data) => {
        console.log('Read receipt:', data);
    });

// Listen for user-specific events
echo.private(`chatify.user.${userId}`)
    .listen('.InboxUpdated', (data) => {
        console.log('Inbox updated:', data);
    })
    .listen('.UserPresenceChanged', (data) => {
        console.log('Presence:', data);
    });

Note the . prefix before event names -- this tells Echo to use the broadcastAs name rather than the fully-qualified class name.

Presence heartbeat

The frontend sends periodic heartbeat requests to track online status:

POST /api/chatify/v1/presence/heartbeat

When a user closes the tab or navigates away, an offline signal is sent:

POST /api/chatify/v1/presence/offline

The server then dispatches UserPresenceChanged events to all users who share conversations with the user.

Event summary