Pular para o conteúdo principal

Como publicar seu bot no Microsoft Teams

Help Center
  • Atualizado
Antes de incluir as configurações avançadas, publique o bot!

Índice:

  1. Integração, configuração e construção do bot no MS Teams

  2. Utilizando o Developer Portal

 

Integração, configuração e construção do bot no MS Teams: 

1- Execute o MS Teams em sua área de trabalho ou pelo web app (https://teams.microsoft.com);

1.webp

 

2- Execute o aplicativo App Studio na barra esquerda. 

2.webp

 

5.webp

 

 

3- Clique em "Create new app"  

3.webp

 

4- Preencha os campos abaixo com as informações do bot:

4.webp

 

Nota importante: No campo Identification, é necessário clicar no botão "Generate" para que seja gerado um App ID aleatório. Este App ID é extremamente importante para a configuração de nossos bots e será gerado de forma completamente aleatória.

Segue abaixo os campos obrigatórios e os valores utilizados: 

Package name: com.microsoft.teams.app

Version: 1.0.1 (deve ser obrigatoriamente preenchido neste formato com 3 algarismos acompanhados de pontos.

Exemplo: 0.0.1 . Caso o bot for sofrer alguma alteração, é importante atualizar o número desta versão. Fica a critério do criador quais números irá utilizar)

Note: Preencha os campos de acordo com as informações da sua empresa.

 

5- Feito isso, no menu lateral esquerdo, selecione a opção Bots e clique em Set up.

Observação: Não marcar a opção "My bot is a one-way notification only bot"
mceclip0.png

  • Preencha os campos obrigatórios e salve a senha gerada, ela será necessária para integração com o Blip.

  • Homologação: o endpoint do bot deve ser https://hmg-abs.gw.msging.net/ [ID EXTERNO DA CONTA]

  • Produção: o endpoint do bot deve ser https://abs.gw.msging.net/ [ID EXTERNO DA CONTA]

  • Configure o escopo conforme necessário. Marcar todas as opções fará com que o bot se torne um contato humano nas equipes.

    image.png

    Conecte o bot que foi criado no Microsoft Teams com Blip.

  • É necessário adicionar alguns parâmetros na configuração avançada no Blip:

💡 O domínio deve ser postmaster@abs.gw.msging.net

  • AccountExternalId: identificador externo do bot. Encontre no menu de detalhes do aplicativo.

  • ApplicationId: id de comunicação do bot. Encontre no menu Bots.

  • ApplicationPassword: senha gerada na criação do bot.

  • AudioSentence: é a frase que aparecerá quando o usuário receber um áudio enviado por Blip.

  • DocumentSentence: é a frase que aparecerá quando o usuário receber um documento enviado por Blip.

  • GifSentence: é a frase que aparecerá quando o usuário receber um gif enviado por Blip.

  • VideoSentence: é a frase que aparecerá quando o usuário receber um vídeo enviado por Blip.

  • WeblinkSentence: é a frase que aparecerá quando o usuário receber um link enviado por Blip.

  • TextButton: é a frase que aparecerá no botão quando o usuário receber alguma mídia enviada por Blip.

 

4. Baixe o bot criado no menu: Concluir> Testar e distribuir.

5. Importe o arquivo baixado. A imagem abaixo mostra onde está a opção.

 

Utilizando o Developer Portal

Acessar o link https://dev.teams.microsoft.com/home.

 

1 - Criar um App

mceclip0.png

2- Incluir as informações básicas.

 

O App ID que aparece na print, deve ser considerado como AccountExternalId.

mceclip1.png

3- Ao selecionar App features, criar um bot para a aplicação.

mceclip2.png

4- Após escolher um nome, colocar o endpoint:

https://abs.gw.msging.net/INCLUIR AQUI O AccountExternalId

5- Clique em Client Secrets. Ao gerar o segredo, guarde ele e considere como o ApplicationPassword.

mceclip3.png

6- Após a criação, copie o número gerado e considere-o como ApplicationId.

mceclip4.png


7- Após esses passos, volte na seleção de Aplicativos, selecione o seu App e volte para o menu App Features. Clique em Bot novamente e selecione a aplicação que acabou de criar.

 

Selecione a opção Upload and download files.

mceclip5.png


8- Após salvar, continue em App features e adicione o Group and channel app.

A URL deve ser a mesma que foi incluída no passo 4.

mceclip6.png

9- Após salvar, continue em App features e adicione Message and Extension.

 

Selecione o mesmo bot que foi criado e salve.

mceclip7.png

10 - Foto demonstrativa após os passos realizados.

mceclip8.png

11- Clique em Publish to Store. Verifique se está tudo OK e Baixe seu pacote.

mceclip9.png

12 - Importe o arquivo baixado. A imagem abaixo mostra onde está a opção.

mceclip10.png

Obs: Lembre-se que o AccountExternalId (passo 2), ApplicationId (Passo 6) e ApplicationPassword (passo 5) são os de referência descritos acima.

 

  • Conecte o bot que foi criado no Microsoft Teams com Blip.
  • É necessário adicionar alguns parâmetros na configuração avançada no Blip:

💡 O domínio deve ser postmaster@abs.gw.msging.net 

  • AccountExternalId: identificador externo do bot. (passo 2)

mceclip12.png

  • ApplicationId: ID de comunicação do bot. (passo 6)

mceclip13.png

  • ApplicationPassword: senha gerada na criação do bot. (passo 5)
  • AudioSentence: é a frase que aparecerá quando o usuário receber um áudio enviado por Blip.
  • DocumentSentence: é a frase que aparecerá quando o usuário receber um documento enviado por Blip.
  • GifSentence: é a frase que aparecerá quando o usuário receber um gif enviado por Blip.
  • VideoSentence: é a frase que aparecerá quando o usuário receber um vídeo enviado por Blip.
  • WeblinkSentence: é a frase que aparecerá quando o usuário receber um link enviado por Blip.
  • TextButton: é a frase que aparecerá no botão quando o usuário receber alguma mídia enviada por Blip.

mceclip14.png

Elementos Suportados

Os elementos abaixo se comportam da mesma forma no Blip:

  • Texto;
  • Emoção;
  • Imagem;
  • Composição;
  • Carrossel.
  • Se você quiser usar carga útil, apenas application / json é aceito.
  • Se você não quiser usar carga útil, escolha o link da web ou apenas o título do texto.
  • O carrossel suporta 10 cartões por mensagem.
  • Cardápio.
  • O menu não posiciona seus botões verticalmente. O Microsoft Teams preenche todo o espaço horizontal para quebrar a linha.
  • Se você quiser usar carga útil, apenas application / json é aceito.
  • Se você não quiser usar carga útil, escolha o link da web ou apenas o título do texto.

Elementos não suportados

Os elementos abaixo não são suportados:

  • Localização

 

Elementos Adaptados

Os elementos abaixo não são suportados nativamente. Uma adaptação foi necessária para uma melhor experiência do usuário:

  • Vídeo;
  • Áudio;
  • Documento;
  • Resposta rápida;
  • Link da web.

Esses elementos serão enviados no mesmo modelo abaixo:

  • 1ª Obs.: o botão abre o conteúdo da mídia enviado.
  • 2ª Obs.: A frase que vai mostrar será a mesma configurada no Blip.

mceclip15.png

A resposta rápida comporta-se igual ao menu, onde as opções não se escondem após a escolha do usuário.

mceclip16.png

 

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃

Artigos relacionados

Powered by Zendesk