Olisto Connect is quite a new and different channel than you’re used to. Connect requires knowledge of programming, creativity and some basic understanding how HTTP calls and requests work. So let’s give you a quick rundown on how to get started with Olisto Connect. We assume you have a Olisto account and you added Olisto Connect as a channel. If you haven’t done this yet, do it now and come back. I will wait here for you…

Good to be back! So Olisto Connect is a new channel. These are the steps you must take for the first time only to get started:

  1. Go to Olisto.com/connect. Here you will find a button to go to our login screen. Use your Olisto loginname and password to login.
  2. After login, you are redirected to our site and you can make your first Connector.

What is a Connector?

That’s an excellent question. A Connector is a special connection we make between your project and Olisto. This Connector consists of two parts, a private URL and a public token. With this Connector you make the connection between your own code or project and the Olisto channels. You use the Connector name in your triggs in the app.

The private URL is an unique URL you can use to send web requests to. When you use the Connector as a condition in your trigg (in the WHEN part of the trigg), every webrequest to the private URL will activate it and make that part of the condition true.

The public token is a shortcode you can give to others. They can use the token as a condition in their triggs. Whenever your project or machine sends out a webrequest to your private URL, the public tokens get a signal as well and will activate. This makes Olisto Connect very powerful to share sensorinformation, specific activations or anything else you can think of.

How do you make a Connector

Let’s move on with our tutorial. You are logged in and you are on the page “Make your Connector”.

  1. You now give your Connector a logic name like “Home Rainsensor” because you want to connect your rainsensor to Olisto.
  2. Click on Save Connector.
  3. You will now see a few new fields: The name of your Connector, the private URL and the public token.
  4. We will email this information to your email address and the new Connector is available in the Olisto app.
  5. You can now use the URL in your own project to activate a webrequest. You will only have to call the URL via a GET-request. You can send variables and data with the URL. More on that in a minute

You can use curl on the commandline to activate the URL

curl https://connect.Olisto.com/c/YOUR_UNIQUE_CODE

In PHP:

$response = http_get("https://connect.Olisto.com/c/YOUR_UNIQUE_CODE")

NodeJS

var http = require('http');
var options = {
host: 'https://connect.Olisto.com/c/YOUR_UNIQUE_CODE',
port: 80
};
http.get(options, function(resp){
resp.on('data', function(chunk){
//do something with chunk
});
}).on("error", function(e){
console.log("Got error: " + e.message);
});`

How do I use the private URL?

For this demo I will make an example with a QR code to show you how it works. How would’ve thought QR codes could still be useful 😉 On the website QR Code generator you can make your own QR code. There are dozens of these websites around, pick the one you like.

  1. Enter the private URL of your Connector and click “Confirm”
  2. You can now download the QR code as an image and use it anyway you like. With any QR reader from the iOS appstore or Google Playstore you can scan the code and you will see it goes to your private URL.

The next step is to make a trigg that actually does something when you scan the QR code. In Olisto you can use the Connector as a condition. Let’s just make an action with a push notification. Save the trigg.

Now you can scan the QR code and you will get a push notification. This is a simple first way to use Olisto Connect and make your own projects. You can even go further. Why not program a NFC sticker at your desk with a specific private URL. When you put your Android phone on it, you can activate lights and other services all at once.

How do I use the public token?

So how could you use the public token in this case? Let’s go back to the example of the rain sensor. You made a Connector and you have your own trigg where you get a notification everytime the sensor catches some rain above a certain level. On top of that you also log the data in a Google Sheet for later analysis.

Your neighbor is interested in your projects and he wants to get an email every time your sensor catches rain. All you have to do is give him the Public Token that belongs to the right Connector. Your neighbor also uses Olisto and Olisto Connect. He doesn’t have to go the website and he doesn’t have to make his own URL. All he does is make a condition with Olisto Connect, choose Add connector and fill in the public token he got from you. He then gives it a recognizable name like “Rainsensor neighbor” and he can use it as a condition. His action is to send an email.

That’s it. Every time your rain sensor is activated your trigg will be activated, but the trigg of your neighbour as well. You can give the public token to as many people as you want. Every Connector you make comes with one public token you can give out. You could even publish it on the web so others can connect to your projects. Whether that’s a rainsensor, your Raspberry Pi camera or a homemade robot that sends out messages. Let your imagination run free

How to use values?

You can send values through Olisto Connect. For now, you can send them as a parameter after the URL with ?value=VALUE (for instance https://connect.triggi.com/c/abcd124?value=100 or https://connect.triggi.com/c/abcd124?value=Hello%20World. You can pick up the value in the Olisto app through the variables list in every textarea and send it to any other channel. Within the Olisto Connect conditions, you can check if the value is above or below a certain treshold.

How to use Olisto Connect as an action

The above explains how to use our Connect channel in the condition. You could also activate a Connector when a condition is true. That way you could chain different triggs together. Or you can activate a specific Connector with a value as well. Finally, you can send HTTP requests to a specific URL. For instance to activate other webhooks, APIs or your own local services. You can use URL parameters in the request, use a JSON payload or form-urlencoded values. This all depends on the service you are calling.

Olisto Connect opens a whole new world

We believe that Olisto Connect is a great way to connect your own devices and projects to Olisto, as long as you know how to program it. Olisto Connect might not be for everyone, but the Public Token is an interesting way to share your projects with others. We just got started with this and we look forward to see what sort of connections you can come up with.

Share your project

Did you make something awesome with Olisto Connect and do you want to share it with the rest of the world? Come on over to the Olisto Community and share your ideas and triggs with others. It is OK to share your public token here as well but be aware that the forum is an open space that’s searchable and your token can be used by anyone that sees it. If you’d like more control over your token, share it private with others.

Do you have more questions on Olisto Connect? Our Knowledge Base already answers a lot of questions, we hope. See if you can find the information there. If not, let us know in the forum.