Configuration
Alarm Notification Profile
After installing the module, create an Alarm Notification Profile of type Teltonika Notification.
Profile Settings
Gateway
| Parameter | Type | Required | Description |
|---|---|---|---|
| Name | Text | Yes | Name of the Alarm Notification Profile instance |
| Description | Text | No | Description of the Alarm Notification Profile instance |
| Enabled | Boolean | Yes | Enable/Disable the Alarm Notification Profile |
| Host | Text | Yes | IP address or hostname of the Teltonika router |
Credentials
| Parameter | Type | Required | Description |
|---|---|---|---|
| Username | Text | Yes | Router authentication username |
| Password | Password | Yes | Router authentication password |
Advanced
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| Legacy | Boolean | Yes | false | Use Legacy API instead of REST API |
| Modem | Text | Conditional | - | Modem identifier (required when Legacy is false) |
Auditing
| Parameter | Type | Required | Description |
|---|---|---|---|
| Audit Profile | Dropdown | No | Optional audit profile for logging notifications |
API Modes
The module supports two API modes to accommodate different Teltonika firmware versions.
REST API Mode (Default)
Modern Teltonika routers use a token-based REST API.
Requirements:
- Firmware with REST API support
- Modem field must be configured
Authentication flow:
- Module sends credentials to
/api/login - Receives authentication token (valid ~5 minutes)
- Token is cached and reused
- SMS sent via
/api/messages/actions/send
Legacy API Mode
Older Teltonika firmware uses URL-based authentication.
To enable:
- Set Legacy to
true - Modem field is not required
Authentication:
- Credentials passed as URL parameters
- SMS sent via
/cgi-bin/sms_send
Try REST API mode first. If you receive authentication errors, switch to Legacy mode.
User Contact Configuration
For users to receive Teltonika SMS notifications, their contact information must include phone numbers in the SMS contact type.
Adding Contact Information
- Navigate to Config > Security > Users, Roles
- Edit the user
- In the Contact Info section, add a contact of type SMS
- Enter the phone number in international format (e.g.,
+33612345678)
Phone numbers should include the country code. The module automatically converts international format (+33...) to the format required by Teltonika routers (0033...).
Per-Alarm Custom Message
The module supports per-alarm custom messages via the Extended Configuration of each alarm.
To configure a custom message for a specific alarm:
- Open the alarm configuration in the Designer
- Expand the Extended Config section
- Find the Teltonika Notification Properties category
- Set the Custom Message property
When a custom message is defined, it overrides the notification block's message template for that specific alarm.
Auditing Configuration
When an audit profile is configured, the module logs:
| Field | Description |
|---|---|
| Action | "Teltonika SMS" |
| Actor | Username of the notification recipient |
| Target | Alarm path with event ID |
| Value | "SUCCESS" or "FAILURE" |
| Timestamp | Time of notification attempt |
Multi-Modem Configuration
For routers with multiple SIM cards, specify which modem to use:
- Find the modem identifier in your router's web interface
- Enter it in the Modem field (e.g.,
modem1,3-1)
Each notification profile can use a different modem, allowing you to:
- Route critical alarms through a dedicated SIM
- Balance load across multiple SIMs
- Use different carriers for redundancy