> For the complete documentation index, see [llms.txt](https://docs.altu.d1.cx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altu.d1.cx/connect/canais/microsoft-teams.md).
# 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.
#### 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)