Criar um canal do Microsoft Teams
Atualizado
por Michelli Silva
Criação de aplicativo na Azure
- Para criar seu aplicativo do tipo bot, vá em https://portal.azure.com/ você precisará criar uma conta, caso não possua.
- Após logar em sua conta, procure na caixa de pesquisa por Azure Bot.
- Selecione Azure Bot, como na imagem abaixo.
- Selecione Criar.
- Insira o nome identificador para o bot no campo de identificação (sem espaços).
- Selecione sua assinatura na lista, por padrão já parecerá uma assinatura criada.
- Selecione seu grupo de recursos ou crie um novo.
- Caso queira criar um grupo de recursos, selecione Criar novo, insira o nome do recurso, selecione OK e selecione o local necessário na lista suspensa Novo local do grupo de recurso.
- Selecione o tipo de aplicativo, recomendamos o multilocatário. Após isto, selecione Examinar + criar.
- Selecione Criar, se a validação for aprovada. Leva alguns momentos para que seu serviço de bot seja provisionado.
- Selecione Ir para o recurso. Pronto seu aplicativo está criado!
Para criar o segredo do cliente
- Em configurações, selecione Configuração. Salve a ID do aplicativo da Microsoft (ID do cliente) para referência futura.
- Selecione Gerenciar senha ao lado da ID do Aplicativo Microsoft.
- Na seção Segredos do cliente, selecione Novo segredo do cliente. A janela Adicionar um segredo de cliente é exibida.
- Insira uma Descrição e um período para a expiração do segredo e selecione Adicionar.
- Selecione Copiar para a área de transferência na coluna Valor e salve a ID do segredo do cliente para referência futura.
- É necessário que busque mais um dado que precisará para a criação do canal na Plataforma Weni, para isto, volte a Home e selecione seu bot. Após isso selecione JSON View (Exibição Json). Abrirá um json com algumas informações sobre seu aplicativo, procure por tenant id e guarde o valor.
Para adicionar o canal do Microsoft Teams
- Na home, abra seu bot.
- Selecione Canais no painel esquerdo e selecione Microsoft Teams
na lista de canais disponíveis.
Como configurar seu perfil do bot e adicionar canal
- Na home, abra seu bot.
- Se desejar poderá configurar o perfil do bot, para isto, no seu bot vá em Perfil do bot no menu na esquerda e configure-o como desejar. Você poderá adicionar fotos de perfil e outras informações.
obs: Inserir o nome de exibição do bot, que irá ser o bot name.
- Depois de salvar o perfil do bot, selecione a opção Canais no painel esquerdo e selecione Microsoft Teams na lista de canais disponíveis.
- Marque a caixa de seleção para aceitar os termos de serviços e selecione Concordo.
- Selecione Salvar.
Criação de Canal na Plataforma Weni
- Após logar na plataforma, escolher sua organização e projeto, vá em Integrações e selecione outras aplicações.
- Selecione Adicionar Canal.
- Na lista de canais selecione Teams.
- Para conectar um canal você precisará das informações sobre o aplicativo que criou anteriormente (Bot name, Bot id, App id, App password e Tenant id)
- Coloque o nome que deu ao seu bot na criação do aplicativo no campo Bot name.
- Em Bot id coloque o bot name.
- Em App id insira o ID do Aplicativo novamente.
- Em App password insira o Segredo do cliente que criou anteriormente.
- Em Tenant id insira o valor de tenant id que gaurdou anteriormente.
- Agora clique em Enviar.
- Pronto, seu canal foi criado!
- Na página de canal que você será enviado logo após clicar em Enviar, terá o ID desse canal, precisaremos desse valor. Para pegá-lo você pode copiar o ID enorme que terá no final da url dessa página. Após o read/ copie todo esse id formado por números, letras e traços. Guarde-o.
Configurar ponto de extremidade no aplicativo
- Volte na Azure, em Home selecione seu bot no Recursos Recentes, após isto vá em Configurações no menu esquerdo.
- Em **Ponto de extremidade **adicione a url abaixo, em [ID DO CANAL] adicione o ID que guardou no passo anterior.
- https://new.push.al/c/tm/[ID DO CANAL]/receive
- Ex: https://new.push.al/c/tm/37b755f9-2d97-48fd-8c46-6f0f4d102d16/receive
Configurar bot no Teams
- Canto inferior esquerdo selecione Aplicativos.
- Use a barra de pesquisa na esquerda e busque por App Studio
. Selecione-o e instale, após isto clique em abrir. - Selecione Criar um novo App.
- Em Detalhes do App, insira todos os dados que você já possui como nome.
- Em Identificação insira o App ID, em Nome do pacote coloque um nome que referencie seu app ex: com.microsoft.teams.devapp
- Em versão, utilize algo como v1.0.0
- Em Descrição coloque a descrição para seu aplicativo, informe o que ele faz e para quem faz por exemplo.
- Em Informações de Desenvolvedor insira dados da sua empresa, como nome e site.
- Em App URLs insira a url de termos de privacidade da sua empresa e em termos de uso insira a url dos seus termos.
- Em Branding você atualiza as imagens de perfis que deseja que seu bot possua, clique em atualizar e escolha suas imagens.
- No passo 2 em Capabilities você poderá configurar algumas especificações para seu bot, não é necessário pára que seu bot funcione em conjunto com nossa plataforma, então pularemos esta etapa.
- Agora no passo 3 do menu a esquerda clique em Domains and Permissions.
- Em Domínios Válidos insira o domínio de nossa plataforma para que seu bot consiga se integrar com a gente (https://new.push.al) e clique em Add.
- Em AAD App ID insira seu Tenant ID que guardou anteriormente.
- Agora o ultimo passo, clique em Testar e Distribuir no passo 3 do menu esquerdo.
- Você poderá publicar o seu bot no catálogo da sua organização, com isto todos que participam de sua organização poderão adicionar seu bot e assim poder trocar mensagens com ele. Para isto clique em Publicar app no catálogo de minha organização e clique em Enviar.
Importante: para que seu app seja publicado no catálogo da sua organização, ele terá de ser aceito pelo administrador de TI da sua organização. Após aceito seu bot ficará disponível para instalação no catálogo de sua empresa para todos os colaboradores que fazem parte.
