Set up SMS and voice notifications

Owned by Shivi Sivasubramanian
Last updated: Feb 02, 2024
4 min read

Voice notifications

Jira Service Management can send notifications via phone calls. Add a voice contact method and a notification rule on the Alert notifications page, 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.

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 on the Alert notifications page, 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.

* Due to new Singapore government regulations, SMS isn’t supported for Singapore phone numbers.
* 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).

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

ack 4421

or

ack alert 4421

To close the alert, reply with the following text:

close 4421

or

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

Contact information

There are different vCards for both US and EU service regions. Please download the vCard that matches the location chosen for your account.

US region

Download US-vCard

You can download the vCard of Jira Service Management used in US region phone numbers from here

Phone numbers for US accounts

Jira Service Management uses the following phone numbers to send notifications for accounts based in the US region.

Voice
+1 (202) 851-8605
+1 (256) 568-608[0-1, 3-7]
+1 (866) 217-809[3-9]
+81 (503) 196-5262

Voice Australia
+61 (2) 6189-2548

Voice China
+86 (10) 8639 1403

SMS USA
43643
+1 (888) 570-6940
+1 (210) 961-9060
+1 (866) 217-809[3-9]
+1 (202) 350-2913
+1 (202) 816-6845
+1 (855) 836-669[0, 2-8]
+1 (202) 370-6450
+1 (888) 481-6002

SMS USA (backup numbers)
+1 (469) 250-9978
+1 (256) 568-606[3, 4, 8, 9]
+1 (256) 568-607[2-7, 9]
+1 (256) 568-608[0-1, 3-7]
+1 (256) 568-609[0-4, 8-9]
+1 (256) 568-610[0-4]
+1 (888) 480-7806
+1 (202) 851-8605

SMS Australia
+61 (448) 798-788

SMS Ireland
+353 (870) 604-146

SMS Netherlands
+31 (970) 102-40038

SMS Spain
+34 (911) 067-383

SMS Switzerland
+41 (766) 013-135

SMS France
+33 (644) 644-662
+33 (644) 639-939
+33 (644) 635-858
+33 (644) 635-878
+33 (644) 635-885
JIRA (sender ID)

SMS UK
+44 (752) 063-1070

SMS Portugal
+351 (927) 945-262

SMS Non-USA
+1 (703) 594-4111

EU region

Download EU-vCard

You can download the vCard of Jira Service Management used in EU region phone numbers from here.

Phone numbers for EU accounts

Jira Service Management uses the following phone numbers to send notifications for accounts based in the EU region.

Voice
+1 (202) 804-8867
+1 (202) 516-8562
+1 (210) 961-9060
+1 (210) 961-9080

Voice China
+86 (10) 8639 1403

SMS
+1 (202) 804-8867
+1 (202) 804-8286 
+1 (202) 516-8562
+1 (210) 961-9060
+1 (202) 350-2980
+1 (202) 804-8798
+1 (210) 961-9080
+1 (855) 805-6644