Skip to main content
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 (a .zip file) that a Microsoft 365 or Teams administrator uploads to your organization’s app catalog in the Teams Admin Center. Once uploaded, Traversal appears under Built for your org in the Teams app store for the users you allow.
1

Get the app package

Contact the Traversal team to receive the Traversal Teams app package for your organization.
2

Upload the app to your org catalog

In the Teams Admin Center, go to Teams apps → Manage apps and select Upload new app (in some tenants, Actions → Upload new app). Select Upload and choose the Traversal package.The app can take a few hours to appear for users after upload.
3

Choose who can use Traversal

On Manage apps, select Traversal to open its details page, then:
  • Users and groups tab → Availability → Edit availability: choose Everyone, Specific users or groups, or No one. Only users Traversal is available to can add it to a team, chat, or meeting.
  • If your tenant hasn’t migrated to app centric management, use Teams apps → Permission policies to control which users can use Traversal.
  • To pin Traversal or install it automatically for selected users, add it to a policy under Teams apps → Setup policies.
At the org level, custom apps must be allowed under Manage apps → Actions → Org-wide app settings → Custom apps. You can block Traversal for everyone at any time by setting its status to Blocked.
4

Grant application permissions (optional)

Traversal works with the resource-specific consent (RSC) permissions granted when someone adds it to a team, chat, or meeting. Granting its tenant-wide application permissions unlocks org-wide features such as auto-joining meetings. See what each permission enables before you decide.Use any one of these options:
  • Teams Admin Center: on Traversal’s details page, open the Permissions tab, select Grant admin consent (labelled Review permissions and consent in some tenants), review the list, and select Accept.
  • Admin-consent link: open https://login.microsoftonline.com/<TENANT_ID>/adminconsent?client_id=60dd587e-57dd-406a-8424-96059aa83967, replacing <TENANT_ID> with your tenant ID or a verified domain. That client ID is Traversal’s production app. Every SaaS tenant consents to it, including where the Azure Bot resource is single-tenant in Traversal’s home tenant (the Entra app registration is multi-tenant). A dedicated deployment uses the app ID in the package Traversal sent you.
  • Microsoft Entra admin center: go to Enterprise applications → Traversal → Permissions and select Grant admin consent.
Consenting to Microsoft Graph application permissions requires a Global Administrator or Privileged Role Administrator. Microsoft limits the Teams Admin Center option to Global Administrators.
5

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. A Traversal organization admin clicks Connect to Traversal on that message to pair the workspace with your organization. A Teams admin can’t complete this step unless they are also a Traversal organization admin.
6

Start using Traversal

Once connected, add Traversal to the teams, group chats, or meetings where you want it. Whoever adds it grants its RSC permissions for that team, chat, or meeting.

​
Update the app

When Traversal sends you a new app package, go to Teams Admin Center → Teams apps → Manage apps → Traversal and select Upload file to replace the existing version. Your availability and policy settings carry over. Users accept the update in Teams the next time they open the app.
The production package is version 1.5.0. TeamSettings.Read.Group, ChatSettings.Read.Chat, and ChatMember.Read.Chat have been in the package since 1.3.0. If you uploaded an older package, upload the new version to get team names, chat names, and chat members without application permissions.

​
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 and set its status to Blocked (or its availability to No one), or remove it from individual teams via the team’s Manage apps page. To revoke application permissions you granted, remove them in Microsoft Entra admin center → Enterprise applications → Traversal → Permissions. For data export or deletion, email support@traversal.com with your tenant ID.

​
FAQ

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.
This likely means the app isn’t correctly installed in your workspace, or it isn’t available to you. Verify the upload step and Traversal’s availability on the Users and groups tab, or reach out to a Traversal team member.
Auto-joining new meetings needs three application permissions: Chat.ReadBasic.All, TeamsAppInstallation.ReadWriteAndConsentSelfForChat.All, and AppCatalog.Read.All. Grant them as described in the admin-consent step above. Changes can take up to an hour to take effect.
Teams is only delivering messages that @mention Traversal. ChannelMessage.Read.Group and ChatMessage.Read.Chat were not consented, usually because the installed package is older than 1.3.0 or users have not accepted an update. Upload the current package and have users accept it.When RSC is set to DisabledForAllApps, Traversal cannot be installed at all. See if RSC is restricted in your tenant.

Using the Traversal Teams bot

Learn how to start investigations and ask follow-up questions in Teams.

Data privacy and security

How the Teams integration handles data, including permissions and PII.