# MS Teams

{% embed url="<https://www.loom.com/share/96d0cbd87e0e49699ac61ea376e108f9?sid=35a318fb-8908-4aa8-b18a-a95d8f13b1f2>" %}

1. Log in to [Dashboard](https://orimon.ai/login) -> navigate to the overview page of the bot that you want to change.
2. On the overview page, you will see several tabs. Look for the one labelled "Launch" and click on it.

<figure><img src="/files/78Vke399BhS8XtzzAuPM" alt=""><figcaption></figcaption></figure>

3. Select the "MS Teams" tab. Click on the "**Enable**" switch to enable the integration.
4. After you enable the Integration, you will see a page as shown below

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

Scroll down to see a section like one shown below

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

5. Open your web browser and go to [MS Teams](https://teams.microsoft.com/).
6. Once logged in, navigate to the developer portal, if not found then search for it in <mark style="color:blue;">`Apps`</mark> .

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

7. Select **Bot Management** in the <mark style="color:blue;">`tools`</mark> section and click the <mark style="color:blue;">`New Bot`</mark> button.

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

8. Provide a name for your bot, and then click the <mark style="color:blue;">`Add`</mark> button to create your bot.

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

9. After creating the bot you will be redirected to the **configure** page, add the below URL as <mark style="color:blue;">`Endpoint Address`</mark> and click **Save**.

```
https://channel-connector.saas-dev.oriserve.com/msteam/v1/msteamMessageHook
```

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

10. Navigate to the **Client Secrets** and click <mark style="color:blue;">`Add a client secret for your bot`</mark> .

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

Upon the prompt's appearance, make sure to **copy & save** the new <mark style="color:blue;">`Client Secret`</mark> for future use, as it will *no longer be visible again* after this.

{% embed url="<https://www.loom.com/share/8518dd5d71dd4a6eb9bbbe630617646e?sid=4be94a9c-494c-404e-a0d4-b569fdfdcbd9>" %}

10. Now go back **Bots** section, here you will see your newly created bot, copy the <mark style="color:blue;">`Bot ID`</mark> for future reference.
11. Now navigate to the <mark style="color:blue;">`Apps`</mark> section in the developer portal.
12. Click on the <mark style="color:blue;">`New App`</mark> button, provide an App name, and create the app.

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

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

13. Now fill in the basic details regarding your app including short name, full name, description, and all other details asked.
14. In the <mark style="color:blue;">`Application(client) ID`</mark> section paste the <mark style="color:blue;">`Bot ID`</mark> that we copied before and click Save.

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

15. Navigate to <mark style="color:blue;">`App Features`</mark> and select <mark style="color:blue;">`Bot`</mark> .
16. Choose your bot name from the drop-down under <mark style="color:blue;">`Select an existing bot`</mark> .

<figure><img src="/files/51rJX298nq1cub3f7YMa" alt=""><figcaption></figcaption></figure>

17. Now select at least <mark style="color:blue;">`Personal`</mark> among the given options under <mark style="color:blue;">`Scope in which people can use this command`</mark> and click on Save.

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

18. Navigate to the <mark style="color:blue;">`Publish To Org`</mark> option under the <mark style="color:blue;">`Publish`</mark> Section.
19. Click on the button <mark style="color:blue;">`Publish your App`</mark> and your request will be submitted to publish your app in your organization.

<figure><img src="/files/19qCmfjc7CiuL1YeXi3e" alt=""><figcaption></figcaption></figure>

20. &#x20;Ask your Admin to approve the App in the [admin portal](https://admin.teams.microsoft.com/) by searching your app in the <mark style="color:blue;">`Manage Apps section`</mark> under <mark style="color:blue;">`Teams Apps`</mark> and publishing it.

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

21. Once you app has been approved by your Admin, come back to Integration page on your OrimonAI dashboard\
    Now, provide the **Bot ID**, **Bot Name**(according to your preference) & **Bot Secret**, previously secured as shown below and click **Submit**.

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

22. If your chat-bot has been successfully integrated, you will see a screen as shown below

<figure><img src="/files/83cTp1zkCM3E6AEmFKWO" alt=""><figcaption></figcaption></figure>

{% embed url="<https://www.loom.com/share/2cc0926c49a449478627a86d1dd7e0e6?sid=69a67299-2975-4738-bc43-c70f5912bdd2>" %}

That's all! Now you have successfully integrated your chat-bot with MS Teams!


---

# 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://orimon.gitbook.io/docs/channels/ms-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.