Hello MQTT JavaScript


In this tutorial, you will learn how to use the JavaScript MQTT client with Cumulocity using pre-defined messages (called "static templates").


In order to follow this tutorial, check the following prerequisites:

  • You have a valid tenant, a user, and a password in order to access Cumulocity.

Develop the "Hello, MQTT world!" client

To develop a very simple "Hello, world!" MQTT client for Cumulocity, you need to

  • Create a JavaScript application.
  • Run the application.

Create a JavaScript application

Create an html file, for example "hello_mqtt_js.html" with the following content:

    <meta http-equiv="Content-Type" content="text/html;charset=utf-8"></meta>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/paho-mqtt/1.0.1/mqttws31.js" type="text/javascript"></script>
    <script type="text/javascript">
        var undeliveredMessages = []

        var client = new Paho.MQTT.Client("<<serverUrl>>", "<<clientId>>");
        client.onMessageArrived = onMessageArrived;
        client.onMessageDelivered = onMessageDelivered;

        function onMessageArrived(message) {
            log('Received operation "' + message.payloadString + '"');
            if (message.payloadString.indexOf("510") == 0) {
                log("Simulating device restart...");
                publish("s/us", "501,c8y_Restart");
                setTimeout(function() {
                    publish("s/us", "503,c8y_Restart");
                }, 1000);

        function onMessageDelivered(message) {
            log('Message "' + message.payloadString + '" delivered');
            var undeliveredMessage = undeliveredMessages.pop();
            if (undeliveredMessage.onMessageDeliveredCallback) {

        function createDevice() {
            //create device
            publish("s/us", "100,JS MQTT,c8y_MQTTDevice", function() {
                //set hardware information
                publish("s/us", "110,S123456789,MQTT test model,Rev0.1", function() {
                    //listen for operation
                    //send temperature measurement
                    setInterval(function() {
                        publish("s/us", "211,25");
                    }, 3000);

        function publish(topic, message, onMessageDeliveredCallback) {
            message = new Paho.MQTT.Message(message);
            message.destinationName = topic;
            message.qos = 2;
                message: message,
                onMessageDeliveredCallback: onMessageDeliveredCallback

        function init() {
                userName: "<<tenant>>/<<username>>",
                password: "<<password>>",
                onSuccess: createDevice

        function log(message) {
            document.getElementById('logger').insertAdjacentHTML('beforeend', '<div>' + message + '</div>');
<body onload="init();"><div id="logger"></div></body>

Replace "<<clientId>>", "<<serverUrl>>", "<<tenant>>", "<<username>>", and "<<password>>" with your valid data.

The Cumulocity MQTT protocol supports both unsecured TCP and also secured SSL connections (e.g. ws://mqtt.cumulocity.com/mqtt or wss://mqtt.cumulocity.com/mqtt), so as the "<<serverUrl>>" you can pick the one which fits for you.

What does the code do?

  • Configure the MQTT connection.
  • Register onMessageArrived a callback function which will print all incoming messages and in case of c8y_Restart operation it will simulate a device restart.
  • Register onMessageDelivered a callback function which will be called after a publish message has been delivered.
  • After the page is fully loaded call init function which connects with Cumulocity via a MQTT protocol.
  • After the connection is established call a createDevice function.
  • Create a new device with a JS MQTT name and a c8y_MQTTDevice type.
  • Update the device hardware information by putting a S123456789 serial, a MQTT test model model and a Rev0.1 revision.
  • Subscribe to the static operation templates for the device - this will result in onMessageArrived method call every time a new operation is created.
  • Send temperature measurement every 3 seconds.

Note that subscription is established after the device creation, otherwise if there is no device for a given clientId the server will not accept it.


Open "hello_mqtt_js.html" in a browser. After that you should see the new device in the Cumulocity application in the device list. Additionally if there will be a new operation created for this device, (for example c8y_Restart) information about it will be printed in the browser page.

Improve the agent

Now that you have done your first step, check out the Section Hello MQTT to learn more about Cumulocity MQTT and improve your application.