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

# Home tab

> Open the Ravenna Portal home inside Microsoft Teams with the Home personal tab: chat with an AI agent, file tickets, and find the team that can help.

The Ravenna app for Microsoft Teams opens on a **Home** personal tab that brings the Portal (Ravenna's branded self-service home for requesters) organization home into Teams. Chat with an AI agent, file a ticket, or pick the team that can help, without leaving Teams.

## Mental model

The Home tab is a Teams `staticTab` (`ravenna-home`, personal scope) declared in the Ravenna app manifest, version 1.1.0 and later. It is listed before the My Tickets tab (`ravenna-tickets`). It loads the Portal organization home in the Teams web view, scoped to the signed-in user.

Authentication matches the [My Tickets tab](https://docs.ravenna.ai/integrations/microsoft-teams/my-tickets-tab.md): the tab requests an SSO token through the Teams JS SDK and exchanges it with the Ravenna API for a Ravenna session. The session refreshes in the background, and again when the tab becomes visible after a long idle period, so an open chat keeps working.

***

## Behavior

* The AI chat and quick questions show only when the organization has a Portal agent. The chat uses the same Portal agent as the web Portal and returns ticket cards for tickets it creates.
* Links to Ravenna pages (team cards, ticket cards and other entity links in the chat) open in the browser through the Teams link handler.

***

## Constraints and gotchas

* Admins must upload the 1.1.0 app package in the Teams admin center. Tenants on 1.0.0 only have the My Tickets tab.
* The tab requires the Ravenna Teams app to be installed for the user and the Ravenna Entra app to be admin-consented in the tenant, as part of the initial [setup](https://docs.ravenna.ai/integrations/microsoft-teams/setup.md).


## Related topics

- [User handbook](https://docs.ravenna.ai/guides/user-onboarding/handbook/quirky-edition.md)
- [App Home](https://docs.ravenna.ai/integrations/slack/app-home.md)
- [My Tickets tab](https://docs.ravenna.ai/integrations/microsoft-teams/my-tickets-tab.md)
- [Creating tickets](https://docs.ravenna.ai/integrations/slack/creating-tickets.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.