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!

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.

Configurações no Teams

Para começar, acesse o site oficial 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.

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.

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

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.

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

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: https://connector.ms.altubots.com/<slug>/teams/<id da integração gerado pelo altu>/message