> For the complete documentation index, see [llms.txt](https://help.boomerang3.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.boomerang3.com/b3-sms-device-installation-manual/product-overview.md).

# Product overview

The B3 SMS device sends Boomerang 3 alarm SMS messages through a local GSM router.

Use it when you need local SMS delivery instead of A2P services such as Infobip or MessageBird. This can reduce SMS cost and avoid delivery issues in some countries.

### Requirements

The B3 SMS device is usually assigned to one customer.

The customer must provide:

* a local SIM card
* an active mobile plan that supports outgoing SMS
* enough balance or credit to avoid blocked messages

The customer is responsible for all carrier costs.

### Supported routers

This manual covers these Teltonika routers:

* **RUT951**
* **RUT955**

### How message delivery works

`APIUniqueID` identifies the B3 SMS device that should collect a queued SMS request.

{% stepper %}
{% step %}

### Alarm group sends a webhook

Create a webhook in a B3 alarm group.

When an alarm is triggered, B3 sends the alarm data to the SMS backend server. Multiple alarm groups can send messages to the same B3 SMS device.
{% endstep %}

{% step %}

### SMS backend creates queue entries

The backend stores the incoming request in the SMS database.

Each request includes the target `APIUniqueID`. If the same SMS must be sent to multiple recipients, the backend creates one queue entry per recipient.
{% endstep %}

{% step %}

### Router polls for new messages

Each B3 SMS device runs a script that checks the SMS server every 60 seconds.

The request includes the device `APIUniqueID`. If a pending queue entry exists for that ID, the SMS server returns the recipient number and SMS text.
{% endstep %}

{% step %}

### Device sends the SMS

The router sends the SMS through the local mobile network.

After a successful send, the router confirms delivery to the backend server. The queue entry is then marked as handled.
{% endstep %}
{% endstepper %}

### Example deployment

This example shows three B3 SMS devices in different countries. Their `APIUniqueID` values are `saudib3`, `vietnamb3`, and `renbiob3`.

![Example deployment of three B3 SMS devices in different countries](https://2605103602-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsp4j9Tn2xGb8D5438KRm%2Fuploads%2FmYtguhdIV7XmPxb1Qi1c%2Fimage.png?alt=media\&token=4e76386c-8d24-483a-8b09-18f9702d3e57)

*Example deployment with three B3 SMS devices, each mapped to a different `APIUniqueID`.*

### Next step

Continue with [Pre-installation instructions](https://help.boomerang3.com/b3-sms-device-installation-manual/pre-installation-instructions.md) or review [Required tools and materials](https://help.boomerang3.com/b3-sms-device-installation-manual/pre-installation-instructions/required-tools-and-materials.md).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.boomerang3.com/b3-sms-device-installation-manual/product-overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
