# Microsoft Teams

## Overview <a href="#overview" id="overview"></a>

The Microsoft Teams Integration connects IFS Loops to your Teams environment to ingest and analyse channel messages. It supports two capabilities — Helpdesk and Collaboration — and uses OAuth-based authentication with automatic token persistence to keep the connection active.

## Setup instructions

### Initiate integration

{% stepper %}
{% step %}
Log in to the IFS Loops platform using your credentials.
{% endstep %}

{% step %}
Navigate to the Connectors section from the sidebar.
{% endstep %}

{% step %}
Click on the Add Integration button.
{% endstep %}

{% step %}
Choose Teams from the list.
{% endstep %}
{% endstepper %}

### Microsoft Teams configuration <a href="#step-2-basic-configuration" id="step-2-basic-configuration"></a>

{% stepper %}
{% step %}
Go to the Integration Configuration page.
{% endstep %}

{% step %}
User Email (Optional)

* Enter the email address of the Teams account used for authentication.
* This is optional and is used only for identification.
  {% endstep %}

{% step %}
Select Capability Configuration

* For Collaboration Capability:
  * Select the environment (Production or Sandbox).
* If Sandbox is selected:
  * Choose the Team that contains the channel you want to use.
* For Helpdesk Capability:
  * Select the channel from which you want to pull messages.
    {% endstep %}

{% step %}
Click on the Update button.
{% endstep %}
{% endstepper %}

### Data ingestion job

{% stepper %}
{% step %}
Navigate to the Jobs / Data Ingestion tab.
{% endstep %}

{% step %}
Select Ingress Type as Full Ingress for Helpdesk capability.&#x20;
{% endstep %}

{% step %}
Select Collaboration Channel Ingress for Collaboration capability.
{% endstep %}

{% step %}
Click on Start Ingress.
{% endstep %}

{% step %}
After a few minutes, verify the job status is successful.
{% endstep %}
{% endstepper %}

## Token management

### Regenerate token

{% stepper %}
{% step %}
Go to the Microsoft Teams integration. Click on the Edit button.&#x20;
{% endstep %}

{% step %}
Click on the Edit button.
{% endstep %}

{% step %}
Navigate to the Authentication tab.
{% endstep %}

{% step %}
A login window will appear.
{% endstep %}

{% step %}
Log in using your credentials and grant permissions.
{% endstep %}

{% step %}
On success, you will see the message: "Integration updated successfully."
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.theloops.io/agenticstudio/integrations/microsoft-teams.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.