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/downloads/

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-v2/downloads/
  2. Import the template file to Zabbix:  menu Configuration > Templates > Import.
  3. Assign the template to your device in Zabbix.

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.