Twillio Accounts Settings
The following table describes the settings on the Twilio Accounts page.
|Name||Name for the Twilio Account.|
|Twilio Account Sid||Twilio account Sid: retrieve from the Account Settings menu in Twilio. (Required.)|
|Twilio Auth Token||Twilio auth token: retrieve from the Account Settings menu in Twilio. (Required.)|
|Public Hostname||The publicly reachable hostname or IP address that is configured to forward inbound requests to this Ignition gateway. This must be configured in order to receive inbound SMS. Leave blank if inbound SMS are not needed.|
|Public Port||The port on the Public Hostname to make the connection to. Default is 80.|
|Backup Public Hostname||The publicly reachable hostname or IP address that is used when the backup of a redundant pair becomes active.|
|Backup Public Port||The port on the Public Hostname to make the connection to that is used when the backup of a redundant pair becomes active. Default is 80.|
|HTTPS Enabled||True if the callback URL should use HTTPS instead of HTTP. Default is false.|
|Inbound Validation Enabled||Cryptographically validate that inbound requests over HTTPS are from Twilio. Default is false.|
Create a Twilio SMS Notification Profile
- Go to the Config section of the Gateway Webpage.
- Scrolll down and select Alarming > Notification from the menu on the left side.
- Click on the Create new Alarm Notification Profile link.
- Select the Twilio SMS Notification profile type, and click Next.
- Provide a name for the profile, and select a Twilio Account from the dropdown.
- Set the other profile settings as desired. (See table below for a description of all settings.)
- Click Create New Alarm Notification Profile.
Twilio SMS Notification Profile Settings
The following table describes the settings on the Alarm Notification Profiles page for a Twilio SMS Notification profile.
|Name||Name for this alarm notification profile.|
|Description||Description of the profile.|
|Enabled||Whether the profile is enabled or disabled.|
|Twilio Account||Select a Twilio account from the dropdown list.|
|Acknowledgement Allowed||Enables users to respond to notifications directly from the SMS message; also known as Two-Way notification. If enabled, the Public Hostname property in the Twilio Account must be configured.|
|Auditing Profile||Select an audit profile from the dropdown list.|
Once your Notification profile is created, you can use it in an Alarm Pipeline.
Receiving Alarm Acknowledgement via Twilio
If you're using 2-way alarming, when a user acknowledges an alarm, Twilio's servers send the acknowledgement to your Ignition Gateway. This means your Ignition Gateway needs to be accessible from Twilio's servers. If you're running Ignition on the cloud, this is likely already the case. If Ignition is on-premise, you may need to explore one of the following options:
- Make use of port forwarding
- Put an Ignition alarming server in the cloud with a Gateway Network connection to your on-premise server.
Because there are often security implications of port forwarding, and a cost associated with adding an Ignition server in the cloud, often the SMS Notification module is chosen over the Twilio module for users running Ignition on-premise.