# 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="/pages/QVrCXwRcuy8YWA5L25VR" %}
[Event Rules](/docs/platform/events/alerts.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.halosecurity.com/docs/integrations/workflow-integrations/microsoft-teams.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.