ILLiad Twilio SMS Server Addon

This is a Server Addon and is installed in the ILLiad Customization Manager. See Configuring the Twilio Addon for instructions on implementing this service.

NameTwilio SMS Notifications
Version1.1.1
AuthorAtlas Systems, Inc.
DescriptionThe Twilio SMS Notifications addon is a server addon that will use the Twilio API for sending SMS notifications.

Download

Release Notes

Release notes are available for ILLiad Twilio SMS Server Addon v1.1.1 and later. 

  • v1.1.1:
    • Fixed an issue where the addon would fail to correctly log error codes when receiving error responses from the Twilio API.

Settings

*This addon is only compatible with ILLiad version 8.6 and higher.

AccountSIDThe Twilio Account SID provided in your Twilio account settings.
AuthTokenThe Twilio AuthToken provided in your Twilio account Settings.
FromNumberA Twilio phone number enabled for the type of message you wish to send. Only phone numbers or short codes purchased from Twilio work here.
ActiveNVTGCIf shared server, a comma separated list of NVTGC's that use this addon for sending SMS notifications. This setting is ignored for single server instances.

Sending Notifications

The Twilio SMS notifications addon will handle pending SMS notifications for the ActiveNVTGC's listed in the addon settings. The Twilio AccountSID, AuthToken, and FromNumber must be provided in the addon settings for the Twilio SMS Notifications addon to function properly. When a message is sent via the addon to Twilio it is typically queued for a short time before it is processed by the SMS carrier. At this time, the SMS notification will remain in the Sending status since it has been marked as being queued by Twilio. When an item is marked as queued the Twilio unique message identifier is added as the note in the SMS Copies table.

Some errors that are reported by Twilio will cause the addon to attempt to re-send the message. Specifically, Twilio error codes 21611, 30001, and 14107 will all attempt to retry sending the message the next time pending notifications are handled by the addon. System Manager will typically allow a notification to be retried up to 5 times before it will ultimately fail.

  • Error 21611: This 'From' number has exceeded the maximum number of queued messages
  • Error 30001: Message Delivery - Queue overflow
  • Error 14107: Message rate limit exceeded

Checking Queued Notifications

Since Twilio will not immediately send the SMS notification, the addon will check the status for notifications that have been queued by Twilio. The unique identifier is retrieved using the note from the SMS Copies table. During each check of sending notifications (every 2 minutes), the addon will check with Twilio to determine the status of the notification.

The ILLiad System Manager will update Sending notifications to a status of Failed if it remains at Sending for more than 24 hours past the date the notification was originally generated.