Zabbix SMS alerts – integration manual

Here we describe how to use SMSEagle for Zabbix SMS alerts. The configuration is very straightforward – it should take you about 5 min to have it up and running.

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

• Create a new user in SMSEagle (menu Users > + Add Users, user access level: “User”).
• Grant API access to the created user:
  • click Access to API beside the newly created user
  • Enable APIv1
  • Generate new token (copy it for later use)
    
  • Add access permissions in section APIv1 Permission for: send_sms, send_tocontact, send_togroup
    
  • Save settings

Zabbix Setup

1. Download latest version of Zabbix script media_smseagle.yaml from our repository: https://bitbucket.org/proximus/smseagle-zabbix-v2/

1. In the Administration > Media types section, import the media_smseagle.yaml file.

2. Open the newly added SMSEagle media type and replace all <PLACEHOLDERS> with your values.
The following parameters are required:
access_token – API access token created in SMSEagle
url – actual URL of your SMSEagle device (for example: http://10.10.0.100 or https://sms.mycompany.com)

3. in the Administration > Users click on a User, and add a new media called SMSEagle. Enter SMS recipient. Available recipient formats:
Phone number: phone_number
Contact in SMSEagle Phonebook: contact_name:c
Group in SMSEagle Phonebook: group_name:g

That’s it!

Zabbix Template (Optional)

If you would like to add a ready-to-use Zabbix template for monitoring your SMSEagle device in Zabbix:

1. Download the yaml template file from the repository: https://bitbucket.org/proximus/smseagle-zabbix/downloads/
2. Import the template file to Zabbix:  menu Configuration > Templates > Import.
3. Assign the template to your device in Zabbix.