> For the complete documentation index, see [llms.txt](https://docs.efento.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.efento.io/nb-iot-loggers/integrations/akenza.md).

# Akenza

[Akenza](https://akenza.io) provides native support for Efento devices within their CoAP Device Connector. This means Akenza automatically processes your Efento device identifiers and securely handles uplink authentication without requiring manual payload decoding.

Follow this guide to configure your Efento sensors and establish data delivery to Akenza.

{% hint style="warning" %}
This integration is currently only compatible with the Efento 4-20 mA analog sensor interface. It will not function with other Efento sensor models or interface variants.
{% endhint %}

{% stepper %}
{% step %}

## Prepare the Akenza Platform

Before configuring your Efento hardware, you need to set up the corresponding cloud infrastructure in your Akenza workspace to obtain your connection keys.

### 1. Create a Data Flow

1. Log in to your Akenza account.
2. Navigate to **Data Flows** and create a new flow ("Start with empty Data Flow").
3. Choose the **CoAP Device Connector** as your entry point block. Once created, copy the generated Uplink Secret (Custom Token). You will need to input this string into the [Efento sensor configuration](#configure-your-efento-sensor).
4. Add a **Device Type** block and select "4-20 mA Analog Sensor Interface" from the library.
5. Add an **Output Connector** block. Akenza offers multiple output connectors depending on where you want to route your data (e.g., AWS, Azure, custom webhooks). For the purpose of this tutorial, select the **Akenza Database** connector to save and view the incoming device data directly within the platform.

<figure><img src="/files/LngpfOvFmpqNpDEKcnDm" alt=""><figcaption></figcaption></figure>

### 2. Register Your Efento Device

1. In Akenza, go to **Devices** and select **Create Device**.
2. Name the device, optionally add description, tags and custom fields
3. Assign the Data Flow you created in the previous step.
4. For the Device ID, use your Efento logger's serial number.

{% hint style="warning" %}
Remove all colons from the serial number. *Example:* If your Efento device ID is `28:2C:02:43:28:2E`, enter it into Akenza as `282C0243282E`
{% endhint %}

<figure><img src="/files/kyaoHNyJXjseZ30YSKxK" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Configure Your Efento Sensor

To point your Efento sensor to the Akenza endpoint, you must use the Efento mobile application for [iOS](https://apps.apple.com/pl/app/efento/id6479740909) or [Android](https://play.google.com/store/apps/details?id=pl.efento.cloud\&hl=en).

{% hint style="warning" %}
If you use Android application, enable Power User Mode: Open the Efento mobile app menu and quickly tap the Efento logo 5 times.
{% endhint %}

1. Verify the NB-IoT connection: Before proceeding with the configuration, confirm your cellular network allows data transport to your private server destination - connect to your sensor over Bluetooth in the app, open the settings menu (Android - three dots, iOs - gear icon) and select **Cellular network status** and verify that Registration status reads either `REGISTERED` or `REGISTERED_ROAMING`.
2. Set the Target Server Address: Navigate to **Server Configuration - >Data Server**, select **Other** and input the server address as: `coap.akenza.io` , port `5683`.
3. Set the Authentication (Server configuration -> Authentication): Set the authentication type to **Custom Token**.
   1. Paste the Uplink Secret copied from the [Akenza CoAP connector](#id-1.-create-a-data-flow).
   2. Ensure that the option to send the token in the payload is explicitly enabled.
4. CoAP Endpoint Paths (Server configuration -> CoAP endpoints): Update the resource paths exactly as follows:
   1. Data: `efento/m`
   2. Configuration: `efento/c`
   3. Device Info: `efento/i`
   4. Timestamp: `efento/t`
      {% endstep %}

{% step %}

## Verify the configuration

Once you have successfully completed the configuration on both the Akenza platform and your Efento logger, the device will begin transmitting its telemetry data. You can verify that everything is working correctly by navigating to the **Devices** section within your Akenza workspace. There, you will see the incoming payload decoded in real-time, confirming that your 4-20 mA analog readings are successfully reaching Akenza and being saved to the database.

<figure><img src="/files/yK0RnRXcit9t2Zu2AZ4v" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.efento.io/nb-iot-loggers/integrations/akenza.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.