Skip to main content

Plugins: Connect Swarm Hive with Ubidots

Receive and decode data from devices connected to Swarm Hive network

David Sepúlveda avatar
Written by David Sepúlveda
Updated over 10 months ago

Ubidots and Swarm Hive have partnered to create a pre-built integration that creates a private Endpoint URL optimized to receive Swarm Hive's JSON payload.

Requirements

1. Creating a Swarm Hive Plugin

Step 1: In your Ubidots account, click on the "Plugins" option under the "Devices" navbar menu, then click on the "+" icon in the upper right corner and select Swarm Hive:

Step 2: Configure your Plugin according to these input settings:

Inputs

  • Ubidots device type: An Ubidots device type will be created and linked to this plugin. This allows you to make batch changes to all of the devices that receive data through this plugin.

  • Ubidots TOKEN: Select the Ubidots token you'd like to use for this plugin.

image.png

Step 3: Finish the process and a new plugin will appear in the Plugins list:

image.png

Step 4: After creating the plugin, click on the Edit button, then go to Decoder, and copy the HTTPs Endpoint URL. The structure of the URL is the following

https://dataplugin.ubidots.com/api/web-hook/<PLUGIN-ID>
image.png

Also, keep at hand your Ubidots TOKEN, it will be needed in the following steps.

Step 5: Go to your Swarm account, click on Delivery then on New Delivery Method
Step 6: Pick a name for your WebHook, and fill these fields:

  • Acknowledge messages on successful delivery: checked

  • All devices: checked

  • URL: Enter your Plugin HTTPs Endpoint URL.

  • In the headers section, enter the below 2.

  • Content-type: application/json

  • X-Auth-Token: {Ubidots-account-token}

At the end, your Swarm webhook configuration should look something like this:

image.png

Step 7: Go back to Ubidots, edit the Decoding Function shown in the Decoder section of the plugin to match your customized payload.

image.png

2. Editing a Swarm Hive Plugin

To edit the Plugin, simply click on the Edit button in the Plugins list view:

image.png

The same Input fields that appeared during the creation process will appear. Please note that, every time the Plugin is updated, a provisioning script will run, overriding the current attributes of the target device:

image.png

3. Feedback and suggestions

Feel free to post questions or suggestions in our community portal, or drop us a line at support@ubidots.com.
Learn more about other plugins:

Did this answer your question?