This guide describes how to integrate your Zabbix installation with SMSEagle hardware SMS gateway using the Zabbix webhook feature. This guide will provide instructions on setting up a media type, a user and an action in Zabbix.
1. Create a new user in SMSEagle (menu Users > + Add Users, user access level: “User”).
2. Grant API access to the created user:
- Click Access to API beside the newly created user.
- Enable APIv2
- Generate new token
- For text messages, add access permissions in section Messages for: Send SMS, Send MMS.
- For voice alerting, add access permissions in section Calls for: Make a ring call, Make a TTS call, Make a TTS Advanced call.
- Save settings.
The configuration consists of a media type in Zabbix, which will invoke the webhook to send alerts to SMSEagle device through the Rest API.
1. In the Administration > Media types section, import the media_smseagle.yaml.
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)
type - type(s) of message(s) to send. Possible values: sms, mms, tts and tts_adv, respectively for SMS, MMS, TTS Call and Advanced TTS Call.
Allows multiple types, separated by commas (e.g. "sms,tts_adv").
Other required parameters are message type specific. More information can be found on our APIv2 page.
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
Multiple recipients can be separated by comma.
For more information, please see Zabbix and SMSEagle documentation.
Zabbix 6.2+