Microsoft Teams
A especificaĆ§Ć£o a seguir atua como um guia detalhado para utilizaĆ§Ć£o do broker Microsoft Teams, fornecendo todas as instruƧƵes e orientaƧƵes necessĆ”rias para sua configuraĆ§Ć£o.
Atualmente, o teams nĆ£o estĆ” suportando alguns tipos de arquivos. Imagens estĆ£o funcionando normalmente. Confira mais
ConfiguraĆ§Ć£o
Para realizar o cadastro do broker, Ć© imprescindĆvel fornecer o nome, identificador (ID), chave secreta (segredo) e locatĆ”rio (tenant).
Este manual estĆ” dividido em seƧƵes para facilitar a localizaĆ§Ć£o das informaƧƵes. As seƧƵes sĆ£o:
Criar BotCriar Bot š¹ Adquirir ConfiguraĆ§Ć£o š¹ Implantar BotImplantar Bot š¹ Importar e ExportarImportar e Exportar
Criar Bot
- Na barra lateral, clique no Ćcone de reticĆŖncias.
- No campo de pesquisa, digite Portal de Desenvolvimento e selecione-o na lista de opƧƵes.
- Usando o menu, aperte em Aplicativos > Novo aplicativo
- Insira o nome desejado para o seu aplicativo e clique em Adicione.
- No menu, selecione a opĆ§Ć£o InformaĆ§Ć£o bĆ”sica e preencha todos os campos obrigatĆ³rios conforme indicado nas imagens e, ao final, clique no botĆ£o Salvar.
- Selecione em Recurso do Aplicativo > Bot
- Aperte em Criar um novo bot
- Usando o menu, aperte em Novo bot
- Insira o nome desejado para o seu bot e clique em Adicione.
- Na seĆ§Ć£o Configurar, insira o ponto de extremidade desejado e clique em Salvar.
Os endpoints sĆ£o formados por: https://{dominio}/{caminho-teams-server}/webhook
- Volte para Aplicativos > {SeuBot} > Recursos do Aplicativo > Bot. Marque a opĆ§Ć£o Selecionar bot existente e escolha o bot que vocĆŖ criou na caixa de seleĆ§Ć£o. Depois, selecione Personal na aba de escolha de escopo e pressione Salvar.
Recomenda-se seguir as instruƧƵes das imagens acima, pois elas contĆŖm o exemplo utilizado pela equipe Citsmart Aura e funcionam de forma confiĆ”vel. OpƧƵes adicionais, como "team" ou "suporte para chamadas de vĆdeo", podem ajudar a personalizar a experiĆŖncia do bot para diferentes cenĆ”rios de uso no Teams, mas nĆ£o hĆ” garantia de que funcionarĆ£o corretamente apĆ³s a configuraĆ§Ć£o.
Adquirindo configuraĆ§Ć£o
- Na barra lateral, clique no Ćcone de reticĆŖncias.
- No campo de pesquisa, digite Portal de Desenvolvimento e selecione-o na lista de opƧƵes.
- Usando o menu, aperte em Ferramentas > Gerenciament de Bot
- Com isso, vocĆŖ poderĆ” localizar e anotar:
- 1: Nome do bot (Nome de exibiĆ§Ć£o)
- 2: Identificador (ID do aplicativo)
- Para encontrar o segredo, basta selecionar {Seu Bot} > Segredos do cliente e clicar em Adicionar um segredo do cliente....
O segredo fica disponĆvel apenas no momento da criaĆ§Ć£o. Portanto, caso sejam necessĆ”rias mĆŗltiplas configuraƧƵes, serĆ” preciso criar mais de um segredo ou anotĆ”-lo em um local seguro.
O locatƔrio do app Ʃ localizƔvel apenas dentro do Portal do Botframework
- Selecione o bot que vocĆŖ criou e, no menu, clique em Settings.
- Clique no botĆ£o Manage Microsoft App ID and password
- Localize o ID do locatƔrio
Com isso, Ć© possĆvel adquirir todos os campos necessĆ”rios para registrar dentro da plataforma:
- Nome do Chatbot > Nome de exibiĆ§Ć£o
- ID do App > ID do aplicativo (cliente)
- ID do LocatĆ”rio > ID do diretĆ³rio (locatĆ”rio)
- Segredo do App > Segredo
Implantar Bot
- Na barra lateral, clique no Ćcone de reticĆŖncias.
- No campo de pesquisa, digite Portal de Desenvolvimento e selecione-o na lista de opƧƵes.
- Usando o menu, aperte em Aplicativos > {Seu Aplicativo}
- Clique em AntevisĆ£o nas Teams e selecione adicionar.
Exportar e Importar Bots
Exportar
- Na barra lateral, clique no Ćcone de reticĆŖncias.
- No campo de pesquisa, digite Portal de Desenvolvimento e selecione-o na lista de opƧƵes.
- VĆ” para Aplicativos > {SeuBot} e clique em Publicar
- Selecione Baixar o pacote do aplicativo
Importar
- Na barra lateral, clique no Ćcone de reticĆŖncias.
- Clique em Obter mais aplicativos
- Selecione Gerenciar seus aplicativos
- Aperte em Carregar um aplicativo
- Escolha a opĆ§Ć£o de envio que melhor se adequa Ć sua necessidade e selecione o arquivo compactado (.zip).
Caso o envio tenha sido feito por "Enviar um aplicativo Ć sua organizaĆ§Ć£o", serĆ” necessĆ”rio que um administrador aceite o pedido. ApĆ³s isso, o aplicativo serĆ” adicionado Ć organizaĆ§Ć£o inteira. Caso o envio tenha sido feito por "Fazer o upload de um aplicativo personalizado", siga a imagem abaixo.
- Clique em Adicionar
