Como usar o App Connect com o Microsoft Teams

Versões de produtos e APIs compatíveis

Para saber quais versões de produto e API são compatíveis com esse conector, consulte Requisitos detalhados do sistema na página de suporte IBM.

Conectando-se a Microsoft Teams

• Se você não tem uma conta no Microsoft Teams, pode se cadastrar gratuitamente em Microsoft Teams.

Para conectar o App Connect a uma conta do Microsoft Teams, consulte “Conectando-se ao Microsoft Teams a partir do App Connect ”.

Considerações gerais sobre o uso do ` Microsoft Teams ` no ` App Connect `

• (Consideração geral) Você pode ver listas dos eventos e ações de acionamento disponíveis na página Aplicativos e APIs do App Connect Designer.

  Para alguns aplicativos, os eventos e as ações dependem do ambiente e do fato de o conector oferecer suporte a eventos configuráveis e descoberta dinâmica de ações. Se o aplicativo for compatível com eventos configuráveis, você verá um link Mostrar mais eventos configuráveis abaixo da lista de eventos. Se o aplicativo suportar a descoberta dinâmica de ações, você verá um link Mostrar mais na lista de ações.

• (Consideração geral) Se estiver usando várias contas para um aplicativo, o conjunto de campos que é exibido quando você seleciona uma ação para esse aplicativo pode variar para diferentes contas. No editor de fluxo, alguns aplicativos sempre fornecem um conjunto selecionado de campos estáticos para uma ação. Outros aplicativos usam a descoberta dinâmica para recuperar o conjunto de campos que estão configurados na instância à qual você está conectado. Por exemplo, se você tiver duas contas para duas instâncias de um aplicativo, a primeira conta poderá usar configurações que estejam prontas para uso imediato. No entanto, a segunda conta pode ser configurada com campos personalizados adicionais.
• Microsoft Azure Active Directory os grupos são normalmente criados no centro de administração Microsoft 365 ou no portal Microsoft Azure. Se você tiver as permissões necessárias, poderá usar a ação "Create group" (Criar grupo) em App Connect para criar grupos Microsoft 365 ou grupos de segurança.
• Se você estiver usando uma conta de usuário sem privilégios de administrador para se conectar a Microsoft Teams, poderá usar App Connect para atualizar ou excluir grupos somente se for o proprietário desse grupo.
• Ao usar a ação Criar mensagem de bate-papo ou Recuperar mensagens de bate-papo para criar ou recuperar mensagens de bate-papo no App Connect, você deve primeiro selecionar um bate-papo existente na lista.
  
  • Para conversas individuais com outro usuário cujo nome esteja especificado no campo “Para” em Microsoft Teams, o ID da conversa é exibido na lista de conversas do 19:50144721-4f5b-4765-9b65-fd554a36c65c_8372f761-5d10-4888-ef47-5be0b7315e72@unq.gbl.spacesApp Connect no formato.
  • No caso de conversas em grupo (nas quais o assunto da conversa aparece no campo “Nome do grupo ” e vários nomes de usuário no campo “Para” no Microsoft Teams ), o valor do “Nome do grupo” (assunto) é exibido na lista de conversas do App Connect, facilitando a identificação da conversa.

  Se você pretende usar as ações “Criar mensagem de chat” ou “Recuperar mensagens de chat” com frequência, considere criar seus chats com um valor de “Nome do grupo ” (assunto) em Microsoft Teams.

• Ao usar a ação Criar resposta à mensagem ou Recuperar respostas à mensagem para criar ou recuperar respostas à mensagem no App Connect, você deve primeiro selecionar uma equipe, um canal e uma mensagem para a resposta. Na lista de mensagens, as mensagens criadas com um assunto exibem o valor do assunto, enquanto as mensagens sem assunto exibem um ID gerado pelo Microsoft Teams.
  

  Se necessário, você pode verificar qual ID está atribuída a uma mensagem no Microsoft Teams abrindo o menu “Mais opções ” (... ) de uma mensagem e clicando em “Copiar link ”. A ID da mensagem é incluída no link; por exemplo:

  https://teams.microsoft.com/l/message/19:a954b78415a547a7438c354c54b40f30@thread.tacv2/1595593605014?tenantId=0184ab77-1234-4ac0-5678-bf7eec6de925&groupId=e1c2515c-4512-471e-a772-60ce5ba78921&parentMessageId=1595593605014&teamName=FDteam&channelName=General&createdTime=1595593605014

  

  Se você pretende usar com frequência as ações “Criar resposta à mensagem” ou “Recuperar respostas à mensagem”, considere criar respostas à mensagem com um assunto no “ Microsoft Teams ”.

  
