Stand with Ukraine flag
Try it now Pricing
Cloud
Community Edition Professional Edition Cloud Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application MQTT Broker
Europe
North America N. Virginia Europe Frankfurt
Documentation > Integrations > KPN Things
Getting Started
Devices Library Guides API FAQ
On this page

KPN Things Integration

Doc info icon
ThingsBoard PE Feature

Only Professional Edition supports Platform Integrations feature.
Use ThingsBoard Cloud or install your own platform instance.

Overview

KPN Things is an IoT (Internet of Things) platform provided by KPN, a telecommunications company.
This platform allows users to connect and manage their IoT devices, facilitating communication and data exchange between these devices and the cloud.
After integrating KPN Things with the ThingsBoard, you can connect, manage, communicate, process and visualize data from your devices in the ThingsBoard IoT platform.

Create integration

Follow the steps below to add the KPN Things integration:

  • Go to "Integrations center" section -> "Integrations" page and click "plus" button to create new integration. Select type "KPN Things". Click "Next";
  • At this step, choose "Create new" uplink converter. The new converter will contain necessary code to convert incoming data and click "Next";
  • At the step of adding a downlink converter, you can also select a previously created or create a new downlink converter. But for now, leave the "Downlink data converter" field empty. Click "Skip";
  • Specify your base URL. Please note down "HTTP endpoint URL" we will use this value later. Then, click the "Add" button. KPN Things integration is created.
Go to "Integrations center" section -> "Integrations" page and click "plus" button to create new integration. Select type "KPN Things". Click "Next";
Go to "Integrations center" section -> "Integrations" page and click "plus" button to create new integration. Select type "KPN Things". Click "Next";
At this step, choose "Create new" uplink converter. The new converter will contain necessary code to convert incoming data and click "Next";
At this step, choose "Create new" uplink converter. The new converter will contain necessary code to convert incoming data and click "Next";
At the step of adding a downlink converter, you can also select a previously created or create a new downlink converter. But for now, leave the "Downlink data converter" field empty. Click "Skip";
At the step of adding a downlink converter, you can also select a previously created or create a new downlink converter. But for now, leave the "Downlink data converter" field empty. Click "Skip";
Specify your base URL. Please note down "HTTP endpoint URL" we will use this value later. Then, click the "Add" button. KPN Things integration is created.
Specify your base URL. Please note down "HTTP endpoint URL" we will use this value later. Then, click the "Add" button. KPN Things integration is created.

We have pre-configured integration on ThingsBoard, but we need to configure KPN Things to send data to ThingsBoard.

Configure KPN Things

To configure KPN Things, you need to open KPN Things Portal and log in to your account.

The KPN Things Portal interface may change in the future.

Add new device:

  • Go to the “Things manager” tab, and click on the “Add new device”;
  • Choose the “Device Simulator”, set a name for your device, and click on the “Add device” button;
  • Install and open the “KPN Things Device simulator” app on your phone. Follow the instructions on your phone to scan this QR code. Then, click on the “Add Network Info” button;
  • KPN Internet Network is created. Now, click on the “Finish” button;
Go to the "Things manager" tab, and click on the "Add new device";
Go to the "Things manager" tab, and click on the "Add new device";
Choose the "Device Simulator", set a name for your device, and click on the "Add device" button;
Choose the "Device Simulator", set a name for your device, and click on the "Add device" button;
Install and open the "KPN Things Device simulator" app on your phone. Follow the instructions on your phone to scan this QR code. Then, click on the "Add Network Info" button;
Install and open the "KPN Things Device simulator" app on your phone. Follow the instructions on your phone to scan this QR code. Then, click on the "Add Network Info" button;
KPN Internet Network is created. Now, click on the "Finish" button.
KPN Internet Network is created. Now, click on the "Finish" button.

Link the device to the “Flow”:

  • Go to the “Flows” in left menu and click on the “My first flow” row;
  • Click on the “Link Device” button in the “Devices” row;
  • Click on the “Link” button next to the device you created earlier;
  • The device has been successfully linked to the “Flow”. Now, click on the “My Device” row;
Go to the "Flows" in left menu and click on the "My first flow" row;
Go to the "Flows" in left menu and click on the "My first flow" row;
Click on the "Link Device" button in the "Devices" row;
Click on the "Link Device" button in the "Devices" row;
Click on the "Link" button next to the device you created earlier;
Click on the "Link" button next to the device you created earlier;
The device has been successfully linked to the Flow.
The device has been successfully linked to the Flow.

Data processing setup for my flow:

  • A “Device & Connectivity detail” page will open. Now, go to the “Flows” tab, and click on “My first flow” row;
  • Click on the “Data Processing” row to open “Data Processing details” page;
  • Change the switch to enabled state for “Decoders” section;
