# 1NCE

### Overview

Qubitro offers a no-code integration with the 1NCE Cloud Integrator, enabling automatic synchronization of devices and telemetry data between 1NCE and Qubitro.

{% hint style="success" %}
Currently, this integration supports **Telemetry Data** event types and both **key-value JSON** and **hex string payloads**. 
{% endhint %}

{% hint style="info" %}
Hex string payloads can be decoded automatically using Hex Payload Decoders.
{% endhint %}

### Prerequisites

* [x] Administrative access to both Qubitro and 1NCE accounts.
* [x] A Qubitro account with an existing project.
* [x] A 1NCE account with active devices sending data.

### How It Works

Below is the diagram that shows how the integration works.

{% @mermaid/diagram content="graph LR;
A\[Device sends data to 1NCE] --> B\[1NCE Cloud Integrator Webhook];
B --> C{Device in Qubitro?};
C -- No --> D\[Create Device];
C -- Yes --> E\[Existing Device];
D --> F\[Decode & Store Data];
E --> F;

%% Gray Styles
style A fill:#d9d9d9,stroke:#000,color:#000;
style B fill:#eaeaea,stroke:#000,color:#000;
style C fill:#f2f2f2,stroke:#000,color:#000;
style D fill:#eaeaea,stroke:#000,color:#000;
style E fill:#eaeaea,stroke:#000,color:#000;
style F fill:#d9d9d9,stroke:#000,color:#000;" %}

{% hint style="warning" %}
If a [Transformation Function](https://docs.qubitro.com/platform/functions/transformation-function) is enabled, data will be processed before storage. The built-in decoder applies first, and then any defined transformation function modifies the data before it is stored in Qubitro.
{% endhint %}

### Configuring the Integration

{% stepper %}
{% step %}
**Create an Integration in Qubitro**

1. Log in to the **Qubitro Portal**.
2. Select a project from the list.
3. Click **New Source**.
4. Select **1NCE** from the available sources.

This page will display your `PROJECT ID` and `WEBHOOK SIGNING KEY` for the 1NCE configuration. Keep it open for the next step.
{% endstep %}

{% step %}
**Set Up 1NCE Cloud Integrator**

1. Log in to your **1NCE Portal**.
2. Click **1NCE OS** from the top menu and select **Cloud Integrator** from the left navigation menu.
3. Click the **+ New Integration** button and choose **Webhook**.
4. Enter the following configuration details:

<table><thead><tr><th width="154.44140625">Configuration</th><th>Value</th></tr></thead><tbody><tr><td>Endpoint URL</td><td><code>https://webhook.qubitro.com/integrations/1nce</code></td></tr><tr><td>Event Type</td><td>Select <strong>Telemetry Data</strong></td></tr></tbody></table>

Enter these HTTP Headers:

| Header Name         | Header Value                   |
| ------------------- | ------------------------------ |
| `projectId`         | *(copied from Qubitro Portal)* |
| `webhookSigningKey` | *(copied from Qubitro Portal)* |

5. Click **Proceed** to complete the configuration.
   {% endstep %}

{% step %}
**Verify Integration**

1. Return to the **Qubitro Portal**.
2. Click **Go to project**.
3. Click **Refresh** and verify that your 1NCE-connected devices appear.
4. Select a device and navigate to the **Data** tab to confirm incoming telemetry data.
   {% endstep %}
   {% endstepper %}

### FAQs

<details>

<summary>Do I need additional forwarding setup like MQTT or HTTP?</summary>

No. The integration works directly via 1NCE Cloud Integrator using webhooks. No additional forwarding setup is required.

</details>

<details>

<summary>Can I integrate multiple 1NCE accounts into different Qubitro projects?</summary>

Yes. You can create multiple integrations to manage devices across different Qubitro projects.

</details>

<details>

<summary>Are there extra fees associated with this integration?</summary>

No. There are no hidden costs or additional data transfer (egress) fees associated with the Qubitro <-> 1NCE integration.

</details>