How To Create A Bip

What's a Bip, anyway?

A Bip is a powerful web automation agent.  A Bip can connect many different web services together for performing useful work and either act on your behalf or on command. Bips can perform actions in sequence or in parallel, and chain web services together in unlimited combinations.

Creating A Simple Bip

Bips can be created in the dashboard under "My Bips" > "+ Create A Bip"

Clicking on Create A Bip will take you to the blank canvas of the Bip editing screen, which will be waiting for you to create your integration.

To jump straight into it, we'll be stepping through this video

* Step 1 - Select An Event Source

Bip's work by receiving messages when something happens on your connected services or devices, and then performing a series of actions as a result.  Every Bip needs an event source to listen on.  To start creating a Bip, click the "Select Event Source"  button, or the big "+" button in the center of the canvas.

You'll see a list of services, or "Pods", that have event sources.  Clicking on a Pod icon will display a list of available events for that Pod.  For this example, we're going to listen for Twitter Mentions

 With an event source selected, you can now start adding actions to perform when that particular event happens.

As your Bips become bigger and more complex, you'll always be able to keep track of your event source by it's pulsing rings.

Step 2 - Add An Action (Or Many Actions!)

You'll notice the context of your editing canvas has changed from 'Select Event Source', to 'Add An Action'. Actions do something with your selected Event.  You can perform many different actions at once, or chain them together to operate in series.  For this simple bip however, we want to send an email to ourselves whenever the Twitter Mention event fires.  

Clicking on "Add An Action" will again display a list of Pods, now with available actions.  For this example, search for 'Profile' and then select 'Email Me'

Step 3 - Connect Actions To Your Event

Almost there!

Adding actions to the canvas doesn't mean that the two services are yet connected.  To connect the services together, drag your mouse or touch device from the event source, to the new action.  Valid targets will start to pulse as your arrow line draws near.  Release your mouse or device to connect the two together.

Use the same method of dragging from source to destination for whatever other actions you add.  F
rom Event to Action, or Action to Action.  Actions can be chained together indefinitely, and messages move across a Bip in the direction of the arrows.  For the example, the arrow is saying 'The Twitter Mention event sends something to my Profile action'.

An important concept to remember is that every action that a node is connected to, run in parallel to each other.

Step 4 (optional) - Personalize Your Connections tries its best to automatically determine how different services should connect to each other, but most times you'll want to create connections that are tailored just for you.  This is called a Personalization, which is a way of mapping the result of an event or action on your bip, as the input of another action on your bip.  To control how data is personalized and mapped to a target action, double click/tap the action on the canvas.  This will display the Personalizations menu.  Only actions which are connected to something can be personalized.

Personalizations can include any text you like, including a composition of different attributes from parent events and actions.  To add an attribute from the source event as the 'subject' field for example, click the "+ Attributes" button, to make an attribute selection to inject into your personalization.

Once you're happy with how the message to your action has been personalized, click OK to return to the bip editing canvas.  You can personalize an action at any time by double clicking the action.

Find out more about Personalizations in the knowledge base article 
Personalizing Your Integrations

Step 5 - Save Your Bip, It's Time To Relax!

That's it!  Click "Save" to save your bip and have it do work.

If you're a developer, you might also want to take a look at How To Create A Web Hook and How To Create An Incoming Email

Feedback and Knowledge Base