ServiceNow (Marketplace Application)

ServiceNow <-> AlertOps Integration

ServiceNow is a powerful platform-as-a-service, which offers advanced automation and process workflow for the enterprise environment. Integrate AlertOps’ alert management platform with ServiceNow to receive and respond to critical alerts through email, SMS, push notifications (iOS and Android), and phone alerts. AlertOps ensures that alerts received from ServiceNow always reach the correct, available team member by utilizing escalation policies and on-call schedules. This integration also serves to sync groups from ServiceNow to AlertOps and incident updates along with the addition of notes.

Get the AlertOps App from the ServiceNow store here or search for 'AlertOps' in the ServiceNow Store

Refer to the documents in the ServiceNow Store page for AlertOps for more specifics/detailed information on the Integration.

AlertOps Configuration

1) Navigate to ‘Configuration’ > ‘Integrations’, to the right of ‘Inbound Integrations’ click ‘+Add API’ 

2) From the list select ‘ServiceNow’ 

3) Associate the integration with an Escalation Policy, and a Recipient Group. Click Save. Copy the Inbound Integration API Endpoint

4) Ensure the Mapping under 'Rules for Opening and Closing Alert' is as follows,

You can add further values for opening and closing alert based on the numeric mappings as shown below,

5) Now go to your User Profile and grab the User API Key under the ‘Profile’ section (preferably an App Admin/Owner user in AlertOps). 

<The Outbound Integration guide can be found after the 'ServiceNow Configuration' section>

ServiceNow Configuration

Please Refer to the 'Additional Notes' section in the case you encounter errors/ for more specifications.

1) Once you get the update-set/application from the ServiceNow store, go to the Navigation pane, search for 'AlertOps' and click 'Create New'

2) Click on the lock icon, and input the Inbound Integration Endpoint for Webhook URL, and the User API Key.

3) The ‘Group Sync enabled for’ is a section where you can see the Groups that are sync-enabled with AlertOps.

4) Now you should be able to see ‘Alerts’ created in AlertOps when Service Desk incidents are created in ServiceNow. Test this out by creating an Incident with the status ‘New’. Once created, you should see a ‘Work Note’ added to the incident indicating the Alert ID in AlertOps. 

This will create alerts or send signals to AlertOps for all incident updates. They can be filtered out on the AlertOps end through 'Open Alert When'/'Close Alert When' conditions or by adding 'Filters to Match Incoming JSON/Form Fields' based on what ServiceNow sends in the JSON (See Sample Data within the ServiceNow Inbound Integration in AlertOps). You can also add filters within the Business Rule in ServiceNow - 'Send to AO on Incident Create/Update' that can be found under 'System Definition' > 'Business Rules'

5) An alert is created if the mapping conditions in AlertOps Inbound Integration are satisfied (the correct Incident State value numbers are given for alerts that need to be opened). If there is a status mismatch you should see a work note with the following error. You would have to re-verify settings within the Inbound Integration in AlertOps.

6) Closure of the incident in ServiceNow will add a work note saying the alert was closed and the corresponding AlertID. 

7) Work notes added in ServiceNow, will also be added to the Alert’s notes in AlertOps  

8) In general, you can map any incident states / values in AlertOps. 

9) You can find more information on Mapping in the AlertOps-ServiceNow Inbound/Outbound Integration Guide or the AlertOps knowledge base or feel free to reach out to AlertOps support. 

10) Adding an Assignment Group and Assigned to, will map them to AlertOps, and autoassign user / group.

ServiceNow Group Sync

The AlertOps integration with ServiceNow can sync Groups from ServiceNow into AlertOps with the click of a button. Users or group members within a Group in ServiceNow are automatically added to AlertOps along with their contact information from ServiceNow, thus reducing the overhead of manual user addition in AlertOps. Just add/remove users from a Group that is synced in ServiceNow, and the rest is done automatically. 

1)  Go to ‘User Administration’ > ‘Groups’ in the ServiceNow navigation menu. 

