# Microsoft Teams

{% hint style="info" %}
This integration is currently in beta.
{% endhint %}

This integration allows you to route notifications about issues, changes, and other events to Microsoft Teams.

### Generate Webhook URL in Microsoft Teams

1. Navigate to the channel where you want to receive alerts
2. Select **⋯ More options** → **Workflows**
3. Search for "Post to a channel when a webhook request is received"
4. Click **Add**
5. Confirm the Microsoft 365 account that the workflow will use to post messages.
6. Give the workflow a clear name (e.g., "Halo Security Alerts")
7. Verify the Team and Channel fields are correct
8. Click **Add workflow**
9. Copy the webhook URL that appears in the dialog
10. Click **Done**

[Learn More](https://support.microsoft.com/en-us/office/create-incoming-webhooks-with-workflows-for-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498)

### Create Integration in Halo Security

1. In the Halo Security dashboard, visit your *Settings → Integrations →* [Add](https://app.halosecurity.com/user/settings/integrations/add)
2. Add the Microsoft Teams integration
3. Enter a name for the integration
4. Click **Add**

### Create Profile in Halo Security

1. From you Microsoft Teams integration, navigate to the **Profiles** tab
2. Click **Add Profile**
3. Give your profile a name
4. Paste the webhook URL from Microsoft Teams into the **Webhook URL** field
5. Click **Save**

{% hint style="info" %}
You can always create additional profiles for different channels or types of notifications.
{% endhint %}

### Create Event Rules

To receive Microsoft messages, create Event Rules and add your **Microsoft Teams profile** as an action. Visit *Events →* [Event Rules](https://app.halosecurity.com/user/settings/event-rules/) to set up rules that determine which events trigger messages in Microsoft Teams.

Learn more about configuring Event Rules at:

{% content-ref url="../../platform/events/alerts" %}
[alerts](https://docs.halosecurity.com/docs/platform/events/alerts)
{% endcontent-ref %}
