Welcome to the xMatters community!

We created this site for our customers and partners and we encourage you to explore, engage, and learn. To ensure that this community is fun and helpful, professional and respectful participation is expected... and troll-like behavior won't be tolerated.

The information in this article is the intellectual property of xMatters and is intended only for use with xMatters products by xMatters customers and their employees. Further, this intellectual property is proprietary and must not be reused or resold.

Stride integration status

Atlassian had decided to discontinue their Stride application as of February, 2019, in favour of Slack. We've left this article to provide support to our users who currently have a Stride integration up and running. However, if you're interested in implementing a new chat integration, check out our Slack integration.

Introduction

Stride is a cloud-based team business communication and collaboration tool. Coupled with xMatters, this integration lets you:

Look up who's on-call

Send notifications to a user or group

Invite an xMatters user or group to a room

How it works

This integration uses an xMatters app installed into your Stride account to pass information to an inbound integration. After configuring the integration in Stride, click the (x) in the sidebar to target an xMatters user or group and invite them to the room.

Before you begin

Before you get started configuring the integration, there are some things you can do ahead of time to make it easier.

Download the communication plan

Download the communication plan attached to this article to a location on your local machine. The communication plan contains pre-configured integrations, forms, properties, and messages specifically designed for Stride.

Do NOT extract the contents of the communication plan .zip file! You'll import it directly into xMatters.

Configure xMatters On-Demand

The first steps in setting up your integration are to configure xMatters and copy information from xMatters that you'll need to set up Stride.

Set up an integration user

This integration requires a user who can authenticate REST web service calls when working with events – these permissions are provided by the "REST Web Service User" role in xMatters.

For Free and Trial customers, your system has an "Integration User" already configured with the REST Web Service User role, so you don't need to burn up an extra user from your limited supply. Make sure you've changed this user's password from the default, then you're good to go.

For everyone else, we recommend you create a user specifically for this integration because this user appears as the initiator or submitter of events from the integration (in messages, the Communication Center, event reports, etc.). Give this user the "REST Web Service User" role and a profile that lets you easily identify the user as specific to the integration – for example:

User ID: stride

First name: Stride

Last name: Integration

Note: Make sure you keep the user ID and password of this user handy. You'll need them when configuring other parts of this integration.

Create users and groups to target

The integration invites xMatters users or groups to a Stride Room. Make sure you've defined in xMatters the users and groups you'll want to invite. For information on creating users and groups, see the xMatters On-Demand help.

For the Invite People form, click the Web Service drop-down list, and then select Sender Permissions.

Add the integration user, and then click Save Changes.

Configure inbound integrations

You need to configure the authentication for the inbound integration then copy the URLs to paste into Stride.

To configure an inbound integration:

In the Integration Builder, expand the list of inbound integrations.

Click the name of the integration to view its details.

Scroll down to How to trigger the integration at the bottom of the page, and select the integration user as the authenticating user (make sure the authentication method is set to URL authentication). The URL trigger is updated to reflect the new user.

To be able to select the integration user, you need to be a supervisor of that user and the user needs to be assigned to the REST Web Services role.

Click Copy beside the Trigger field:

Configure Stride

To configure Stride to integrate with xMatters, you need to:

Install the xMatters app into your Stride instance.

Configure the integration.

Install the Stride xMatters app

You can now install the xMatters app in your Stride instance, and use the values you copied above for the Hostname and "Invite People inbound integration URL" fields.

To install the Stride xMatters app:

Log into Stride, click the Apps icon in the sidebar, and then click the plus sign (+) to add a new app.

Click Add custom app to launch the Custom app dialog.

Select the Installation URL tab and copy and paste our installation URL into the field: https://connect.atlassian.io/addon/descriptor/dyWF93vikvt5O4YXmXsLPfOApmDFKjjJ/latest

Specify the room where you want to add the app, and then click Add to Conversation.The xMatters Integration requires permission to access some of your Stride information so it can send invitations on your behalf. By clicking Add to Conversation, you give the xMatters integration this access.

In the xMatters Configuration dialog box, fill in all required fields:

To add the app in another Stride room, repeat steps 1-6 for that room.

And that's it! Your integration should be ready to go.

How to use the integration

When inviting people to join a room or meeting in Stride, the integration uses the permissions of the integration user to determine which users and groups you can invite. By default, the REST Web Service User role has permission to invite all other roles in the system so you should be able to invite any xMatters user to a room.

Before you can invite a group, however, you'll need to make sure that the REST Web Service User role is included in the list of group observers for any group that you might want to invite.

To invite an xMatters user or group to a room:

In Stride, open the room you want to invite people to (make sure that the xMatters Integration has been added to that room).

Click the (x) in the Stride sidebar.

In the xMatters dialog box, select Invite People and start typing to find the names of users or groups in xMatters that you want to join the room.

Select Invite to Meeting: If enabled, users are invited directly to the room's Stride Meeting video conference. Otherwise, users are redirected to the room page.

Enter a message to tell people why you're inviting them and click Send Invite.

xMatters contacts the specified users on their preferred devices and prompts them to join your room.

To look up who's on call:

In Stride, open the room where you want to post the on-call information (make sure that the xMatters Integration has been added to that room).

Click the (x) in the Stride sidebar.

In the xMatters dialog box, select Who's On Call and type the name of the xMatters group that you want to find the on-call information for.

You can see the first few entries in the on-call list displayed in the dialog box.