At the beginning of November, Microsoft joined the chat-based workspace apps with Microsoft Teams to compete with Slack, HipChat, and others. It's fully integrated with Office 365, and has features that users of other apps have come to know and love such as bots and connectors, and some new cool ideas like tabs.
Here at Runscope, we know that regardless of the chat application your company uses, monitoring your APIs and being quickly notified of any errors is important for any team. That's why we are making a preview of our Microsoft Teams integration available to all customers. Here's how you can get started!
Setting up Microsoft Teams
First things first, log onto your Microsoft Teams account. We recommend creating a new channel for our monitoring notifications, as sometimes people in different teams might be interested in being notified of any API errors.
After you choose which channel you want to send notifications to, select the "Teams" tab on the left-hand side, hover over your channel, click on the ". . ." symbol, and select "Connectors".
You should see a new window with a list of multiple connectors. In our case, select the "Incoming Webhook" option and click on "Add".
In the next screen, you can select a username and a profile image for the notifications. In our case, we'll just use "Runscope", and set our logo as the image.
Finally, the last thing you have to do is just copy the Webhook URL that Microsoft Teams generates for you.
Setting up Runscope
Now head over to your Runscope account. After logging in, click on your profile picture on the top-right and select "Connected Services".
You should see all the integration options available for your Runscope account. Look for the Microsoft Teams options and click on "Connect Microsoft Teams".
In the next page we have three fields:
- Webhook URL: paste the URL you got from the Microsoft Teams webhook configuration here.
- Channel Name: you can add multiple Microsoft Team connections to the same Runscope account. The name can help you distinguish between multiple connections.
- Notifications: select when you want to be notified after test runs are completed.
After you fill out all the fields, click on "Connect Account"!
Now, for our final step, we just have to activate our notification for our tests. Head over to the API tests you want to monitor in your Runscope account, and select "Editor" on the left-hand side.
Click on your environment settings to bring down the full options menu, and select "Integrations". Finally, click on the toggle for the Microsoft Teams service we just connected, and you're all set!
If you chose to get a notification whenever your test runs are completed, you can just click on "Run Now", and you should see a notification pop-up in your Microsoft Teams channel similar to this:
This integration is a preview, so please note that things might change in the future. If you have any feedback, we'd love to hear from you! Please reach out to us at firstname.lastname@example.org.