SNAG-View SMS Integration manual

Here we describe how to use SMSEagle Hardware SMS Gateway with SNAG-View for sending SMS notifications & alarms. Setup is easy and should take 5-10min to complete.

SMSEagle is an offline hardware SMS gateway. Therefore no external connection to 3rd party system is required. All notifications are generated on-premise and sent directly to a cellular network. This solution can be used in secure installations without Internet access.

SMSEagle Setup

Access/Login

The modem is configured via the web browser, the default user name and password are „admin“ and „password“.

1. Setting up a service user

  • Open user menu
    (on the left hand side)

2. Click on „Add Users“

3. Create user „smsapi“ with the following parameters:

  • Name
  • Phone number
  • Username
  • Password
  • Level
  • MFA
  • Limit Modems

4. The Generated API token will be needed for SNAG-View later

5. Select access. We recommend the following rights:

Messages:

  • Read messages
  • Send SMS
  • Send MMS
  • Send binary message
  • Send USSD message
  • Count message

Modem:

  • Make a call
  • Get modem status
  • Get modem signal strength

6. Callback URL Setup

With the callback URL an incoming SMS is forwarded to SNAG-View

The following parameters are entered in the callback configuration:

  • Rule Name
  • URL (SNAG-View Server)
  • URL method
  • Content type
  • When message contains
  • Allow self-signed SSL certificate
  • Limit Modems

Example

  • Rule Name = testAcknowledge
  • URL = http://192.168.19.110:8080/rest/v1/smseagle/acknowledge
  • URL Method = POST
  • Content type = JSON
  • When messages contains = !SV4.ACK
  • Allow self-signed SSL certificate = yes
  • Limit Modems = no

7. SNAG-View Setup

smseagle:

host: “192.168.16.84” tls: true
apiKey: “NWwVvdttODTdqREOOHCkIxJhQVhCO6Ff”

Modem configuration
A new execution is created in SNAG view. There are two operating modes, for
When calling contacts, the Ring or TTS mode can be selected.
– Ring is a simple call, only ringing
– In TTS mode, the message is read out.

Example
Type: SMSEagle
Name: SMS
IGNORE INSECURE CERTIFICATE: True
NOTIFICATION TYPE:

  • Send message
  • Call phone

Message:

$ACTION.TYPE$: $DEVICE.NAME$ / $SENSOR.NAME$
is $SENSOR.STATE$

Flash Message: False

After that, the rule is stored in the SNAG-View

Have Questions?

SMSEagle devices are designed for easy setup. If you don't have a device yet, just buy your SMSEagle and get started with your integration. If you need technical assistance or have questions about our products, we’ll be happy to help you.