How-tos

Unified Inbox on Bluemix: What does UnificationEngine do?

Share this post:

With Unified Inbox’s UnificationEngine™ intelligent IoT messaging platform, users can communicate with their smart devices. Often called human-to-machine (H2M) communications, UnificationEngine enables users to send and receive messages to over 20 different global communications channels, including SMS, email, and the most popular social media, messaging, and chat platforms.

What will your users be able to do with UnificationEngine? With UnificationEngine intelligent IoT messaging, they will be able to remotely control and receive alerts and notifications from their smart devices on the communications channels they use most. In a smart home for example, UnificationEngine lets users text their refrigerators. Why? So they can receive a “shelfie” from their fridge right in the supermarket aisle so they know if they need to buy milk.

Also, in a smart enterprise, operators can receive a WhatsApp message before a critical machine part needs replacing. And residents in a smart city can send Facebook messages to their bus to find out how much longer before it reaches their stop and how crowded it is.

How do I add UnificationEngine to my Bluemix dashboard?

Images with boxes in a circle

 

  1. Register for Bluemix

Sign up for Bluemix. It’s free!

2. Open up the Bluemix catalog

3. Search for “UnificationEngine”

4. Click on the UnificationEngine service (you’ll see the page below)Unified Inbox service page in the Bluemix console

How do I integrate my app with UnificationEngine?

Note: If you already have a UnificationEngine developer account, you can skip step #1.

  1. Create a UnificationEngine developer account at https://developer.unificationengine.com/.Registration button
  2. Create your app in UnificationEngine by registering your app’s name at https://developer.unificationengine.com/apps. When you create the app, it will  automatically generate an app key (APP_KEY) and secret (APP_SECRET). The image below shows the APP_KEY and APP_SECRET for an app called ‘test.’ This key and secret are used to create users for your app.Create App buttonKey Data - App Details
  3. Click the ‘Add Connector’ button to add a connector from the available list of UnificationEngine connectors to the app you just created. Note: If you want to add a custom connector, including proprietary enterprise and/or secure government connectors, please contact us at info@unifiedinbox.com.Add Connector window
  4. Create a user. When created, you’ll see an access key (USER_ACCESS_KEY) and secret (USER_ACCESS_SECRET). The access key and secret are required for all API calls (i.e., add connection, send message, etc.). Read more at https://docs.unificationengine.com/#create-user. Scroll from left to right to see all the code.

    curl -XPOST https://apiv2.unificationengine.com/v2/user/create -u APP_KEY:APP_SECRET
    –data ’{}’ -k

    The API for the created user will look like this with USER_ACCESS_KEY and USER_ACCESS_SECRET:


    {
    "status": 200,
    "info": "OK",
    "uri":"user://USER_ACCESS_KEY:USER_ACCESS_SECRET@"
    }
  5. Add a connection to the user of the app. Read more at https://docs.unificationengine.com/#add-connection. Scroll from left to right to see all the code.

    curl -XPOST https://apiv2.unificationengine.com/v2/connection/add -u
    USER_ACCESS_KEY:USER_ACCESS_SECRET
    --data'{"uri":"CONNECTOR_SCHEME://CLIENT_ID:CLIENT_SECRET@CONNECTOR_SCHEME.com","name":"UNIQUE_CONNECTION_NAME"}'

    Connector Details window

    • USER_ACCESS_KEY — UnificationEngine user access key
    • USER_ACCESS_SECRET — UnificationEngine user access secret
    • CONNECTOR_SCHEME — UnificationEngine connector scheme (see image above)
    • CLIENT_ID — client id for the respective service or channel (obtained from the respective service’s app dashboard)
    • CLIENT_SECRET — the client secret of the respective service or channel (obtained from the respective service’s app dashboard)
    • UNIQUE_CONNECTION_NAME — unique name for the connection

    After successfully adding a connection, you’ll see a response like this:


    {
    "status": 200,
    "info": "OK"
    }
  6. Send a message from your connector. Read more at https://docs.unificationengine.com/#send-message.

    curl -XPOST https://apiv2.unificationengine.com/v2/message/send -u
    USER_ACCESS_KEY: USER_ACCESS_SECRET
    --data "{ \"message\": { \"receivers\": [{\"name\": \"name\", \"address\": \"TO_ADDRESS\" ,
    \"Connector\": \" UNIQUE_CONNECTION_NAME \"}],\"sender\": {\"address\": \" FROM_ADDRESS \"  },
    \"parts\": [{\"id\": \"1\",\"contentType\": \" text/plain \", \"data\":\"test message body\" ,\"size\":MESSAGE_BODY_SIZE,\"type\": \"body\",\"sort\":0}]}}"

    After successfully sending a message, you’ll see a response like this:


    {

    "status": 200,

    "info": "OK",

    "URIs" :"facebook://facebook.com/648738109689982912377"

    }

Well done! You have now sent and received messages using UnificationEngine! Feel free to post your comments and questions to this blog article.

More How-tos stories
April 30, 2019

Introducing IBM Analytics Engine v1.2 and Announcing the Deprecation of IBM Analytics Engine v1.0

We are excited to inform you about the new version of IBM Analytics Engine v1.2 that will be available starting May 15, 2019. Along with this release, Analytics Engine v1.0 will be retired.

Continue reading

April 23, 2019

Announcing the Deprecation of the Watson Machine Learning JSON Token Authentication Service

We’d like to inform you about the deprecation of the Watson Machine Learning JSON Token Authentication service. This method of authentication will be retired on May 30, 2019.

Continue reading

April 9, 2019

IBM Cloud Continuous Delivery is Now Better with Unlimited Insights

Starting this month, we are bundling IBM Continuous Delivery and IBM DevOps Insights to make the build, test, deploy, and learn experience on IBM Cloud even better.

Continue reading