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“.
![SMSEagle-WebGUI-Login](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/SMSEagle-WebGUI-Login.jpg)
![SMSEagle-Users](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/SMSEagle-Users.jpg)
1. Setting up a service user
- Open user menu
(on the left hand side)
2. Click on „Add Users“
![SMSEagle---Users-SNAG](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/SMSEagle-Users-SNAG.jpg)
![SMSEagle-Users-add](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/SMSEagle-Users-add.jpg)
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
![SMSEagle-Api-add1](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/SMSEagle-Api-add1.jpg)
5. Select access. We recommend the following rights:
Messages:
- Read messages
- Send SMS
- Send MMS
- Send binary message
- Send USSD message
- Count message
![SMSEagle-Api-add2](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/SMSEagle-Api-add2.jpg)
Modem:
- Make a call
- Get modem status
- Get modem signal strength
![SMSEagle-Api-add3](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/SMSEagle-Api-add3.jpg)
![SMSEagle-CallbackURL](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/SMSEagle-CallbackURL.jpg)
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
![SMSEagle-CallbackURL2](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/SMSEagle-CallbackURL2.jpg)
![SMSEagle-Snag1](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/Snag1.jpg)
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
![SMSEagle-Snag2](https://www.smseagle.eu/wpsite/wp-content/uploads/2023/09/SMSEagle-Snag2.jpg)