# Microsoft Teams

{% hint style="info" %}
O Microsoft Teams é uma plataforma de comunicação que combina chat no local de trabalho, videoconferências, armazenamento de arquivos e integração de aplicativos.

Para configurar o essa ferramenta com o seu bot, é só seguir alguns passos.

Vamos lá!
{% endhint %}

## Configurando Webhook

1- Após criar o seu bot, clique nele e acesse a opção Fluxos de Conversa:

![](/files/-MHHkl_x0dUQ3bg3UwNH)

2- Na URL do navegador, copie o código que aparece depois de flows/,  e guarde esse dado. Esse é o id do seu bot:

![](/files/-MHHdTu4rkAsmdWiN8fm)

{% hint style="info" %}
OBS#: Exemplo:[https://app.cosmobots.io/builder/flows/](https://app.cosmobots.io/builder/flows/9af043a0-781e-11e9-bff6-453f5cfb9db4)***9655sdasdjhskdajhdkjs7-545454***

Nesse exemplo, `9655sdasdjhskdajhdkjs7-545454` é o id do seu bot.
{% endhint %}

3- Dentro do Microsoft Teams, em equipes, selecione a equipe que deve conseguir conversar com o bot:

![](/files/-MHHhvPhXXopGq6P9NkR)

4- Selecione a opção aplicativos e no canto inferior direito da tela, clique em Criar um webhook de saída:

![](/files/-MHHik2e5HiE1X3Fag_G)

5- Preencha um nome para seu Webhook, em URL de Retorno de Chamada, adicione a URL: <https://api.cosmobots.io/messages/v1/ms-teams/>(Aqui você coloca o id que copiou do seu bot), uma descrição  e clique em Criar:

![](/files/-MHHiolaTpzvCKxr_XrV)

{% hint style="info" %}
OBS#: Seguindo o exemplo anterior, a url de retorno ficaria:

<https://api.cosmobots.io/messages/v1/ms-teams/>9655sdasdjhskdajhdkjs7-545454
{% endhint %}

6- Após criar seu webhook, será gerada uma chave de segurança, copie essa chave:

![](/files/-MHHjor01QRXI8Bawh1m)

7- Volte na plataforma Cosmobots, dentro do bot que você quer realizar a integração, vá em Canais, Microsoft Teams e selecione a opção Team webhook:

![](/files/-MHHjvfVX1WVm9TXO_QJ)

8- Cole a chave que você copiou no Microsoft Teams e salve:

![](/files/-MHHk0GjtNaf8UnYy9hx)

## Testando

1-Para testar, dentro do canal em que você criou e habilitou o webhook, inicie uma conversa com @ citando o perfil que contenha a integração, selecione o nome do webhook que você criou seguido de uma palavra ou frase, por exemplo @Cosmonauta oi:

![](/files/-MHHk4oq-jD2t27ZAbD8)

2- Logo em seguida aparecerá a resposta do bot:

![](/files/-MHHkJvEKt9TL28ue4za)

{% hint style="warning" %}
OBS#: Toda vez que for responder o bot, é necessário que seja respondido com @+nome do webhook+ resposta, por exemplo @cosmonauta resposta.
{% endhint %}


---

# 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://help.cosmobots.io/help/bot-builder/canais/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.
