Loriot

Webhook Output Setup

Setting up a Webhook Forward for Loriot is pretty simple. First of all, open up the management console on your Loriot Instance or the public version and head over to the Application which Data you want to forward to Datacake.

Open Outputs

In the overview of your Application navigate into the "Output" Section using the sidebar.

Add new Output

Now add a new Output by pressing on the "Add new output" Button.

Select Output Type

Now choose the "HTTP Push" Output type and provide the details needed to set up the output in the configuration field on the right side.

Enter Webhook URL

Fill in the following URL into the "Target URL for POSTs"-Field on the configuration Modal just like shown on the screenshot below.

https://api.datacake.co/integrations/lorawan/loriot/

Webhook URL

Add Output

After you have pasted the URL into the Target URL field you can create the Output by pressing the "Add Output" button below.

When the setup was successful you will see the newly created output in the outputs overview. This will look like on the following screenshot:

Authentication (Optional)

If you want to make your Webhook more secure you can create an API Token for your Loriot Devices on Datacake and paste this Token into the HTTP Push configuration.

This step is optional and not required. Forwarding Data via Webhook will also work without providing a Token and is secured by SSL encryption anyways.

Create Token

In the Members section of your Datacake Workspace, you have to create a new Token and set the Devices Workspace Permissions just like on the following screenshot.

Learn more about creating API Tokens here:

API Users

After adding a new API User to your Workspaces Members you can copy the API Token from the overview panel.

Paste Token

Paste this copied token into the "Custom Authorization header value" field on the HTTP Push Output configuration in your Loriot Application. Please make sure it's done in the following way:

Token 123456mytoken123456datacake

See the following screenshot as an example:

The final overview will look something like the following screenshot:

Enable Authentication on Device

Last but not least you have to enable Webhook Authentication on the Datacake Device so that only Authenticated Webhooks are allowed to record Data into that device. This works by simply accessing the device configuration and setting a single checkbox.

Downlinks

Thanks to Loriots' perfect API and Integration section, setting up a Downlink Integration, so that you can send Downlinks directly from your Datacake Devices and Templates, simply requires copy and paste of a Loriot API Token.

The following steps will show you how easy this is.

Create an Access Token

In your Loriot Application simply open up the "Access Token" section and create a new access token.

Creating a new Access Token works by clicking on "Generate another authentication token" in the top right panel.

Copy Token

Now click on the "Eye Icon" to make that truncated Token visible and copy the complete string.

Paste Token on Datacake

This Token has to be pasted into the Datacake Device which you want to enable for sending Downlinks. To do this head over to the Device Configuration on Datacake.

Now scroll down a bit until you reach the LoRaWAN configuration panel.

Paste the Loriot Token into the field "LORIOT Access Token" and press "Save Changes" and the end of this configuration panel.

Token-Validation will happen right after you have pressed this button and if the Token was validated successfully you will see this in the Label next to the Token-Input-Field.

That's it. Downlinks are now enabled for this device.

Debugging

If you want to see if Downlinks have been successfully transmitted to Loriot you can do that on the Debug-Tab. Simply open up the Debug-View by navigation to "Debug" on the Device-Tab-Bar.

On the Debug-View, you'll find successful and unsuccessful Loriot Communication Calls and an error description if something went wrong sending the Downlink.