Email Integration Notifications / Email Integration

The Statusdashboard email integration allows your users or customers to subscribe to email alerts, which can be triggered automatically whenever creating or updating events on your status dashboard.  The email integration settings can be accessed by navigating to Notifications > Email and then selecting the Options menu in the upper right.

Activating the Email Integration

The Email integration may be enabled/disabled by navigating to Notifications > Email > Options > Enable/Disable and changing the Enable Event Email toggle button.  When this option is disabled, the option to broadcast email messages when creating or updating events will not be available but new email subscriptions will still be processed.  Additionally, if your account has reached the maximum number of allowed email messages for the current month, the broadcast email option will not be available when managing events.

Enabling Email Subscriptions

New email subscription requests may be enabled/disabled on the status dashboard by navigating to Notifications > Email > Options > Enable/Disable and changing the Enable Email Subscriptions toggle button.  When this option is disabled, the email subscription option will not be available on any dashboard subscription pages.  Additionally, if your account has reached the maximum number of confirmed email subscribers allowed, the email subscription option will not be available on any dashboard subscription pages.

Configuration Options

Option

Path

Description

Sender Name

Notifications > Email > Options > Email Sender

This is the friendly name that will appear in the from field in your customer's email client when they receive event email messages (for example: Acme Widgets)

Reply-To Email

Notifications > Email > Options > Email Sender

This is the email address that event messages will be sent from, and if your customers reply to email messages, they will be sent here.  If you would like to set a reply-to email address, we must first verify that you have all of the proper settings in place in your domain's DNS zone file. 

If you plan to use a custom reply-to email address when sending event emails, you must first setup SPF and DKIM records in the DNS zone that the reply-to email address resides in.  For help on setting up these records, please review our email provider's documentation.  Our support team is available to assist you in creating and testing these records to ensure they are properly setup - please contact us if you have any questions.

Email Instructions

Notifications > Email > Options > Instructions

If you would like to present your email subscribers with any special instructions or information about how you will use the email integration, enter them in the Email instructions field.  Instructions will be presented on all email subscription screens on your dashboard.

Email Footer Text

Notifications > Email > Options > Email Content > Email Footer

Any text entered here will be added to the footer of each email message.

Incident Greeting Text

Notifications > Email > Options > Email Content > Email Greeting Text

This text will appear above the event information that is broadcast in each event email.  This could be a generic greeting, or an explanation of why these messages are sent.  A suggested example is shown below:

Dear Acme company, the purpose of this message is to inform/update you about a service disruption that is impacting one or more production services.  We are actively working to resolve the issue and will notify you about any significant changes.  All current information about the incident is shown below:

Maintenance Greeting Text

Notifications > Email > Options > Email Content > Email Greeting Text

Similar to the Incident Greeting Text, this is a message that will accompany all maintenance event emails.  A suggested example is shown below:

Dear Acme company, the purpose of this message is to inform/update you about planned maintenance activities within our technical infrastructure.  All current information about the planned maintenance is shown below.  We will actively communicate any updates to these planned maintenance activities.

Default Email Subject

Notifications > Email > Options > Email Content > Default Email Subject

If a default email subject is included (either incident or maintenance), that subject will be included as the event email subject when you initially create an event. Whether or not you add a default email subject, you will still be able to customize the email subject whenever creating or updating an event.

If you do not create a custom email subject when creating or updating an event, then the default email subject format will be used:
Incident Alert|Maintenance Notification: #{Event ID}

Email Template

Notifications > Email > Options > Email Template

The event email formatting may be customized by selecting an email template, custom color scheme and organizational logo.  Once customized, all event emails sent from StatusDashboard will be appropriately formatted. If you would like to test your formatting settings before sending production event emails, save your email configuration settings and select the email test link to send a fully formatted sample event email.

Email Whitelist

Security > Email Domain Whitelist

If you would like to restrict email subscriptions to your dashboard to specific email domains, you have the option of setting up an email domain whitelist.


Managing Email Subscriptions

End Users

Subscribe:

Navigate to the dashboard, click the Subscribe button on the dashboard page and select the email icon.  Enter a valid email address and select one or more services to subscribe to. We'll send a confirmation email with a validation link which when clicked, will confirm the subscriptions. Once confirmed, the email address will be subscribed to event emails and will receive any relevant alerts that you broadcast when managing events.


Manage Subscriptions:

Navigate to the dashboard, click the Manage Subscriptions link in the footer, select the email icon and provide a valid email address. We'll send a validation email which will provide access to add and/or delete subscriptions to specific services on the dashboard.

StatusDashboard Administrators

Manual Subscribe

Navigate to Notifications > Email > Options > Subscriber Add.  Any email addresses added here will be immediately subscribed to the associated services.  Please be aware that these manually added email addresses can be unsubscribed from alerts through the standard StatusDashboard unsubscribe process by your end users.

Import Subscribers

Email subscribers can be imported from a Comma Separated Value (CSV) file by navigating to Notifications > Email > Options > Subscriber Import.  When importing email subscribers from a CSV file, all existing email subscriptions will be removed and replaced with the entries in the CSV file.  If you have existing email subscriptions and are interesting in importing additional subscriptions, it is best to first export your current subscriber list, add the additional entries to the export file, and then use this file to perform the import.  The CSV file must be in the following format and must be a UTF-8 encoded file if it contains non-ASCII characters:

Email Address,Service Name
test1@email.com,service1
test1@email.com,service2
test2@email.com,service1
test2@email.com,service2

Although when exporting the subscriber list there is an additional 'Confirmation Status' column present, this column is not required for the import, and is ignored if present.  All imported subscriber entries are automatically added with confirmation status set to True.

Manage Subscriptions

Navigate to Notifications > Email > Options > Subscriber List.  From here, you may search subscribers, unsubscribe subscribers, confirm unconfirmed subscriptions, delete subscriptions and export the list of email subscribers.


Integration Limits

The StatusDashboard email integration has the following subscriber/message limits:

Subscriber Limits

You can review how many confirmed email subscribers you have by navigating to Notifications > Email and viewing the Email Subscribers information field.

Message Limits

You can review how many email messages you have sent in the current month by navigating to Notifications > Email and viewing the Event Email Sent (this month) information field.


Testing Event Emails

You have the option of sending test emails to confirm that everything looks the way you want it before sending emails to your customers. To test event email settings, navigate to Notifications > Email > Options > Send Test Email.

Email Delivery Reports

StatusDashboard maintains a record of every email message sent including the delivery status (for example, 'sent').  If you would like to review a record of sent emails for your account, you may do so by navigating to Notifications > Email > Options > Delivery Report.  Once we send a message, if we receive updated information on its delivery status from recipient SMTP servers, we will update the appropriate record in our system.  Click on the information icon to view detailed information about the message, including any relevant SMTP events.


Required Permissions Role: Administrator or Notifications