Click on the "My Device" row;
Click on the "My Device" row;
The "Device & Connectivity detail" page will open. Now, go to the "Flows" tab, and click on "My first flow" row;
The "Device & Connectivity detail" page will open. Now, go to the "Flows" tab, and click on "My first flow" row;
Click on the "Data Processing" row to open "Data Processing details" page;
Click on the "Data Processing" row to open "Data Processing details" page;
Change the switch to enabled state for "Decoders" section;
Change the switch to enabled state for "Decoders" section;
Your change has been saved.
Your change has been saved.

Add new Destination:

  • Go to “Destinations” in left menu and click on the “Add new Destination” button;
  • Find the “ThingsBoard” destination type, and click on “Choose ThingsBoard” button;
  • Set a name for your destination.
  • Paste “HTTP endpoint URL” from ThingsBoard integration page to “HTTP endpoint URL” field.
  • Now, click on the “Generate” button, and save generated value. We will use it on ThingsBoard.
  • Click on the “Add ThingsBoard Destination” button;
Go to "Destinations" in left menu and click on the "Add new Destination" button;
Go to "Destinations" in left menu and click on the "Add new Destination" button;
Find the "ThingsBoard" destination type, and click on "Choose ThingsBoard" button;
Find the "ThingsBoard" destination type, and click on "Choose ThingsBoard" button;
Set a name for your destination. Paste "HTTP endpoint URL" from ThingsBoard integration page to "HTTP endpoint URL" field. Now, click on the "Generate" button, and save generated value. We will use it on ThingsBoard. Finally, click on the "Add ThingsBoard Destination" button.
Set a name for your destination. Paste "HTTP endpoint URL" from ThingsBoard integration page to "HTTP endpoint URL" field. Now, click on the "Generate" button, and save generated value. We will use it on ThingsBoard. Finally, click on the "Add ThingsBoard Destination" button.

Link the “Destination” to the “Flow”:

  • Go to the “Flows” -> “My first flow” and click on the “Link Destination” button in the “Destinations” row;
  • Click on the “Link” button next to the destination you created earlier;
  • The “Destination” has been successfully linked to the Flow.
Go to the "Flows" -> "My first flow" and click on the "Link Destination" button in the "Destinations" row;
Go to the "Flows" -> "My first flow" and click on the "Link Destination" button in the "Destinations" row;
Click on the "Link" button next to the destination you created earlier;
Click on the "Link" button next to the destination you created earlier;
The "Destination" has been successfully linked to the Flow.
The "Destination" has been successfully linked to the Flow.

Update integration

In order to validate the sender we can add a token to integration on ThingsBoard. To do this, please follow the steps below:

  • Go to "Integrations center" section -> "Integrations" page and click on the integration you created earlier. Click on "Edit" button to enter edit mode.
  • Switch "Enable security (Headers filter)" toggle to enabled state and click "Add" button in "Headers filter" section.
  • Put "X-Things-Secret" to "Header" field and generated token to "Value" field. Finally, apply changes.
Go to "Integrations center" section -> "Integrations" page and click on the integration you created earlier. Click on "Edit" button to enter edit mode.
Go to "Integrations center" section -> "Integrations" page and click on the integration you created earlier. Click on "Edit" button to enter edit mode.
Switch "Enable security (Headers filter)" toggle to enabled state and click "Add" button in "Headers filter" section.
Switch "Enable security (Headers filter)" toggle to enabled state and click "Add" button in "Headers filter" section.
Put "X-Things-Secret" to "Header" field and generated token to "Value" field. Finally, apply changes.
Put "X-Things-Secret" to "Header" field and generated token to "Value" field. Finally, apply changes.

That’s all that is needed to configured integration between KPN Things and ThingsBoard. Now we can send data from KPN Things to ThingsBoard.

Now let’s use the “KPN Things Device simulator” app to send a message with the data to the ThingsBoard. Click the “Send data now” button in the app.

Use the "KPN Things Device simulator" app to send a message with the data to the ThingsBoard. Click the "Send data now" button.
Use the "KPN Things Device simulator" app to send a message with the data to the ThingsBoard. Click the "Send data now" button.

After you sent message a new device was created in your ThingsBoard instance.

Go to the ThingsBoard instance, then navigate to the “Devices” page. Here you will find a new KPN Device and information about it as well as the telemetry that we sent to the device.

Go to the "Devices" page. Here you will find a new KPN Device and information about it as well as the telemetry that we sent to the device.
Go to the "Devices" page. Here you will find a new KPN Device and information about it as well as the telemetry that we sent to the device.

Go to the “Integrations” page, select “KPN Things integration” and navigate to the “Events” tab. There you’ll see the message consumed by the KPN Things integration.

Go to the "Integrations" page, select "KPN Things integration" and navigate to the "Events" tab. There you'll see the message consumed by the KPN Things integration.
Go to the "Integrations" page, select "KPN Things integration" and navigate to the "Events" tab. There you'll see the message consumed by the KPN Things integration.

Next steps