> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/integrations/chat-integrations/channel-integrations/microsoft-teams-channel-integration.md).

# Microsoft Teams Channel Integration

## The Microsoft Teams channel integration in Ebbot

Bring the power of Ebbot directly into your employees' existing workspace by integrating it with Microsoft Teams. This allows users to interact with the chat agent/chatbot through direct messages, creating a seamless and efficient internal support channel. The functionality mirrors the Ebbot chat widget, providing a consistent user experience.

Note: the channel integrations are only available in the Chat platform.

## Requirements and setup

To setup the Microsoft Teams channel integration, you need administrator permissions in Azure and Teams admin panels to complete the steps.

You can find the necessary integration credentials and setup guide within your Ebbot account by navigating to Settings > Integrations > Channels > User > Teams in the Chat platform. 

## Supported message types

The Teams channel integration support the following types of messages:

* **Text:** For standard conversational queries.
* **EbbotGPT:** Leveraging advanced AI for more complex questions.
* **Images and files:** Enabling users to share visual information and documents.
* **Intermediates:** Invisible message type used for updating data within the chat.
* **Input strings:** For capturing specific user data.
* **Multiselect:** Allowing users to choose from predefined options.

### Stored user information

When a user chats via the Microsoft Teams integration, the following person data is stored:

| Field          | Type   | Description                                |
| -------------- | ------ | ------------------------------------------ |
| `title`        | string | Honorific/title (e.g. "Miss", "Mr", "Mrs") |
| `status`       | string | Entity type, e.g. `"person"`               |
| `first_name`   | string | User's first name(s)                       |
| `last_name`    | string | User's surname                             |
| `dynamicName`  | string | Full display name (first + last)           |
| `email`        | string | Email address                              |
| `phoneNumber`  | string | Landline/work phone number                 |
| `mobileNumber` | string | Mobile phone number                        |

**Note:** `phoneNumber` and `mobileNumber` may be empty strings if not available from Teams.

## Known limitations

The Teams channel integration enables your end users to send personal messages to the chat agent/chatbot. The chat agent cannot currently be added to channels in Teams.