Contact Sales
Demo Buy now
Home / Integration plugins / Observium SMS Integration

+

Send SMS alerts from Observium

Observium alerts reach the person on duty as an SMS. SMSEagle sends them over its own cellular connection, so they don’t depend on internet access or a cloud service.

Consultation
Configuration

No plugin to install

Observium sends SMS through its standard Webhook JSON contact, so you only paste the SMSEagle address with the API token.

Alerts to a person or a group

Instead of a phone number, you can enter a contact or group from the SMSEagle phonebook, so the alert reaches the whole team.

Works without internet

SMSEagle sends alerts through its own SIM card straight to the mobile network, so they don’t depend on internet access or a cloud SMS provider.

How it works

1

Event Trigger

An Observium alert checker matches a monitored condition on a device or metric.

2

Communication

Observium’s Webhook JSON contact sends a JSON-RPC request to the SMSEagle API over your local network.

3

Alert

SMSEagle delivers the alert over its own cellular connection, not through a third-party service, as an SMS to the recipient’s phone.

Set up in about 10 minutes

Create a user with API access in SMSEagle, add a Webhook JSON contact in Observium, and you’re done.

See setup steps

SMSEagle sends Observium alerts to the right person by SMS, day and night.

No per-message fees

SMSEagle sends SMS through a regular SIM card, so you only pay for your mobile plan.

Alerts keep going if one carrier fails

On devices with two SIM cards from different operators, SMSEagle switches to the second one when the first operator’s network is down.

Alerts keep working even if one device fails

Two SMSEagle devices can work as an HA cluster: if one fails, the other takes over sending.

SMSEagle configuration

Observium uses HTTP API requests (see details: API). All you have to do at SMSEagle is to create a new user for API access at the webGUI and setup API token for it.

  • Create a new user in SMSEagle (menu System > Users, user access level: “User”).
  • Grant API access to the created user:
    • go to Settings > Global settings > API and open the API v1 page
    • click Create API key, fill in Key name and select the user created above as Owner
    • Add access permissions in section Permissions for: Send SMS, Send to contact, Send to group
    • click Create key. The access token is shown only once, right after saving

Observium configuration

The configuration related to SMS Gateway settings is done from the Contacts menu.

Add new contact and select Webhook JSON as transport type. In the description field you can type e.g SMSEagle and in the URL field paste our API request:
https://SMSEagle_IP/jsonrpc/sms
where SMSEagle_IP is your gateway’s IP address.

In the JSON passed to Webhook field please paste code:
{
"method": "sms.send_sms",
"params": {
"access_token": "your-created-token",
"to": "123456789",
"message": "%ALERT_STATE%, %ALERT_EMOJI%, %ALERT_EMOJI_NAME%,
%ALERT_STATUS%, %ALERT_SEVERITY%, #%ALERT_COLOR%, %ALERT_URL%,
%ALERT_UNIXTIME%, %ALERT_TIMESTAMP%, %ALERT_TIMESTAMP_RFC2822%,
%ALERT_TIMESTAMP_RFC3339%, %ALERT_ID%, %ALERT_MESSAGE%, %CONDITIONS%,
%METRICS%, %DURATION%, %ENTITY_URL%, %ENTITY_LINK%, %ENTITY_NAME%,
%ENTITY_ID%, %ENTITY_TYPE%, %ENTITY_DESCRIPTION%, %DEVICE_HOSTNAME%,
%DEVICE_SYSNAME%, %DEVICE_DESCRIPTION%, %DEVICE_ID%, %DEVICE_URL%,
%DEVICE_LINK%, %DEVICE_HARDWARE%, %DEVICE_OS%, %DEVICE_TYPE%,
%DEVICE_LOCATION%, %DEVICE_UPTIME%, %DEVICE_REBOOTED%, %TITLE%"
}
}

replace your-created-token with the API token for SMSEagle user you just created
replace 123456789 with phone number which you want to send SMS texts to.

You can also use contactname/groupname from SMSEagle’s Phonebook.

Important note:

  • Above code uses all Observium available placeholders, feel free to remove unnecessary ones.
  • Remember to associate Alert Checkers to newly created Contacts

Explore SMSEagle Demo device

SMSEagle is a hardware & software solution that guarantees a swift delivery of your messages to designated recipients, whether it’s for notifications, alerts, or important updates.

After registering to a demo you get a remote access to our physical device NXS-9750.

  • 14-days free trial
  • Access to over 20 functionalities
Start 14-days trial

What is hardware
SMS Gateway?

Learn more

Learn more about
SMSEagle features

Explore all features