Skip to main content

Messages

Send message

You can send message to the members of a specific channel or you can broadcast a message to all users of your app independent of the channels the have joined.

// Send a message to a specific channel
altogic.realtime.send('technology-chat', 'chat-message', {
username: 'Luke Skywalker',
profileImage: 'https://myimagestorage.com/luke.jpg',
messageSentAt: '2021-08-16T11:03:21.406+00:00',
message: "Let's have a Juma juice? I will be there in 10 minutes."
});

// Broadcast message to all app users
altogic.realtime.broadcast('warning-message', {
username: 'Darth Vader',
profileImage: 'https://myimagestorage.com/vader.jpg',
messageSentAt: '2021-08-16T11:10:20.745+00:00',
message: "This is the last call for Alderaan citizens, you have 15 minutes to leave the planet."
});

Parameters

Here you can find parameters for the send method.

#

Name

Data type

Required

Description

1channelNameStringYesThe name of the channel.
2eventNameStringYesThe name of the event.
3messageAnyYesThe message payload/contents. All serializable datastructures are supported for the message, including Buffer.
4echoStringNoOverride the echo flag specified when creating the websocket to enable or prevent realtime messages originating from this connection being echoed back on the same connection.

Here you can find parameters for the broadcast method.

#

Name

Data type

Required

Description

1eventNameStringYesThe name of the event.
2messageAnyYesThe message payload/contents. All serializable datastructures are supported for the message, including Buffer.
3echoStringNoOverride the echo flag specified when creating the websocket to enable or prevent realtime messages originating from this connection being echoed back on the same connection.
note

If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call send and broadcast methods.

Listen to messages

You can listen to messages sent by other users using on, onAny and once methods.

  • The on method registers a new listener function for the given event.
  • The onAny method registers a new catch-all listener function. This listener function is triggered for all messages sent to this socket.
  • The once method adds a one-time listener function for the given event. The next time the same event is triggered, this listener is removed and then invoked.
// Add a listener for `chat-message` events
altogic.realtime.on('chat-message', (payload) => {
console.log(
'Message received',
payload.channel, //The name of the channel if the message is sent to a channel otherwise it is `null`
payload.message //The contents of the message
});

// Add a listener for all events
altogic.realtime.onAny((payload) => {
console.log(
'Message received',
payload.channel, //The name of the channel if the message is sent to a channel otherwise it is `null`
payload.message //The contents of the message
});

// Add a listener to listen an event only once
altogic.realtime.once('chat-message', (payload) => {
console.log(
'Message received',
payload.channel, //The name of the channel if the message is sent to a channel otherwise it is `null`
payload.message //The contents of the message
});

Parameters

Here you can find parameters for the on and once methods.

#

Name

Data type

Required

Description

1eventNameStringYesThe name of the event to listen.
2listenerFunctionYesThe callback function that will be called with the event payload. The payload includes channel and message parts. The channel is the name of the channel if the message is sent to a channel otherwise it is null and the message is the contents of the message that is sent using the send or broadcast methods.

Here you can find parameters for the onAny method.

#

Name

Data type

Required

Description

1listenerFunctionYesThe callback function that will be called with the event payload. The payload includes channel and message parts. The channel is the name of the channel if the message is sent to a channel otherwise it is null and the message is the contents of the message that is sent using the send or broadcast methods.

Unregister message listeners

You can stop listening to specific events or all events using the off and offAny methods.

  • The off method removes the specified listener function from the listener array for the given event name. If listener is not specified, it removes all listeners for for the event named eventName. If neither eventName nor listener is specified, it removes all listeners for all events.
  • The offAny method removes the previously registered listener function. If no listener is provided, all catch-all listener functions are removed.
const eventListener = (payload) => {
console.log(
'Message received',
payload.channel, //The name of the channel if the message is sent to a channel otherwise it is `null`
payload.message //The contents of the message
});
};

// Add a listener for `chat-message` events
altogic.realtime.on('chat-message', eventListener);

// Remove a listener for `chat-message` events
altogic.realtime.off('chat-message', eventListener);



const allEventsListener = (payload) => {
console.log(
'Message received',
payload.channel, //The name of the channel if the message is sent to a channel otherwise it is `null`
payload.message //The contents of the message
});
};

// Add a listener for all events
altogic.realtime.onAny(allEventsListener);

// Remove a listener for all events
altogic.realtime.offAny(allEventsListener);

Parameters

Here you can find parameters for the off method.

#

Name

Data type

Required

Description

1eventNameStringNoThe name of the event to remove the listener function.
2listenerFunctionNoThe callback function that will be removed from the listeners list.

Here you can find parameters for the offAny method.

#

Name

Data type

Required

Description

1listenerFunctionNoThe callback function that will be removed from the listeners list.

Get event listeners

You can also get the list of listener functions registered for a given event name.

// Add a listener for `chat-message` events
let listeners = altogic.realtime.getListeners('chat-message');

Parameters

Here you can find parameters for the getListeners method.

#

Name

Data type

Required

Description

1eventNameStringNoThe name of the event to get the registered listener functions.