# Onomondo

### Overview

The Qubitro and Onomondo integration allows you to sync all devices and their data from Onomondo Cloud to Qubitro using Onomondo Cloud Connectors—without writing any code.

Once your hardware is configured and sending data to Onomondo, a corresponding device is automatically created in Qubitro, representing each SIM with its unique SIM information. 

Qubitro also decodes incoming data automatically, and transformation functions can be applied if modifications are needed before storage.

{% hint style="success" %}
The integration works seamlessly with eSIM, physical SIM, and soft SIM.
{% endhint %}

{% hint style="info" %}
This integration **does not require** manual MQTT or HTTP forwarding from Onomondo. Data flows directly between Onomondo and Qubitro with no additional setup required on the device side.
{% endhint %}

### Prerequisites

* [x] Administrative access to both accounts.
* [x] A Qubitro account with an existing project.
* [x] An Onomondo account with active SIMs sending data

### How It Works

Below is the diagram that shows how the integration works.

{% @mermaid/diagram content="graph LR;
A\[Device Publishes Data to Onomondo] --> B{Device Exists in Qubitro?};

B -- No --> C\[Qubitro Creates Device with SIM Information];
B -- Yes --> D\[Use Existing Device];

C --> E\[Apply Built-in Decoder];
D --> E;

E --> F\[Store Data in Qubitro];

%% Style Adjustments
style A fill:#d9d9d9,stroke:#000,color:#000;
style B fill:#f2f2f2,stroke:#000,color:#000;
style E fill:#e0e0e0,stroke:#000,color:#000;" fullWidth="false" %}

{% 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 **Onomondo** from the available sources.

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FQlrDtMNvHsnMUTD0LahD%2Fimage.png?alt=media&#x26;token=f1e4af1c-489e-407c-a314-6a8fdf42f4e8" alt=""><figcaption></figcaption></figure>

This page will display the **Host URL** required for Onomondo configuration. Keep it open for the next step.
{% endstep %}

{% step %}
**Set Up the Onomondo Cloud Connector**

1. Log in to **Onomondo Cloud**.
2. Click **More** in the top menu and select **Connectors**.<br>

   <figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FI3OKhOKKQ7IfDdR7DLHJ%2Fimage.png?alt=media&#x26;token=b25b7dd7-1034-4161-83e8-6df09d5229a3" alt="" width="563"><figcaption></figcaption></figure>
3. Click **New Connector** and choose **HTTPS** as the connector type.<br>

   <figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FvqmFFXFh0zfN20vgLWcl%2Fimage.png?alt=media&#x26;token=534562b5-0946-4ada-9eb7-d42e72e4f405" alt="" width="563"><figcaption></figcaption></figure>
4. Paste the **Host URL** copied from Qubitro.<br>

   <figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2Fx1wuziQpo5RGa6SqaESr%2Fimage.png?alt=media&#x26;token=bd60572a-0733-4623-a57a-1fb0eeb83c0c" alt="" width="563"><figcaption></figcaption></figure>
5. Click **Create Connector** to save the configuration.
   {% endstep %}

{% step %}
**Assign the Cloud Connector to a SIM**

1. Open the **SIM Detail Page** in Onomondo.
2. Click **Edit Mode** and select the newly created connector (e.g., `qubitro-integration`).<br>

   <figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2F0GeG3My3mzlvdjLMIRQO%2Fimage.png?alt=media&#x26;token=d16ce5dd-8a1c-4e3b-803b-97fcc305e823" alt="" width="563"><figcaption></figcaption></figure>
3. Click **Save** to apply the configuration.
   {% endstep %}

{% step %}
**Verify the Integration**

1. Return to **Qubitro Portal**.
2. Click **Go to Project** and then **Refresh** to check if the devices appear.<br>

   <figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FJJuP9GCigQNpjNvycW5N%2Fimage.png?alt=media&#x26;token=f96a38fc-4df4-4408-9b7a-6862d9292125" alt="" width="563"><figcaption></figcaption></figure>
3. Open a device and navigate to the **Storage** tab to verify incoming data.
   {% endstep %}
   {% endstepper %}

### FAQs

<details>

<summary>Do I need to set up MQTT or HTTP forwarding in Onomondo?</summary>

No. The integration works directly between Onomondo and Qubitro using Cloud Connectors. No additional forwarding setup is needed.

</details>

<details>

<summary>Do I need to send data from my device to Qubitro?</summary>

No. Once data is sent to Onomondo, it is automatically forwarded to Qubitro via the Cloud Connector.

</details>

<details>

<summary>Can I group SIMs under different Qubitro projects?</summary>

Yes. You can create multiple integrations to separate SIMs across different projects.

</details>

<details>

<summary>Are there additional fees for this integration?</summary>

No. There are no hidden costs such as data transfer (egress) fees for using the Qubitro <> Onomondo integration.

</details>