# Installing Wrangle in Teams

### Installation Steps

#### Step 1: Sign in to Wrangle

Go to [Wrangle](https://app.wrangle.io/) and click **Log In with Teams**.

<figure><img src="/files/qsikXDHZ8qGDNnBMp8kv" alt="Wrangle sign-in page"><figcaption></figcaption></figure>

#### Step 2: Authorize Wrangle in Teams

<figure><img src="/files/gagwNdk8AfDzs5Mlemxq" alt=""><figcaption></figcaption></figure>

You'll be redirected to Teams to authorize the connection.

1. Review the permissions Wrangle is requesting
2. Click **Accept** once satisfied

#### Step 3: Download Wrangle for Teams

After authorizing, you'll be redirected back to Wrangle to continue the installation process. Click Download Wrangle for Teams and then continue to the next step.

<figure><img src="/files/pJHBFJVkT8s7AaU0YGIv" alt=""><figcaption><p>Download Wrangle for Teams</p></figcaption></figure>

#### Step 4: Install Wrangle for Teams

To install Wrangle in Teams, you'll need to be a Teams Admin or have the appropriate permissions to upload apps into your tenant.

<figure><img src="/files/k8AAAk7w5NrIG433jDnY" alt=""><figcaption><p>Installing Wrangle in Teams</p></figcaption></figure>

Note: you should be a Teams Admin to complete these tasks for your organization.\
\
To install Wrangle into Teams:

1. [Open Microsoft Teams](https://teams.cloud.microsoft/)
2. Visit Apps > Manage your apps > Upload an app.&#x20;
3. Select `Upload an app to your org's app catalog` .
4. Select the file you just downloaded and click Install.
5. Click  `Add` :

<figure><img src="/files/uETzEdstEyD2WRrDwBpD" alt=""><figcaption><p>Click Add to install Wrangle</p></figcaption></figure>

6. Now the Wrangle app modal will open and you'll want to click `Add` again:

<figure><img src="/files/GhPrTyQBv4WlkRXjjueY" alt=""><figcaption><p>Click Add to install Wrangle</p></figcaption></figure>

7. Finally, **you must select a channel** to continue with Wrangle, as shown below:\ <br>

   <figure><img src="/files/K3I56RuJLP5YkJYCnbCq" alt=""><figcaption><p>Select a channel to use Wrangle within Microsoft Teams</p></figcaption></figure>

Once you have selected your channel, click Go.

\
Once you are done, click Verify Installation to continue to Wrangle. If you run into errors with the verification, follow [the instructions below to add Wrangle to a specific Team](#how-to-add-wrangle-to-a-specific-team) before continuing.<br>

#### Step 5: Approve Wrangle for your Organization

When installing Wrangle, you'll see one final authorization screen that requires a Teams admin to continue:

<figure><img src="/files/UXZ0ETeS5vZPA56yQSeg" alt="Additional Permissions Required screen"><figcaption><p>Ask a Teams Admin to grant Wrangle permission for your organization</p></figcaption></figure>

You'll be redirected to Teams to authorize the connection.

1. Review the permissions Wrangle is requesting
2. Click **Accept** once satisfied

\
\
That's it! You're now ready to [create your first inbox](/tickets/getting-started-with-wrangle/wrangle-for-teams.md) to manage your tickets with Wrangle.<br>

{% hint style="info" %}
We take privacy seriously. [Wrangle is **SOC2 certified**](https://www.wrangle.io/security), so you can trust that your data is secure.
{% endhint %}

#### How to Add Wrangle to a specific Team

If you run into an error verifying your installation or selecting a Team for use within an inbox, ensure you've added Wrangle to your Team.\
\
You can do this following these steps:\
\
1\. Open the Wrangle app within Teams. Visit the Apps page, and click Wrangle.

<figure><img src="/files/lpNjg8L3pLRz1kFhJwwV" alt="Select Wrangle from your Apps in Teams" width="375"><figcaption></figcaption></figure>

2. Click the `Open` button and make sure to **Select a channel** in the menu shown below.

<figure><img src="/files/Ra8gnOd8rRNyqSJUGspg" alt="Select a channel in Teams" width="253"><figcaption></figcaption></figure>

3. Once you have selected your channel as shown above in Step 2, click `Go`.<br>

That's it! Wrangle is now available for use within your Team.


---

# 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://docs.wrangle.io/tickets/getting-started-with-wrangle/installing-wrangle-in-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.