• Quando você usa a ação Criar mensagem de bate-papo, Criar mensagem ou Criar resposta de mensagem para criar uma mensagem ou responder em App Connect, pode adicionar um anexo à mensagem especificando um tipo de conteúdo e o conteúdo associado. Atualmente, apenas anexos de cartões avançados são compatíveis. Você pode usar o campo Content type (Tipo de conteúdo ) para selecionar um formato de cartão e, em seguida, usar o campo Content (Conteúdo ) para especificar um objeto rich card que define o formato JSON do cartão. Os anexos de cartão suportados são os seguintes.

  Tipo de conteúdo	Descrição	Conteúdo
  application/vnd.microsoft.card.adaptive	Um cartão adaptável que pode conter texto, fala, imagens, botões e campos de entrada.	Especifique um objeto AdaptiveCard.
  application/vnd.microsoft.card.hero	Um cartão Hero que pode conter uma imagem grande, um ou mais botões e algum texto.	Especifique um objeto HeroCard.
  application/vnd.microsoft.card.thumbnail	Um cartão de miniatura que pode conter uma imagem em miniatura, um ou mais botões e algum texto.	Especifique um objeto ThumbnailCard.
  application/vnd.microsoft.com.card.receipt	Um cartão de recibo que fornece um recibo.	Especifique um objeto ReceiptCard. Restrições: Atualmente, esse cartão fornece saída parcial.
  application/vnd.microsoft.com.card.signin	Um cartão de login que solicita que um usuário faça login.	Especifique um objeto SignInCard.

  Para obter mais informações sobre esses anexos de cartão, consulte Referência de cartões na documentação da Microsoft.

  Os exemplos a seguir fornecem exemplos de JSON para cada tipo de conteúdo.

  Cartão adaptável:

  json
  
  {
      "type": "AdaptiveCard",
      "body": [
          {
              "type": "TextBlock",
              "size": "Medium",
              "weight": "Bolder",
              "text": "Profile Info"
          },
          {
              "type": "FactSet",
              "facts": [
                  {
                      "title": "Given name",
                      "value": "John"
                  },
                  {
                      "title": "Surname",
                      "value": "Doe"
                  },
                  {
                      "title": "Job title",
                      "value": "Software Dev"
                  },
                  {
                      "title": "Office location",
                      "value": "NYC"
                  },
                  {
                      "title": "Email",
                      "value": "john@doe.com"
                  }
              ]
          },
          {
              "type": "TextBlock",
              "text": "Business phones",
              "weight": "Bolder"
          },
          {
              "type": "TextBlock",
              "text": "{$data}",
              "$data": "{businessPhones}",
              "spacing": "None"
          }
      ],
      "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
      "version": "1.0"
  }

  Carta de herói:

  json
  {
       "title": "Seattle Center Monorail",
       "subtitle": "Seattle Center Monorail",
       "text": "The Seattle Center Monorail is an elevated train line between Seattle Center (near the Space Needle) and downtown Seattle. It was built for the 1962 World's Fair. Its original two trains, completed in 1961, are still in service.",
       "images": [
         {
           "url":"https://upload.wikimedia.org/wikipedia/commons/thumb/4/49/Seattle_monorail01_2008-02-25.jpg/1024px-Seattle_monorail01_2008-02-25.jpg"
         }
       ],
      "buttons": [
        {
           "type": "openUrl",
           "title": "Official website",
           "value": "https://www.seattlemonorail.com"
         },
        {
          "type": "openUrl",
          "title": "Wikipeda page",
          "value": "https://en.wikipedia.org/wiki/Seattle_Center_Monorail"
         }
       ]
     }

  Cartão de miniatura:

  json
  {
      "title": "Bender",
      "subtitle": "tale of a robot who dared to love",
      "text": "Bender Bending Rodríguez is a main character in the animated television series Futurama. He was created by series creators Matt Groening and David X. Cohen, and is voiced by John DiMaggio",
      "images": [
        {
          "url": "https://upload.wikimedia.org/wikipedia/en/a/a6/Bender_Rodriguez.png",
          "alt": "Bender Rodríguez"
        }
      ],
      "buttons": [
        {
          "type": "imBack",
          "title": "Thumbs Up",
          "image": "http://moopz.com/assets_c/2012/06/emoji-thumbs-up-150-thumb-autox125-140616.jpg",
          "value": "I like it"
        },
        {
          "type": "imBack",
          "title": "Thumbs Down",
          "image": "http://yourfaceisstupid.com/wp-content/uploads/2014/08/thumbs-down.png",
          "value": "I don't like it"
        },
        {
          "type": "openUrl",
          "title": "I feel lucky",
          "image": "http://thumb9.shutterstock.com/photos/thumb_large/683806/148441982.jpg",
          "value": "https://www.bing.com/images/search?q=bender&qpvt=bender&qpvt=bender&qpvt=bender&FORM=IGRE"
        }
      ],
      "tap": {
        "type": "imBack",
        "value": "Tapped it!"
      }
    }

  Cartão de recibo (parcial):

  json
  {
          "title": "I'm a receipt card",
          "items": [
            {
              "title": "Sushi",
              "subtitle": "2 piece",
              "image": {
                "url": "https://mydeploy.azurewebsites.net/sushi.png"
              },
              "price": "16.25",
              "quantity": "1"
            },
            {
              "title": "Tenpura",
              "subtitle": "1 dish",
              "image": {
                "url": "https://mydeploy.azurewebsites.net/tenpura.jpg"
              },
              "price": "34.50",
              "quantity": "2"
            }
          ],
          "total": "275.25",
          "tax": "27.52",
          "buttons": [
            {
              "type": "openUrl",
              "title": "Go to my site",
              "value": "https://blogs.msdn.microsoft.com/tsmatsuz"
            }
          ]
        }

  Cartão de login:

  json
  {
      "buttons": [
          {
              "title": "Log In",
              "type": "openUrl",
              "value": "https://login.microsoftonline.com"
          }
      ],
      "text": "Sign in to our app"
  }

Considerações sobre a pós-conexão

Observe o seguinte depois de acessar o site Microsoft Teams :

Pré-requisitos para o download de conteúdo de gravação e transcrição de chamadas

Para utilizar as ações “Baixar gravação da chamada” e “Baixar transcrição da chamada”, é necessário agendar a reunião como um evento no calendário do Microsoft Teams. Para agendar a reunião como um evento no calendário do Microsoft Teams, na ação “Criar evento ”, você precisa definir “É uma reunião online ” como True.

Eventos e ações

Microsoft Teams eventos

Esses eventos são para alterações nesse aplicativo que acionam um fluxo para começar a concluir as ações no fluxo.

Seu fluxo conclui essas ações nesse aplicativo.