# Simple Messaging
## Introduction
IBM Cloud is a cloud service that offers, among other things, an IoT platform that lets IoT devices connect and send data that can later be analyzed using IBM cloud services. This IoT platform offers a REST API as well as an MQTT broker interface. In this tutorial we will learn how to set up IBM Cloud and connect to it using our network simulator.
## 1. Sign up with IBM Cloud
Before starting, sign up for a free IBM Cloud account at , and then log in to your account. You will be asked to create an organization and a space: follow the instructions and then you will be taken to your account’s dashboard. Click **Catalog** in the top menu, then the **Internet of Things** category in the left menu, and then **Internet of Things Platform**:
Now you have to create a service: insert a name for the service (for example: IoTIFY) and then click **Create**; then, on the welcome page click **Launch**. You are now taken to the IBM Watson IoT Platform dashboard.
## 2. Create a Device in IBM Cloud
Once the service is launched, the next step is to create a device type: on the left menu, click **Devices**, activate the **Device Types** tab, and then click the **Add Device Type** button; on the next screen, enter a name for your type and click **Next**. You can optionally define template data or add metadata to the device type, but this is not mandatory, and you can simply skip these steps when creating the device type. Click **Finish** to complete the device type registration.
Now you can go to the **Browse** tab, click on **Add Device**; in the **Device Type** field, select the previously created device type from the drop-down menu. The only mandatory data to insert for a new device is the device ID: choose an ID for your device, then go through the following steps and finally click **Finish**.
The next screen shows all the info for your device, including an authentication token: take note of this token now, since it will be needed when setting up the IoTIFY network simulator:
The setup phase in IBM Cloud is completed: now it’s time to send data to it from our network simulator.
## 3. Create a template in IoTIFY network simulator
You can start by importing our predefined template from the link below
```
https://raw.githubusercontent.com/iotify/nsim-examples/master/connectors/ibm-connector.json
```
Or, You can create one yourself.
* To create a new template, go to the `TEMPLATES` tab of IoTIFY Network Simulator and click on `New Template`
* Then, select `MQTT(S)` as connection protocol, give the template a name of your choice (for example, IBMcloud) and click on `CREATE`.
* The next screen allows you to customize the template. In the MQTT parameters section, do the following configuration:
* select `MQTTS (TCP)` as protocol
* insert a string with the format `.messaging.internetofthings.ibmcloud.com` as endpoint URL, where `` is the identifier of your organization in your IBM Cloud account. You can find this information on the top right of your IBM Watson IoT Platform dashboard, below your account's IBM ID.
* The topic of the MQTT messages sent by the devices must be of the form `iot-2/evt//fmt/json` , where is a name of your choice that identifies the events published by a device.
* Then, as`ClientID` you have to insert a string with the format `d:::`, where
* `` is the same as above
* `` is the name of the device type associated to your device in IBM IoT Platform
* `` is the identifier of your device.
In the credentials ections, you have to supply authentication credentials: insert **`use-token-auth`**as username, and the authentication token assigned when you created your device as password:
The MQTT message contents must be formatted in JSON and must contain a single top-level property called *d*. For example:
```
{
var mystate = {
d: {
"true Power": chance.integer({min: 100, max: 3000 }),
"time": moment.now()
}
};
return JSON.stringify(mystate)
}
```
Click on **PREVIEW** to verify if your template has been configured correctly; then, if the preview is successful, save your template and you are all set up to send data to IBM Cloud.
## 4. Send data to IBM Cloud
In IoTIFY Network Simulator, launch a new simulation, and as your virtual devices start sending MQTT messages you will be able to see your generated data in the IBM IoT Platform dashboard: click on your device in the dashboard, and you will see events as they come in from our simulator:
Clicking on an event will show you the corresponding message contents, generated by the simulator according to your template:
That’s it! Enjoy using our network simulator with IBM Cloud!
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.iotify.io/temp/untitled-3/simple-messaging.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.