How to build a Real-Time Messaging App using Diffusion

Matias Prados - September 17, 2020

Real-Time Messaging

Introduction to Diffusion Real-Time Messaging through a simple application using Diffusion Cloud.
A set of simple projects, illustrating production and consumption of messages to and from a Diffusion Cloud instance.
These JavaScript code examples enable users to interact in real-time across various rooms or topics. You can also use other programming languages from our SDKs, including iOS, Android, C, .NET, and more.

Lesson 1: Publish and Subscribe to Topics

Lesson 1 code example introduces the concept of Publish and Subscribe to ‘Topics’ (data structures). In Diffusion, data is stored and distributed through Topics.

Lesson 2: Time Series Topics

Lesson 2 code example introduces the concept of Time Series topic to hold a historical sequence of events. Time series topics are useful for collaborative applications such as chat rooms. Multiple users can concurrently update a time series topic.

Lesson 3: Security

Lesson 3 code example introduces the concept of Security by requiring sessions to authenticate and use role-based authorization to define the actions that a client can perform.


  • Download our code examples or clone them to your local environment:
git clone
  • A Diffusion service (Cloud or On-Premise), version 6.5.0 or greater. Create a service here.

Create Service


Make sure to add Diffusion library to your code. For JavaScript, we have added the following line in our public/chat.html:


Set lines 44-46 of public/js/app.js to the hostname of your Diffusion Cloud service, which you can find in your service dashboard. You can also leave the default values and connect to our sandbox service:

  • host: host (“” by default)
  • user: ‘user’
  • password: ‘password’


Really easy, just open the index.html file locally and off you go!

The code in action

(Click to watch the video)

Video Tutorial

Lesson 1: Publish and Subscribe

In Diffusion, data is stored and distributed through ‘Topics’ (data structures). Session can subscribe to a topic to receive notifications when the topic value changes and can also update the value. When a topic is updated, all its subscribers are notified of the new value. Diffusion takes care of efficiently broadcasting value changes, even if there are hundreds of thousands of subscribers.

Step 1: Connect to Diffusion

diffusion.connect > create your host
	host : host, // Use your Diffusion service or connect to our sandbox ""
	principal : "user",
	credentials : "password"})

Step 2: Create a Topic

session.topics.add(_roomTopic, diffusion.topics.TopicType.JSON);

Step 3: Create a Topic Listener

session.addStream(_roomTopic, diffusion.datatypes.json());

Step 4: Subscribe to a Topic;

Step 5: Update a Topic

session.topicUpdate.set(_roomTopic, diffusion.datatypes.json(),
		text: msg,
		name: name,
		timestamp: new Date().toLocaleTimeString()

Lesson 2: Time Series

Introduce the concept of a Time Series topic to hold a sequence of events. Time series topics are useful for collaborative applications such as chat rooms. Multiple users can concurrently update a time series topic.

Step 1: Topic Types and Specifications

diffusion.topics.TopicSpecification : TopicType.TIME_SERIES


Step 2: Append/Update Time Series

		text: msg 
		name: name,
		timestamp: new Date().toLocaleTimeString()

Lesson 3: Security

Introduce the concept of Security by requiring sessions to authenticate and use role-based authorization to define the actions that a client can perform.

Step 1: Using Auth script builder;

Step 2: Create a new user with a user name, password and roles

addPrincipal() – build()
		.addPrincipal(name, password, ['CLIENT','TOPIC_CONTROL'])

Step 3: Update the Auth store;

Challenge for you

Now that you have a fully functional messaging app, try building a “moderator” app, to monitor the conversation for explicit/inappropriate messages. When specific text is identified in a conversation, the message value can be bleeped out, or access/permission to the room can be dynamically updated based on the user’s behavior.

Coming Next

Stay tuned for our next video tutorial introducing the basic concept of your Diffusion dashboard and console. We will update this blog with the link to the video in the next few days!


Thank you!


The Diffusion Intelligent Data Mesh manages, optimizes, and integrates data among devices, systems, and applications. Push Technology pioneered and is the sole provider of real-time delta data streaming™ technology that powers mission-critical business applications worldwide. Leading brands use Push Technology to fuel revenue growth, customer engagement, and business operations. The products, Diffusion® and Diffusion Cloud™, are available on-premise, in-the-cloud, or in a hybrid configuration, to fit the specific business and infrastructure requirements of the applications operating in today’s mobile obsessed, everything connected world. Learn how Push Technology can reduce infrastructure costs, and increase speed, efficiency, and reliability, of your web, mobile, and IoT application.

Learn More: View Blog Posts and Developer Resources


Check out these other resources


Info Center

Case Studies, White Papers, and Tech Talk notes relating to Diffusion and the customers benefiting from using it.


Quick Start Guide

Step-by-step guide to getting started fast with Diffusion or Diffusion Cloud.


Diffusion Cloud

Get the facts and the details about our Diffusion Cloud platform.