Skill Level: Any Skill Level

By integrating IBM Watson IoT devices with floLIVE connectivity services, users are able to receive cellular connectivity events directly to their Device Management application alongside to the device's telemetry (i.e. sensor data).



FloLIVE integrates the IBM Watson IoT Platform using the MQTT protocol over a secure SSL connection.

The diagram below depicts the high-level integration between floLIVE Connectivity Management Platform and the IBM Watson IoT platform:



A new Virtual Getaway shall be defined in the IBM Watson IoT Platform.

One or more IoT devices shall be configured under the Virtual Gateway.

The Gateway shall act on behalf of the configured devices.

The FloLIVE platform is configured to send connectivity events as well as Call Data Records (CDRs) to the configured Virtual Gateway.

IBM users are able to monitor connectivity events and create different types of applications that consume both connectivity events and CDRs.


  1. IBM Watson IoT Platform - Create new device type Gateway

    Go to https://console.bluemix.net/

    Login with your IBM account


    Enter the Dashboard screen, and select “Create Resource”


    Select “Internet of Things” (use the “search the catalog” for quick filtering)


    The default settings are OK for now – press “Create”.


    Important: you must have “developer” permissions for the selected space (“dev” in the example above).


    After successful creation, you will see the option to launch the Watson IoT Platform:


    A new “Organization” (“Org”) entity will be created.

    This is a 6-character string, linked to a public DNS sub-domain (highlighted in the URL).

    Your “Org” name is also available in the top right hand side of the logged in user (see ID:84smzj in the example below).


    Press the “Launch” button to enter your newly-created organization.


    Select “Browse Types”, then click “Add Device Type”


    Choose a “Gateway” type, Name and Description, then click “Next”.


    In the next screen, Device Information is irrelevant, since the gateway is not a physical device.


    Click Next, then choose Register Device to create a gateway device, using our new type:


    Select “FloGateway” (or the name you gave the Gateway) as the device type, and choose an ID.


    Since this is not a physical device, it is safe to ignore the device information step.


  2. Set Gateway Privileged

    In the next screen choose “Privileged Gateway”, then click Next.


    Use an auto-generated token (or choose your own):


    The summary screen shows the gateway to be created.


    Click “Done”.

    The gateway is now created.


    Important: Save the authentication token since it will not be displayed again!

    In the below screenshot the token is “m6S@zzWjnAxZ7)cs&q”.



  3. Create Device

    We have no devices yet so press Back to return. You will see the gateway in the “Devices” screen:


    Create a device type in a similar way to creating a gateway type:


    Optional: enter any relevant details about this device type.


    Select “Register Devices” to add a device (this can also be done from the main devices screen)


    Enter a device ID


    Enter an authentication token manually or leave empty to generate one.


    Summary screen:


    Press back to return to the devices screen.

    Grant the gateway permissions to act on behalf of the device:


    Select one or more devices.


    At this point you will need to configure your IBM Watson Gateway and devices in your floLIVE account.




  4. FloLIVE Settings

    Make sure you have a floLIVE account.

    In case you don’t have one use the “Sign Up” option available at: www.portal.flolive.net  

    Fill in your details and wait for your account to be created.



    Provision the IBM gateway and devices in your floLIVE account:

    Login to your floLIVE account.


    Setup your IBM Gateway settings:

    Go to My Account page.

    Click the Info (“i”)  button on the My Statistics page.


    Enter your Organization name (“Org”), Gateway Device ID, Gateway Device Type and Gateway password (Authentication Token).

    Press the Update button.


    Setup IBM Device settings:

    Go to Inventory -> SIMs page.

    Select the SIM that is associated with your device and click on the Settings action button  on the right side of the table.


    The Device settings shall open the following dialog:


    Enter the Device ID and Type and press the Update button.


    At this point all floLIVE events that are associated with this device will be sent also to your IBM Watson IoT account.

  5. Monitoring Connectivity Events

    Monitor Device Connectivity Events: 

    To monitor incoming events through the gateway, select the desired device and choose the “Recent Events” tab (alternatively the “State” tab shows the last received data).


    After some events are received, go back and edit the interface for the device type.

    Create a simple interface and use the last event to create a list of properties that are mapped to the JSON keys in the event.


    Select all properties (the checkbox on the table header) and Watson will map the JSON keys into the device’s property table.


    Now, the device’s “State” tab will show the current value of the mapped properties.


    An example for an event of device connectivity to the mobile network (Action: Send Authentication Info):


    An example for an event of device connectivity to the mobile network (Action: Close PDP):


Join The Discussion