# 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.

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcIOpR_tzpuOGt9SF6%2F-MkcJYTS8KOcl0X1z6r5%2Fgif_adicionar_app_studio.gif?alt=media\&token=fd75c8db-ce2f-43d3-ac83-61b523aa356d)

Feito isso, você precisará criar um aplicativo:

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcIOpR_tzpuOGt9SF6%2F-MkcKO3QAb84nC8gLBpT%2Fapp_studio.png?alt=media\&token=4a69c0cd-76e3-48ae-95c3-8dc57f8faac1)

Em seguida, selecione a opção **create a new app** e siga com as etapas: &#x20;

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcIOpR_tzpuOGt9SF6%2F-MkcL15nRizH2Nkk2KEN%2Fcreate_app.PNG?alt=media\&token=e9539187-76a2-42c2-9bd9-484540567cd7)

### **Details**

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcIOpR_tzpuOGt9SF6%2F-MkcLBuIsmZQNGrLt7tM%2FDetails_App.png?alt=media\&token=37859aee-6f8f-42de-9e0c-171d0d1b9a20)

Comece preenchendo todos os campos obrigatórios (\*) e os opcionais que desejar, segue abaixo os obrigatórios:

* **App Names:**&#x20;
  * 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.&#x20;
  * 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&#x20;
* **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.

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcMo2sTO0sWS1h5XhB%2F-MkcNJ82ZUmj268oiqL1%2FCapabilities_Bots_BotIDandPassword.png?alt=media\&token=506b828a-a881-4ec3-ade1-b598ceee96fa)

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**.

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcMo2sTO0sWS1h5XhB%2F-MkcNRgmBW9EcMfbKFOr%2Ftela_capabilities.png?alt=media\&token=7a714e5c-1fff-4cfe-9f4f-42411960c5d4)

{% 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.

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcMo2sTO0sWS1h5XhB%2F-MkcNtfZdl2LMT-QGdrr%2FCapabilities_Bots_BotIDandPassword-Idtampado.png?alt=media\&token=6f7451a4-d447-4339-a945-39889eea8246)

{% 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:

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcO1ithUvM0o6knvEu%2F-MkcOFpMImanWNhbfvTz%2FImagem%20Integra%C3%A7%C3%A3o%20MS%20Teams.PNG?alt=media\&token=b06663ed-4e25-4ce4-a60a-e7550abe435e)

* **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 <img src="https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcO1ithUvM0o6knvEu%2F-MkcOZRG5qCJgxtj14YK%2Ficone%20editar%20a%20integra%C3%A7%C3%A3o%20TEams.png?alt=media&#x26;token=cb231206-4d4b-48cc-8298-2e592651ca91" alt="" data-size="line"> 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**:\
<https://connector.ms.altubots.com/\\><slug>/teams/\<id da integração gerado pelo altu>/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:

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcO1ithUvM0o6knvEu%2F-MkcPZutoCz12owWkj65%2Fcampo%20Messaging%20endpoint.png?alt=media\&token=bacd1dac-01a4-48bf-85e6-add9d3d4b6db)

Depois de inserir e validar a URL, vamos para a última etapa.

### Finish

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcO1ithUvM0o6knvEu%2F-MkcPuVMI4h4dOG09pJH%2Ffinish_correto.png?alt=media\&token=71f80248-99df-4718-a6ba-2869b7a4653b)

#### Language:

Nos campos “Select a language” e “Select a region” configure ou altere os idiomas que o aplicativo suporta.

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkcO1ithUvM0o6knvEu%2F-MkcQ7jyDU_7F2OqOo2s%2FFinish_Languages1%20\(1\).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)<br>
