• Products
  • Get started
  • Documentation
  • Resources

Set up SMS and voice notifications

This article highlights a new alerting feature that's natively available in Jira Service Management which is gradually rolling out to some Jira Service Management Cloud customers. It may not yet be visible or available on your site.

We use trusted third-party services like Twilio and Nexmo to deliver your SMS and voice alert notifications, tailored to specific geographical regions. Based on the notification rules you set up, we include the status of notifications sent within the alert workflow and track it in the alert activity logs. Admins can also refer to audit logs for further details.

Voice notifications

Jira Service Management can send notifications via phone calls. Add a voice contact method and a notification rule in alert notification settings, and activate it. The voice notification contains the alert message and possible actions to run on the alert. Voice notifications are limited to a maximum of two minutes.

Work with voice notifications

When you pick up the call from Jira, it first reads the notification message. This could be the message of a new alert, or an action on an existing alert, like acknowledged or note added, etc. It then presents a set of actions you can take right from the dial pad on your phone:

  • Press 1 to hear the description of the alert.

  • Press 2 to close the alert.

  • Press 3 to acknowledge the alert (if the alert is not already acknowledged).

  • Press 4 to escalate the alert to the next recipients, if there is at least one escalation for the alert. If there is only one active escalation at the moment, it directly escalates to the next recipients. If there are multiple escalations at a given point, it reads out the names of active escalations and prompts you to select one.

  • Press 5 to hear the list of custom actions you can run over the phone.

  • Press 6 to start acknowledging all the actions for your alerts.

  • Press 7 to take ownership of the alert only if it's acknowledged by someone else.

  • Press star to replay the options.

  • Press 0 to end the call.

Aggregated voice notifications

Jira Service Management aggregates voice notifications and makes phone calls to the given number at 4-minute intervals. Events occurring in between are aggregated for the next voice notification. While doing so, acknowledged and closed alerts during the aggregation interval are excluded from the notification. If all of the aggregated alerts are either closed or acknowledged, Jira Service Management skips the voice call.

Only “Acknowledge all” action is available for such notifications. When you press 3 to “Acknowledge all”, Jira Service Management runs it only for aggregated alerts. It doesn’t process any previously open/unacknowledged alerts that existed before the aggregation timer started. It might be a good idea to use email or mobile push notifications if you want to be instantly notified, since the aggregated voice notifications operate on a time interval, typically around every 4 minutes.

On-call schedule notifications

You can receive notifications at the start and end of your on-call schedules via phone. Jira Service Management calls and notifies you near the start/end of your on-call schedule; you can configure this to be "Just before", or "1 hour" etc. before your on-call rotation begins/ends. Set up schedule notifications in the notification rules section.

SMS notifications

Jira Service Management can send notifications via SMS. Add an SMS contact method and a notification rule in alert notification settings, and activate it. The SMS includes the alert message and a short URL pointing to the alert itself (opens up the web browser and displays the alert details). You can view alert details and run any action on the alert.

Jira Service Management aggregates SMS notifications* and sends SMS in 1-minute intervals. Events occurring in between the intervals of 1 minute are aggregated for the next SMS/Voice notification.
* In some countries such as Taiwan and China, SMS notifications don't include alert URLs due to government regulations.

Acknowledge and close alerts

You can acknowledge and close the alerts by replying to the SMS. The short URL that is included in the SMS notification has the data necessary to identify the alert you’re responding to.

For example, if the SMS has the following short URL - https://mytestsite.in/alert/3456 - 4421 is the identifier (alert tiny ID).

Examples

To acknowledge an alert, reply via SMS with the following text:

1 ack 4421

or

1 ack alert 4421

To close the alert, reply with the following text:

1 close 4421

or

1 close alert 4421

When Jira Service Management receives the reply you sent, appropriate action is run and the outcome is sent back to you in SMS:

1 "Successfully acknowledged http://mytestsite.in/i/4421

Contact information

There’s only a single vCard regardless of which region your account is set up. Download the vCard.

SMS - All countries

Shortcode for US: 576677

Jira Service Management uses the following US phone numbers to send notifications to users in all countries, except China:

+1 (254) 540-8400

+1 (254) 540-8401

+1 (254) 540-8402

+1 (254) 540-8403

+1 (205) 875-0031

+1 (205) 875-0032

+1 (205) 875-0033

+1 (205) 875-0034

+1 (205) 875-6801

+1 (205) 875-6802

SMS - China

8605

SMS in some countries are sent from our sender ID (JSM) too, instead of from a phone number.

SMS usage guidelines

Following are a few guidelines from providers such as Twilio and Nexmo to maintain the delivery of your SMS notifications:

  • You can cancel the SMS service at any time. To do this, text "STOP" to the SMS shortcode provided. We'll then email you to confirm your cancellation. If you'd like to receive our SMS again in the future, sign up as you did before.

  • If you're having trouble with the SMS service, reply with "HELP" to get more assistance, or you can contact us.

  • Mobile carriers aren't responsible for any delayed or undelivered messages. Also, message and data rates might apply to any messages sent from us to you and vice versa. The frequency of the messages you'll receive is based on the frequency of the alerts in Jira Service Management. For any questions about your SMS or data plans in general, contact your mobile service provider.

  • For any privacy-related questions, read our privacy policy.

Voice - All countries

+1 (254) 540-8400

+1 (254) 540-8401

+1 (254) 540-8402

+1 (254) 540-8403

+1 (205) 875-0031

+1 (205) 875-0032

+1 (205) 875-0033

+1 (205) 875-0034

+1 (205) 875-6801

+1 (205) 875-6802

Voice - China

+86 (10) 8639-1403

+86 (10) 5225-3349

+86 (10) 5225-3354

Still need help?

The Atlassian Community is here for you.