# SMS Gateway

# 📡 SMS Gateway

Sign in to access the dashboard

Username
Password

## Dashboard

Overview of your SMS gateway

Messages Sent
—
Messages Received
—
Failed
—
Recent Messages

| Phone | Message | Status | Time
--- | --- | --- | --- | ---

## Send SMS

Send a message directly from this dashboard

Recipient phone number
Message 0 / 160 characters (SMS segment 1)

## Received Messages

Incoming SMS messages from your device

From | Message | Received at
--- | --- | ---

## Sent Messages

Outgoing SMS messages

To | Message | Status | Sent at
--- | --- | --- | ---

## Webhooks

Receive alerts from external apps (uptime-kuma, etc.) and send SMS

How it works

Each webhook has a unique URL. Configure your external app to POST JSON to that URL and this gateway will send an SMS.

`POST /api/hooks/<token> — no auth required, the token is the secret`

The message template supports `{{key}}` placeholders resolved from the JSON body. For uptime-kuma the top-level `msg` field contains the full alert text.

Name | Send SMS to | Webhook URL | Status | Actions
--- | --- | --- | --- | ---

## API Tokens

Bearer tokens for external API access

API Usage

Use your token in the `Authorization` header:

Authorization: Bearer <your-token>
`POST /api/sms/send { "number": "+46…", "message": "…" }` `GET /api/sms/messages` `GET /api/sms/messages/received` `GET /api/sms/messages/sent`

Name | Token | Status | Created | Actions
--- | --- | --- | --- | ---

## Settings

Configure your Teltonika device connection

### Device Connection

Device IP address
Username
Password
Modem ID Modem identifier (e.g. 1-1, 3-1.4)
Poll interval (seconds)

### Logging

Log level
Also configurable via `LOG_LEVEL` env var at startup

### Change Password

Current password
New password
Confirm new password

### Add Webhook

Name
Send SMS to (phone number)
Message template Use `{{key}}` or `{{key.subkey}}` — resolved from the incoming JSON body. Default: `{{msg}}` (works for uptime-kuma).

### Create API Token

Token created — copy it now, it will not be shown again.
Token value
Token name