# Soracom

### Overview

The Qubitro and Soracom integration enables you to sync all devices and their data from Soracom directly to Qubitro using Soracom Beam—without writing any code.

Once your hardware is configured and sending data through Soracom, Qubitro automatically creates a corresponding device representing each SIM, along with its unique SIM information.

Incoming data is automatically decoded by Qubitro, and additional transformation functions can be applied if data modifications are required before storage.

This integration works seamlessly with eSIM, physical SIM, and soft SIM.

### Prerequisites

* [x] Soracom account with active SIMs sending data
* [x] Qubitro account with an existing project
* [x] Administrative access to both Qubitro and Sor

### How It Works

Below is the diagram that shows how the integration works.

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

B -- No --> C\[Qubitro Creates Device with SIM ID];
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;" %}

{% hint style="warning" %}
If a [Transformation Function](https://docs.qubitro.com/platform/functions/transformation-function) is enabled, data will be processed before storage. The 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 **Soracom** from the available sources.

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

{% step %}
**Set Up Soracom Beam**

1. Log in to your **Soracom** account.
2. Navigate to **Groups** and select the desired group to integrate with Qubitro.
3. Click the **Advanced settings** tab, and expand **SORACOM Beam**.
4. Click **Add Configuration** and choose the **TCP → HTTP/HTTPS entry point**.

Enter the following configuration details copied from the Qubitro Portal:

<table><thead><tr><th>Protocol</th><th width="223.48828125">Host Name</th><th>Port Number</th><th>Path</th></tr></thead><tbody><tr><td>HTTPS</td><td><code>webhook.qubitro.com</code></td><td><code>443</code></td><td><code>/integrations/soracom</code></td></tr></tbody></table>

Enable the following settings:

{% hint style="danger" %}
**SIM ID header**: Toggle ON to append SIM identification.
{% endhint %}

Add the following under **Custom Headers**:

| Action | HEADER NAME         | HEADER VALUE                   |
| ------ | ------------------- | ------------------------------ |
| Append | `projectId`         | *(copied from Qubitro Portal)* |
| Append | `webhookSigningKey` | *(copied from Qubitro Portal)* |

5. Click **Save** to apply the configuration.
   {% endstep %}

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

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

### FAQs

<details>

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

No. Soracom Beam automatically forwards data securely and directly to Qubitro. No additional forwarding setup is needed.

</details>

<details>

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

No. Once data is sent to Soracom, it is automatically forwarded to Qubitro via Soracom Beam.

</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 <-> Soracom integration.

</details>