> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Microsoft Teams to Cogno

> Connect your Microsoft tenant so Cogno reads Teams channel activity as workspace context and turns it into proposed tasks.

<img src="https://mintcdn.com/genaxis/oMT3YnoHFDqPiaPK/images/integrations/teams.svg?fit=max&auto=format&n=oMT3YnoHFDqPiaPK&q=85&s=1c788a17465a8582e2d9b0878d8a0675" alt="Microsoft Teams" width="56" height="56" noZoom data-path="images/integrations/teams.svg" />

## At a glance

|                    |                                                                              |
| ------------------ | ---------------------------------------------------------------------------- |
| **Direction**      | Receive — Cogno reads Teams channel and chat activity for workspace context. |
| **Connect with**   | Microsoft **admin consent** (a tenant-wide app grant).                       |
| **Who can set up** | A Microsoft tenant admin — connecting grants app consent for the tenant.     |
| **You'll need**    | Admin rights in your Microsoft tenant.                                       |

Connect Microsoft Teams and Cogno reads your channels' activity, using it as workspace context and turning actionable messages into **proposed tasks**. Because Teams consent is tenant-wide, an admin sets it up once for the whole organization.

## Before you start

* You can open **Settings** in the target workspace.
* You can sign in to Microsoft as a **tenant admin** to grant app consent.

<Note>
  Teams connects through Microsoft admin consent, not a personal login. If you're not a tenant admin, ask one to complete the connection.
</Note>

## Connect Microsoft Teams in Cogno

<Steps>
  <Step title="Open the Teams integration">
    Open **Settings → Integrations** and select **Microsoft Teams**.
  </Step>

  <Step title="Grant admin consent">
    Click **Connect Teams**. Cogno opens Microsoft's admin-consent screen; sign in as a tenant admin and approve.
  </Step>

  <Step title="Confirm the connection">
    Back in Cogno, the **Connection** section shows your Microsoft tenant. Use **Re-authorize** later if the grant needs refreshing.
  </Step>
</Steps>

## Turn on event listening

New connections don't ingest anything until you switch listening on.

<Steps>
  <Step title="Open Event listening">
    In the **Event listening** section, review the toggle (status shows **Active** or **Off**).
  </Step>

  <Step title="Enable it">
    Turn the switch on to start receiving messages, channel updates, and member changes from Teams.
  </Step>
</Steps>

## Browse teams and users

* **Teams** lists the teams and channels in your tenant; expand a team to see its channels.
* **Users** lists the people in your Microsoft tenant.

## Disconnect

Under **Disconnect**, click **Disconnect Teams** to remove Microsoft Teams from this workspace.

## Common states

| State                                   | Meaning                                | Next action                                                     |
| --------------------------------------- | -------------------------------------- | --------------------------------------------------------------- |
| Connected, but nothing appears in Cogno | Event listening is still off           | Turn on the **Event listening** toggle                          |
| Connect fails at the Microsoft screen   | You're not signed in as a tenant admin | Sign in with a tenant-admin account, or ask an admin to connect |
| **Teams** or **Users** list is empty    | The tenant data hasn't loaded          | Click **Refresh**                                               |

## Reference URLs

* [Microsoft: tenant admin consent to apps](https://learn.microsoft.com/entra/identity/enterprise-apps/grant-admin-consent)

## Related docs

* [Troubleshooting](/docs/troubleshooting)