The SMS transport is used for notifying users of JIRA events through SMS.
The current supported SMS gateway providers are:
For each provider the requirement parameters are different. Below is a table of the supported providers and the required parameters for successful configuration. More information on these parameters can be found in the respective providers documentation.
SMS Provider | Required Parameters | Documentation Reference |
---|---|---|
Twilio |
| https://www.twilio.com/docs/api/rest/sending-messages |
BulkSMS |
| http://developer.bulksms.com/eapi/submission/send_sms/ |
Nexmo |
| https://docs.nexmo.com/messaging/sms-api/api-reference |
Clockwork |
| https://www.clockworksms.com/doc/easy-stuff/http-interface/send-sms/ |
Each provider charge differently, please refer to their FAQ and pricing policies. |
In order to send SMS notifications from Issue and Post function events, you need to set up a SMS transport first. The transport is the connection that knows how to send SMS messages through a SMS provider.
To create a SMS transport:
Once you have the transport created, you can set SMS Notification Mappings to send SMS notifications from Issue Created/Updated/Deleted events or SMS Post Functions to send SMS notifications from transition events.
Like Email or HipChat Notification Mapping, SMS notification mapping is in charge of sending SMS messages from Issue events through the SMS Transport.
Creating an SMS Notification Mapping:
JEMHCloud allows you to send SMS notifications when Issue transitions are performed through JIRA Post Functions.
Adding the SMS Notification Post Function to workflow transition:
Both SMS notification mapping and SMS post function behavior can be changed at runtime with a Velocity Script. The script can use the event data or be time based to change how notifications are performed.
#if ($context.issue.fields.priority.name.textValue() != 'Critical') $smsNotificationUtils.resetToPhoneNumbers() ## Exclude the configured phone numbers in the mapping or post function** $smsNotificationUtils.addToPhoneNumber("+1234567") ## Sets the only phone number for critical issues. ** #end |
#if (!$dateTimeUtils.betweenHours("18:00", "06:00")) $smsNotificationUtils.inhibitNotification() ## SMSs are not sent during business hours ** #end |
#if ($context.issue.fields.priority.name.textValue() != 'Blocker') $smsNotificationUtils.inhibitNotification() #end |
Velocity Script cannot be validated at configuration time (for example the dynamic phone numbers). You should test the script by re-executing events in Auditing → Events |
Related articles appear here based on the labels you select. Click to edit the macro and add or change labels.
|