Blockbax Integration

Blockbax is a platform designed to automate business operations through sensor and machine data without the need for coding.

With a few click you can integrate data captured by BACE IoT Platform into Blockbax and create very powerful dashboards to help make sense of your data.

Steps to follow

1. Creating an inbound Connector in Blockbax Project

2. Creating an access token in Blockbax project

3. Creating a webhook in BACE IoT Platform

4. Creating a new subject type in Blockbax

5. Creating a subject in Blockbax

Creating an inbound connector in Blockbax Project

In this step you will create an inbound connector to generate a URL endpoint for Webhooks to be sent from BACE IoT Platform.

1. Login to your Blockbax account. Go to Settings -> Inbound Connectors -> (+) Create Inbound connector.

2. Provide a name (i.e. BACE Gateway) and under Use template conversion dropdown select BACE IoT Platform: Measurements webhook When finished click Create connector

3. Inbound connector is created with a unique endpoint that allows sending data into Blockbax platform. The URL in endpoint field will be used during webhook creating in BACE.

Creating an Access token in Blockbax integration

For integration into Blockbax, you'll also need an access token to send messages to Blockbax endpoint.

1. Go to Settings -> Access Token -> (+) Create access token

2. Give a name to access token (i.e. BACE Integration), and set permission to Measurement writer. Click Create access token

3. You will need authorization token for HTTP, so keep ApiKey <TOKEN> in the next step for authorization.

Creating a Webhook in BACE IoT Platform

In this step, we'll explain how to create a webhook in BACE IoT Platform that will push information to Blockbax inbound connector created in previous step.

1. Login to BACE Panel and click into one of the project that you want to integrate into Blockbax.

2. On left navigation click Integrations -> Webhooks

3. Click Create a Webhook and provide a name to the webhook (i.e. Integration to Blockbax). Make sure to paste URL copied from Blockbax inbound connector into Webhook URL field.

4. Paste the Access token created in previous step inside Authorization field. Paste ApiKey <Token> in this field. DO NOT include Authorization: text.

5. When successful you should start seeing Webhook responses inside Blockbax inbound connector

5. If you are seeing some messages below loging, the messages are pushed into Blockbax as expected and next step is creating a subject type for these messages.

Creating a new subject type in Blockbax

For processing data in Blockbax, you need to map incoming data from BACE IoT platform to a Blockbax subject type first. Subject types are like device templates that helps you connecting similar equipment in bulk easily.

1. You need to create Metrics for all data points pushed from BACE IoT Platform. For finding out which datatypes are pushed from BACE, in BACE Panel Go to Modbus Devices -> Click one of the Gateways -> Device Info. As you can see from the example below Local port, Serial Baud rate, Module Adress and DO Power on-state are being read by BACE.

2. Create a new subject type by clicking Subjects -> Types -> (+) Create a new subject type

3. Provide a name that you can remember. In this example, we are integrating an Ebyte Modbus IO module so we named it with Ebyte IO Module

4. In next screen click Create Metric to add all metrics into the subject type.

5. Select ingested, relevant data type and click Create Metric. In this step you can also define additional attributes like unit, upper bound, etc. Refer to Blockbax documentation for each option.

6. Add all metrics you want to see in Blockbax dashboard

7. When finished with adding all metrics, you can create a subject using the subject template.

Create a Subject in Blockbax

In next step you need to create a new subject using the subject type that was created in the previous step.

1. Go to Subjects -> Overview -> (+) Create a new subject

2. Select the subject type you have created in previous screen, and provide a name. External ID should match the source_device attribute in the BACE Webhook response. This UUID is also available in the BACE Panel URL

UUID of the source_device

Paste UUID in External ID Field

3. Click Create Subject to finalize

4. You have successfully integrated data from BACE Platform into Blockbax now! You can continue with creating custom dashboards following steps in Blockbax documentation.