# Microsoft Teams
O Teams é uma plataforma desenvolvida pela Microsoft com objetivo de unificar a experiência de comunicação e colaboração, utilizando ferramentas como sala de bate-papo, videoconferências, armazenamento de arquivos e integração de vários aplicativos no ambiente de trabalho.
Saiba como usar e implantar este novo canal no seu Assistente criado no Zenvia NLU!
{% hint style="info" %}
Esta integração é realizada em uma conta Microsoft vinculada à uma **organização no Teams**. Para que você possa acessar e interagir com o assistente integrado ao Teams basta solicitar ao administrador da organização a permissão necessária.
{% endhint %}
## **Configurações no Teams**
Para começar, acesse o [site oficial](https://www.microsoft.com/pt-br/microsoft-teams/log-in) do Teams e faça login com a sua conta Microsoft.
Certifique-se que está no perfil da **organização** e não em um **pessoal**, em seguida, adicione o aplicativo “**App Studio**” que está localizado nos ... da barra principal.
Feito isso, você precisará criar um aplicativo:
Em seguida, selecione a opção **create a new app** e siga com as etapas:
### **Details**
Comece preenchendo todos os campos obrigatórios (\*) e os opcionais que desejar, segue abaixo os obrigatórios:
* **App Names:**
* Short name: nome do aplicativo de no máximo 30 caracteres.
* **Identification:**
* App ID: clique no botão Generate para gerar um id do seu aplicativo.
* Package Name: crie uma url, conforme o exemplo:\
com.microsoft.teams.appcommunity
* Version: informe a versão do aplicativo, conforme o exemplo: 1.0.0
* **Descriptions:**
* Short description: crie uma descrição sucinta, de no máximo 80 caracteres, do que o aplicativo faz.
* Full description: crie uma explicação detalhada, de no máximo 4000 caracteres, sobre o aplicativo.
* **Developer information:**
* Developer/Company Name: informe o seu nome ou o da organização (empresa).
* Website: informe o site da organização.
* **App URLs**
* Privacy statement: informe o link da Política de Privacidade da empresa.
* Terms of use: informe o link dos Termos de Uso do aplicativo.
* **Branding:** O aplicativo deve incluir duas versões de ícone PNG: uma versão de cor e de contorno, para tal, siga as recomendações da Microsoft no link: [**https://docs.microsoft.com/pt-br/microsoftteams/platform/concepts/build-and-test/apps-package#app-icons.**](https://docs.microsoft.com/pt-br/microsoftteams/platform/concepts/build-and-test/apps-package#app-icons.)
### **Capabilities**
Selecione a seção “**Bots**” para definir os detalhes e a capacidade do aplicativo.
Clique no botão **set up** e, em seguida, abrirá uma tela para criar um **novo chatbot** ou, se já houver um, só clicar no **chatbot existente**.
{% hint style="info" %}
Seja criando um novo chatbot ou usando um existente, você deverá marcar apenas as opções **My bot supports uploading and downloading files,** da seção "Messaging Bot", e a opção **Personal**, da seção "Scopes".
{% endhint %}
Ainda na etapa “Bots”, você irá visualizar o **Bot Id**, gerado pela Microsoft. Em seguida, clique no botão “**Generate new password**” para gerar o **Bot password**. **Copie e guarde esta senha**, pois ela será exibida apenas uma vez.
{% hint style="info" %}
Se o botão “**Generate new password**” não aparecer, é só atualizar a página ou clicar na etapa “Tabs”, no menu lateral esquerdo, e depois voltar na etapa “Bots”.
{% endhint %}
## Integração com o Zenvia NLU
No Zenvia NLU clique em **Connect > Canais > MS Teams** e no botão ➕ para criar uma nova integração com os seguintes campos:
* **Nome:** nome da sua integração
* **Assistente:** o assistente que será vinculado à essa integração
* **Squad:** selecione o nome da squad desejada, caso não tenha uma específica disponível, deixe o padrão “geral”.
* **Bot id:** id obtido na etapa “Capabilities” da configuração no Teams
* **Bot password:** senha gerada na etapa “Capabilities” da configuração no Teams
* **Mensagens para mídias não suportadas:** mensagens que serão exibidas caso o usuário envie um tipo de mensagem não suportado
Depois de criar a integração, clique no ícone 
para editá-la e ter acesso à URL de Webhook, responsável por receber as mensagens dos usuários no aplicativo Teams. **Copie e guarde esta URL.**
**Post**:\
/teams/\/message
## Finalizando as configurações no Teams
Acesse novamente a sua conta Teams e vá para a seção **Capabilities > Bots**. Em seguida, cole a URL de Webhook no campo Bot endpoint address:
Depois de inserir e validar a URL, vamos para a última etapa.
### Finish
#### Language:
Nos campos “Select a language” e “Select a region” configure ou altere os idiomas que o aplicativo suporta.
.png?alt=media\&token=35a5ca6c-42c7-42a5-8446-0508770d6ecb)
#### Test and distribute:
Por fim, chegou a hora de **publicar**, fazer o **download** ou **instalar** o aplicativo e exibi-lo à sua equipe ou colega(s)!
Para saber mais acesse:\
[**https://docs.microsoft.com/pt-br/microsoftteams/platform/concepts/deploy-and-publish/apps-publish-overview**](https://docs.microsoft.com/pt-br/microsoftteams/platform/concepts/deploy-and-publish/apps-publish-overview)
---
# 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.altu.d1.cx/connect/canais/microsoft-teams.md?ask=
```
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.