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

# Microsoft Teams

> Install the Traversal app in your Microsoft Teams workspace.

Bring Traversal into your team's Microsoft Teams workspace so engineers can start investigations and receive reports without leaving Teams.

## Install the Traversal Teams app

Traversal provides a Teams app package that a Teams administrator installs into your tenant.

<Steps>
  <Step title="Get the app package">
    Contact the Traversal team to receive the Traversal Teams app package for your organization.
  </Step>

  <Step title="Upload the app">
    A Teams administrator uploads the package in the **Teams Admin Center → Teams apps → Manage apps → Upload new app**, making it available to your organization.
  </Step>

  <Step title="Grant admin consent">
    A tenant administrator grants consent for the Microsoft Graph permissions the app uses. See [Microsoft Teams — data privacy and security](/integrations/microsoft-teams-data-privacy-and-security) for the full permission list and what each one is used for.
  </Step>

  <Step title="Connect your workspace to Traversal">
    Provisioning is self-serve. The first time someone interacts with Traversal, it replies with a prompt to connect your Microsoft Teams workspace to your Traversal organization. An admin clicks **Connect to Traversal** on that message to pair the workspace with your organization.
  </Step>

  <Step title="Start using Traversal">
    Once connected, you can begin using the Traversal bot in your Teams workspace.
  </Step>
</Steps>

## Verify it works

Once your workspace is connected, mention `@Traversal` in any channel and say hello.

## Uninstall and data deletion

To remove the app from your workspace, go to **Teams Admin Center → Teams apps → Manage apps → Traversal → Block**, or remove it from individual teams via the team's **Manage apps** page.

For data export or deletion, email [support@traversal.com](mailto:support@traversal.com) with your tenant ID.

## FAQ

<AccordionGroup>
  <Accordion title="Traversal asks me to connect the workspace instead of investigating">
    Your Microsoft Teams workspace hasn't been paired with a Traversal organization yet. An admin can click **Connect to Traversal** on that message to pair it.
  </Accordion>

  <Accordion title="I'm mentioning @Traversal but it's not responding">
    This likely means the app isn't correctly installed in your workspace. Verify the upload and admin-consent steps above, or reach out to a Traversal team member.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Using the Traversal Teams bot" icon="microsoft" href="/using-traversal/microsoft-teams">
    Learn how to start investigations and ask follow-up questions in Teams.
  </Card>

  <Card title="Data privacy and security" icon="shield-halved" href="/integrations/microsoft-teams-data-privacy-and-security">
    How the Teams integration handles data — permissions, PII, and Traversal's security posture.
  </Card>
</CardGroup>