microsoft-teams.md

description
Get alerts on your Microsoft Teams from Spike.sh

Microsoft Teams

Our Microsoft Teams app simplifies incident management by delivering alerts directly to your Teams channels and enabling you to take immediate actions. Below is a quick overview of the available features:

1. Receive Incident Alerts: Get real-time incident alerts directly in your Teams channels
2. Create Incidents from Teams: Seamlessly create new incidents directly from within Microsoft Teams and keep your workflow uninterrupted.
3. Manage Incidents: Easily acknowledge, resolve, or escalate incidents.
4. On-call Notifications: Receive direct messages for the start and end of your on-call shifts, invitations to join a war-room, and notifications when you're mentioned in a comment on Spike.sh.
5. On-Call Shift Information: Quickly check who is currently on-call and get details about your current and upcoming on-call shift timings.

Install our Teams app directly or search for "Spike.sh" in the Teams Apps section on the sidebar. If you need assistance with installation due to permission restrictions, please contact your Teams admin.

If you're unable to install the app, you can still receive alerts by using the Incoming Webhook connectors. Scroll down for detailed setup instructions.

{% embed url="https://www.youtube.com/watch?v=aLuMQXcaJEk" %}

Getting Started with the Spike App on Microsoft Teams

After installing the app, you'll receive a message with instructions on how to connect your Spike account. For full functionality, we recommend using both the connect and connect-org commands.

{% hint style="info" %}

• The connect command links your personal Spike account with Teams, enabling direct messages for on-call shift notifications and when you are mentioned in a comment.

• The connect-org command links your organization’s Spike account with Teams. This will enable your org to receive actionable incident alerts in channels.

For the best experience, we suggest running both commands. {% endhint %}

Available Commands

{% tabs %} {% tab title="Commands in Microsoft Teams" %}

• New incident:
  • /create-new-incident - Create a new incident from Teams
• Am I on-call?:
  • /oncall-me - Check if you are on-call and when your shift ends.
• Who is on-call?:
  • /oncall-now - See who is currently on-call.
• Disconnect:
  • /disconnect - Disconnects your Spike account from Teams. Note: This will only disconnect your personal account. Incident alerts will continue to be available in channels. {% endtab %} {% endtabs %}

Setting Up Incident Alerts with the Spike App

Once your account is connected, you can easily add any of your Teams channels to an escalation policy. To do this, select "Teams" in the escalation policy, and your available channels will automatically appear on the right-hand side.

Any team member can take action on an incident directly from Teams. We recommend creating a dedicated channel for responders to receive and manage alerts. If an incident is acknowledged or resolved via the Spike dashboard, phone call, email, or any other medium, the latest incident will be automatically reflected in the Teams channel, along with the suppressed and repeated counts.

Direct Messages (DMs)

After running the connect command, you can use the oncall-me and oncall-now commands to get information about your on-call schedules directly in Teams. You will also receive direct messages from Spike.sh for important notifications, such as:

1. Invites to War rooms
2. Mentions in comments
3. The ability to create new incidents directly from Teams
4. Your on-call shift alerts

Connecting multiple groups on Teams

Since our bot can only be connected to one group at a time, you'll need to disconnect the current group and then reconnect to the new one.

You can easily connect the Spike bot to multiple groups of channels in Microsoft Teams. Follow these steps:

1. Go to the desired group in Microsoft Teams and type @Spike.sh connect-org to establish the connection.
2. Next, visit your escalations page, and you'll see the newly connected channels listed in the dropdown menu.

There is no limit on how many groups can be connected.

---

Get Teams alerts from Spike.sh using Incoming Webhook (to be deprecated)

{% hint style="warning" %} Microsoft will deprecate all new webhook connectors on 15th September. On Spike, we will deprecate the incoming webhook support on 26th November 2024. {% endhint %}

The alert messages on Microsoft Teams (referred to as Teams from here on) comes with gists for you and your team to quickly learn about the incident.

How to set up Teams?

Step 1 - Setup incoming webhook

Go to the Apps section in your teams account and install the Incoming Webhook app (created by Microsoft).

Select a channel of your choice and click setup connector

Name your connector and upload our Spike.sh logo so as to easily identify alerts coming from us. You can download our logo here.

Step 2 - Paste the URL on Spike.sh

Head over to Spike.sh dashboard and visit settings > organisation > alerts and create a Teams integration by giving a friendly name along with the URL you copied from step 1.

{% hint style="warning" %} Make sure to paste the exact URL from above. Any changes in the URL might result in missing alerts {% endhint %}

{% hint style="success" %} Once integrated, we will send a sample alert to your configured Teams channel {% endhint %}

A friendly name will help you identify this integration while creating escalation policies. Like below -

You can create multiple Teams integrations with different incoming webhooks configured on Teams.