> For the complete documentation index, see [llms.txt](https://docs.ox.security/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ox.security/ticketing-and-messaging/messaging/microsoft-teams.md).

# Microsoft Teams

Microsoft Teams is a powerful collaboration platform that enables seamless communication and coordination across organizations. With its integration capabilities, it can serve as an effective notification and communication system for security platforms such as OX Security.

By leveraging Microsoft Teams, you can receive real-time security alerts, incident updates, and workflow notifications directly within your Teams channels or private chats, ensuring swift response and improved security operations.

This way, you can streamline incident management, reduce response time, and enhance team collaboration.

Integration use-cases:

* [Sending information about an individual issue to Teams.](#sending-a-teams-message-about-an-issue)
* [Adding OX-Teams related tasks as part of OX workflows.](#adding-teams-messages-to-workflows)

## Prerequisites

* Microsoft Teams account
* (Optional) Administrative access to Microsoft Azure Admin Center
* Permissions to manage enterprise applications in Azure

## Connecting to Microsoft Teams

1. In the **OX app**, go to **Connectors** and search for Microsoft Teams.

<figure><img src="/files/Dj52RiARN7ehK5RtlGC6" alt="" width="139"><figcaption></figcaption></figure>

2. Select **Microsoft Teams**. The **Configure your Microsoft Teams credentials** dialog appears.

<figure><img src="/files/yOeUr4Y6CGLXwo1d4mV3" alt="" width="357"><figcaption></figcaption></figure>

3. Select **CONNECT**. The Microsoft Teams connector is configured.
4. In case you do not have the administrative access to Microsoft Azure Admin Center, the permissions request appears.

<figure><img src="/files/Kqe0ZqfV47gd1ydsSleV" alt="" width="375"><figcaption></figcaption></figure>

5. Select **Accept**.

## Viewing OX in Microsoft Entra admin center

1. Go to **Microsoft Entra admin center,** login and select **Applications** **>** **Enterprise Applications**.

<figure><img src="/files/RsaWdTkRKvYs3huF3MRW" alt=""><figcaption></figcaption></figure>

2. From the right pane, select **OXSecurity**. The **OX Security Overview** pane appears.

<figure><img src="/files/s4qEW9PDS6tWUmX1eo8Z" alt=""><figcaption></figcaption></figure>

3. From the left pane, select **Permissions**. The **Permissions** pane appears, displaying the list of the channels through which you can get messages to Teams.

<figure><img src="/files/Tc0hGu2yQ2iBXrR9z3KM" alt=""><figcaption></figcaption></figure>

## Sending a Teams message about an issue

1. In the **OX app**, go to **Active Issues,** select the issue about which you want to send a message to Microsoft Teams, and in the issue property section, select the Teams icon. The **Send message to Teams** dialog appears.

<figure><img src="/files/trPaUydoZdGec0Fziq2Q" alt="" width="375"><figcaption></figcaption></figure>

2. Add recipients and a comment, and select **SEND**.

## Adding Teams messages to workflows

1. In the **OX app**, go to **Workflows** and select the workflow to which you want to add sending Teams messages.
2. In the workflow, find the step to which you want to add the Teams-related action and click **+**.

<figure><img src="/files/4xtbvd1i1cdUlI5XeUeM" alt="" width="130"><figcaption></figcaption></figure>

3. Select **Action > Teams** and set the following:

| **Select recipients:**               | Select message recipients.                                                                                                                                       |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Select recipients fallback:**      | Select fallback recipients.                                                                                                                                      |
| **(Optional) Add your own comment:** | IT's a good practice to add a comment to the message, providing additional info.                                                                                 |
| **Execute on:**                      | <p>Select one of the following conditions:<br>- New Issues<br>- Updated Issues<br>- New or Updated Issues<br>- New, Updated or Existing Issues<br>- Periodic</p> |

<figure><img src="/files/m4HIOW53oym4sS10JqIe" alt=""><figcaption></figcaption></figure>

4. Select **ADD**. The new action appears in the workflow.

<figure><img src="/files/QoiMd8anmldvgQynenCu" alt="" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.ox.security/ticketing-and-messaging/messaging/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.