Working with contacts in Incident Manager
AWS Systems Manager Incident Manager contacts are responders to incidents. A contact can have multiple channels that Incident Manager can engage during an incident. You can define a contact's engagement plan to describe how and when Incident Manager engages the contact.
Contact channels
Contact channels are the various methods Incident Manager uses to engage a contact.
Incident Manager supports the following contact channels:
-
Email
-
Short Message Service (SMS)
-
Voice
Contact channel activation
To protect your privacy and security, Incident Manager sends a device activation code to you when you create contacts. To engage your devices during an incident, you must first activate them. To do so, enter the device activation code on the create contact page.
Certain features of Incident Manager include functionality that send notifications to a contact channel. By using these features, you consent to this service sending notifications about service disruptions or other events to the contact channels included in the specified workflow. This includes notifications sent to a contact as part of an on-call schedule rotation. Notifications may be sent by email, SMS message, or voice call as specified in a contact's details. You confirm by using these features that you're authorized to add the contact channels you provide to Incident Manager.
Opting out
You can cancel these notifications at any time by removing a mobile device as a contact channel. Individual notification recipients may also cancel notifications at any time by removing the device from their contact.
To remove a contact channel from a contact
-
Navigate to the Incident Manager console
and choose Contacts from the left navigation. -
Select the contact with the contact channel that you are removing and choose Edit.
-
Choose Remove next to the contact channel that you would like to remove.
-
Choose Update.
Contact channel deactivation
To deactivate a device, reply UNSUBSCRIBE. Replying UNSUBSCRIBE stops Incident Manager from engaging your device.
Contact channel reactivation
-
Reply START to the message from Incident Manager.
-
Navigate to the Incident Manager console
and choose Contacts from the left navigation. -
Select the contact with the contact channel that you are removing and choose Edit.
-
Choose Activate devices.
-
Enter the Activation code sent to the device by Incident Manager.
-
Choose Activate.
Engagement plans
Engagement plans define when Incident Manager engages the contact channels. You can engage contact channels multiple times at different stages from the start of an engagement. You can use engagement plans in an escalation plan or response plan. To learn more about escalation plans, see Working with escalation plans in Incident Manager.
Create a contact
To create a contact, use the following steps.
-
Open the Incident Manager console
and choose Contacts from the left navigation. -
Choose Create contact.
-
Type the full name of the contact and provide a unique and identifiable alias.
-
Define a Contact channel. We recommend having two or more different types of contact channels.
-
Choose the type: email, SMS, or voice.
-
Enter an identifiable name for the contact channel.
-
Provide the contact channel details, such as email: arosalez@example.com
-
-
To define more than one contact channel, choose Add contact channel. Repeat step 4 for each new contact channel added.
-
Define an engagement plan.
Important
To engage a contact, you must define an engagement plan.
-
Choose a Contact channel name.
-
Define how many minutes from the start of the engagement to wait until Incident Manager engages this contact channel.
-
To add another contact channel, choose Add engagement.
-
-
After defining your engagement plan, choose Create. Incident Manager sends an activation code to each of the defined contact channels.
-
(Optional) To activate the contact channels, enter the activation code that Incident Manager sent to each defined contact channel.
-
(Optional) To send a new activation code, choose Send new code.
-
Choose Finish.
After you define a contact and activate its contact channels, you can add contacts to escalation plans to form a chain of escalation. To learn more about escalation plans, see Working with escalation plans in Incident Manager. You can add contacts to a response plan for direct engagement. To learn more about creating response plans, see Working with response plans in Incident Manager.
Import contact details to your address book
When an incident is created, Incident Manager can notify responders by using voice or SMS
notifications. To ensure that responders see that the call or SMS notification is from
Incident Manager, we recommend that all responders download the Incident Manager virtual card format (.vcf)
To download the Incident Manager .vcf file
-
On your mobile device, either choose or enter the following URL: https://d26vhuvd5b89k2.cloudfront.net/aws-incident-manager.vcf
. -
Save or import the file to the address book on your mobile device.
