Rashed Talukder

Built.io Flow: Caffeinate Complex Workflows (1 of 3)

Blog Post created by Rashed Talukder on Dec 21, 2015


Introducing Built.io Flow

As we're about to enter a new year, what's a better way to start than to add a new tool to your developer arsenal and be able do more with less work? Built.io's Flow platform lets you do exactly that and so much more. Flow is an iPaaS that allows us to take processes and business rules that were very complex and time-consuming to code and simplify everything using visual tools requiring mere minutes of work. With a long list of 3rd party integrations (and getting longer), you can now tie some of the most common services into one easy to create visual workflow with no middleware to set up, monitor, and maintain.


As part of the list of integrations available, I'd like to announce the addition of the first set of Jive APIs that are now available in this powerful tool. You can now access Jive content, people, and places within Built.io Flow to not only get and create content from sources, but also enrich your Simple Activity Stream Integrations by combining data from multiple sources before sending your payload to Jive—an easy way to overcome the 250ms limit for processing your transform function without.




Using Built.io Flow for Jive Inbox Action

In this example, we'll demonstrate how to use Built.io Flow to create an Action Activity to send to any user's inbox. This is so quick and easy that it should take under 5 minutes from start to finish to repeat this process.

Screen Shot 2015-12-17 at 6.43.19 PM.png



Getting Started

After signing up for your Built.io Flow trial account and logging in, you'll be presented with a screen displaying all of your flows. We'll start by clicking +CREATE NEW FLOW in the top right corner. For the Flow Name field, we'll enter "Jive Action Inbox"; the other fields are optional.


Screen Shot 2015-12-17 at 4.22.59 PM.png



Adding Jive Create Action Activity

Click on ACTIVITIES on the right hand tab that's sticking out from the right edge of the browser view. Scroll down to the Jive integration and then drag the Create Action service onto the canvas.

If you're using Jive Anywhere (you should if you aren't), the ACTIVITIES tab may be hidden by the Jive Anywhere tab in your browser.

Screen Shot 2015-12-17 at 5.13.41 PM.png



Adding Custom Parameters

Click the gear icon and then the + icon to add a parameter. We'll be creating a parameter with a key of "user_id" and value of "undefined". This key will be passed in later on in a POST request with a value of our choice to the webhook subscription endpoint for our flow.

Screen Shot 2015-12-17 at 5.22.46 PM.png



Configure Jive Activity Action Service

  1. Review our REST API documentation for the Activity Action service.
  2. Connect to your Jive Instance with your Basic Auth credentials by selecting "Add New" from the Jive Connection dropdown menu.
  3. Enter a title to be displayed to the user for the notification—"Was this easy or what?"
  4. Enter content "Low cost and low commitment user feedback is great!"
  5. For the Person URLs, since we'll be only calling one user per call, we're going to enter the following:
  6. Add an action link for the user to give a response. Include a caption for the response button, HTTP verb, and URL
    • NOTE: The entry into the target URL field is not a client redirect but a server-side request. The Jive server will perform the http request with the defined method once the user clicks the button.
  7. Click Done.

Screen Shot 2015-12-17 at 6.19.25 PM.png



Finishing Touches

  1. Map the connectors from the start to the Jive Create Action service to the flow end icon.

  2. Enable the webhook from the flow start module and copy the URL.

  3. Press SAVE.
  4. Use CURL or POSTMAN to send a POST request to the subscription URL you just copied and URL encode the user_id key and your Jive user ID as the value.
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d 'user_id={JIVE USER ID}' 'https://flow.built.io/run/XXXXXXXXXXX'

Screen Shot 2015-12-17 at 6.26.49 PM.png



What's Next

  • In the next update, we'll tackle a very common use case where we will integrate other services to bring data into Jive and Jive initiating another workflow to add data into another service!