# How to migrate new Version

When you onboarded and configured your MS Teams channel before 27 september 2023 then you have the old version of the Botsquad MS Teams app. For full functionality you want to upgrade to the new DialoX MS Teams App.

First go to the studio and find the bot you need to migrate. Then remove the existing MS Teams integration using the following steps:

### Remove the old MS Teams

1. Go to channels
2. Click on MS Teams
3. Click remove

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

Now reconnect the channel by clicking Enable. This will show the following popup.

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

1. Download the ZIP file
2. Copy the "/connect …" to your clipboard by clicking on the little clipboard icon on the right.

### Remove the app from MS Teams

Remove the app from your MS Teams instance by opening your MS Teams App and find the team where you want to use the DialoX inbox and click on Manage team. Now click on the Apps tab, find EVA and click on the remove icon (the trash can):

{% hint style="info" %}
If you get an error, or it does not get deleted, you can delete the app through the Admin center. [#cannot-delete-eva-app](#cannot-delete-eva-app "mention")
{% endhint %}

### Upload the new .zip file

Now click on "upload a customised app" in the bottom right corner of the window.

<figure><img src="/files/0Jfmx1ETYzMyaTR7z2TX" alt=""><figcaption></figcaption></figure>

Locate the downloaded ZIP file and install it by clicking Add:

<figure><img src="/files/4qJGYEiVVKlYPGKA0B4D" alt=""><figcaption></figcaption></figure>

Now you can go to the channel in your Team where you want the DialoX inbox to submit notifications to new conversations and start a new conversation.

### Connect the Studio with MS Teams

Type in @DialoX and select @DialoX from the dropdown. Then paste the copied "/connect …" string behind it and send it.&#x20;

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

{% hint style="info" %}
Notice that the word DialoX in front of the sentence has a different color then the rest of the sentence (/connect …).
{% endhint %}

Now the DialoX inbox is connected to this MS Teams channel and you can verify this in the DialoX studio where you left off when downloading the ZIP file.

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

### Cannot delete EVA app

When you get an error trying to upload the .zip file to MS Teams you have to delete the app in the MS Teams admin certer. You can do this as followed:

Go to portal.office.com and log in. If you have Admin permissions you will find the Admin app in the list (left top corner with the 9 dots). Select Show all and find Teams in your admin center.

<div><figure><img src="/files/1lePWhqrqxHRoJgSa2l8" alt=""><figcaption></figcaption></figure> <figure><img src="/files/ZJsELYixsgi4IJ36HNQp" alt=""><figcaption></figcaption></figure> <figure><img src="/files/RYHRSE9VVTO9RUs3bKS0" alt=""><figcaption></figcaption></figure></div>

In your Teams admin center you go to Manage apps and find the EVA app.

<div><figure><img src="/files/HgCW82rXGOLTx1gYioT1" alt=""><figcaption></figcaption></figure> <figure><img src="/files/6TZ4ph7zP7NE44epnsgC" alt=""><figcaption></figcaption></figure> <figure><img src="/files/f8LTuvh6rGk1vKesKDZs" alt=""><figcaption></figcaption></figure></div>

When you go back to Manage apps, you can upload the .zip file here.

{% hint style="info" %}
It can take at least 5 minutes before the sync from the Teams Admin center to MS Teams is done. You will find the new DialoX app in MS Teams instead of EVA.
{% endhint %}

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


---

# 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://manuals.dialox.ai/studio/channels/ms-teams/how-to-migrate-new-version.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.