2) (Optional) You will find a button called ‘Retrieve All Groups from AlertOps’. This is to retrieve all the groups from AlertOps and add them to ServiceNow. If the group in AlertOps has members, then those members will be added as Users in ServiceNow with just the Email contact methods (the rest of the contact methods like Phone, has to be added in ServiceNow for the user manually), and added as Group Members to the group. 

3) Click on any group. To sync the groups from ServiceNow into AlertOps, click the ‘Enable Sync to AlertOps’ button. This might take a few seconds, just wait for a popup that says ‘Sync Enabled, Pushed Existing Members to AlertOps’. 

4) Once the sync is enabled, you can go to AlertOps and check that the group has been added and the corresponding users (Under Configuration > Groups and Schedules). Th group’s name in AlertOps will be trimmed to lower case characters. Once Sync is enabled, you should see the button ‘Disable Sync to AlertOps’ within the group in ServiceNow 

5) The users will be added to AlertOps as well along with all their Contact methods (email, phones) 

6) You can click the ‘Edit’ button within the group in ServiceNow and add / remove users and this will correspondingly add users to AlertOps and add/remove them from Groups as well. 

7) If you click ‘New’ within the Group Members tab, and add a User it will add the user in AlertOps as well along with the Contact Methods (and add it to the Group as well) 

8) You should also be able to see the Group(s) in ServiceNow synced to AlertOps, by navigating to ‘AlertOps’ > ‘All’ and opening/previewing the record. 

Additional Notes (Important)

- When installing the app from the Marketplace, or through import of the update set, if you encounter errors during the preview (possibly one for Crypto Module Key Policy), select that particular record), and either skip the remote set, or remove it. 

- Every user in ServiceNow that may be added as a User in AlertOps should have an ‘Email’ contact method 

- To enable the sync of the group to AlertOps, there should be at least one group member in the group in ServiceNow 

- Username of the User in ServiceNow cannot have spaces since AlertOps does not allow spaces in the username 

- The Sync from ServiceNow is at the ‘Group’ level, hence users are to be added/updated/removed through the ‘Group Members’ tab in the Group in ServiceNow 

- When the ‘Enable Sync to AlertOps’ button is clicked, it may take some time for the Sync to be completed. 

- The ‘Retrieve Groups from AlertOps’ function will add the group with the users in ServiceNow but note that the users will have only the Email contact method. The other contact methods (Example: Phone) need to be added manually. 

- Once the sync is done to AlertOps, do not change the names of the users or the groups. 

- Update Set can be given from AlertOps on a requirement basis on reviewing the needs. 

- Note that all the Script Includes/Business rules for the application are within the AlertOps application scope in ServiceNow 

- For any queries feel free to reach out to support@alertops.com

AlertOps Outbound Integration Guide

You can create an Outbound Integration for ServiceNow , templated within AlertOps, to ensure bidirectional communication with ServiceNow, from AlertOps. (Example - when an alert is closed in AlertOps, close/resolve the incident in ServiceNow)

1) In AlertOps, under Configuration , select Integrations. Under Outbound Integrations, click '+ Add Outbound'

2) Select 'ServiceNow'. Type in your ServiceNow domain,

Once you create an Outbound Integration, if you have an Inbound Integration for ServiceNow, go there, under 'Rules for Opening and Closing Alert' under Advanced Settings, find 'SNOW Incident ID' and 'SysId' and add the following values.

3) You should find Methods for ticket creation, assignment, closure, note addition. Input your Username and Password for the API user in ServiceNow, or any user with sufficient permissions.

For 'Create Ticket' you can edit the 'Request Data' JSON, and modify urgency,priority,severity and impact as needed,using the values below,

4) Once you create the Outbound Integration, you would have to associate them with Workflows which would trigger this Outbound Integration methods based on Conditions specified in the Workflow (For either assignment, closure, or opening of the Alert). You can refer to the legacy document for creation of 'workflows' 

5) Note that every method is customizable, and you can add more methods as needed. You can refer to ServiceNow's API specification and model methods as per your requirements. For information or help contact support@alertops.com

Links and References

1) ServiceNow App Store application

2) AlertOps Application General Specs

3) Integration Guide