Visão geral dos cartões adaptáveis para o Microsoft Teams
Os cartões adaptáveis são um método independente de plataforma para compartilhamento e exibição de blocos de informações sem a complexidade da personalização de CSS ou HTML para renderização. Você cria cartões adaptáveis do autor no formato JSON com integrações que aplicativos e serviços em nuvem podem trocar abertamente. Quando entregue a um host específico, como o Microsoft Teams, o arquivo JSON é transformado na interface do usuário nativa, que se adapta automaticamente ao host. Portanto, os designers de processo agora poderão oferecer padrões consistentes de interface do usuário sempre que precisarem exibir informações como parte de um processo de negócios/automação.
Como os cartões adaptáveis se adaptam ao host, eles são veículos perfeitos para compartilhar informações entre o Microsoft Teams e outros serviços.
Ações atualmente disponíveis para fluxos
As ações a seguir permitem que os criadores criem cartões adaptáveis para o Microsoft Teams. Conforme os cenários de integração evoluírem, outros hosts também terão suporte do Power Automate, o que ampliará suas oportunidades de aproveitar os cartões adaptáveis em todas as assinaturas de nuvem da Microsoft.
Observação
Os cartões adaptáveis não estão disponíveis no ambiente DoD (Departamento de Defesa).
Como direcionar conteúdo para membros do Teams ou usuários do Microsoft Entra
Postar seu próprio cartão adaptável como o bot do Flow para um usuário
Esta ação posta um cartão adaptável como um bot do fluxo para um usuário específico. Nesse caso, você precisa fornecer um endereço de email do destinatário. Em seguida, o cartão aparece no chat e/ou nos feeds de atividades do destinatário durante a execução do fluxo. Não é necessário que o usuário faça parte de uma instância do Teams para receber esses tipos de cartões adaptáveis. Neste caso, somente os botões da URL funcionam, com o redirecionamento para a URL configurada no fluxo.
Postar um cartão adaptável como o bot do Flow para um usuário do Teams e aguardar uma resposta
Esta ação publica um cartão adaptável como um bot do Flow para um usuário específico, como o caso apresentado anteriormente neste artigo. No entanto, neste caso, a execução de fluxo não continuará após a postagem até que o destinatário responda às entradas necessárias no cartão. O fluxo é retomado após o destinatário responder. O fluxo retorna conteúdo dinâmico para uma (1) resposta por destinatário e por cartão.
Direcionar conteúdo para Canais do Teams
Postar seu próprio cartão adaptável como o bot do fluxo em um canal
Esta ação posta um cartão adaptável como um bot do fluxo em um canal específico do Teams. Nesse caso, você será solicitado a fornecer uma instância do Teams e um canal em que o cartão será postado. O criador do fluxo tem acesso à instância do Teams para postar um cartão adaptável lá. Nesse caso, somente os botões da URL funcionam, com o redirecionamento para a URL configurada dentro do fluxo.Postar um cartão adaptável como o bot do fluxo em um canal do Teams e aguardar uma resposta
Esta ação publica um cartão adaptável como um bot do fluxo em um canal específico do Teams, como no caso acima. Neste caso, o fluxo não continuará até que alguém no canal responda a quaisquer entradas necessárias no cartão. O fluxo continua assim que alguém no canal do Teams responder, mas retornará apenas conteúdo dinâmico para uma (1) resposta por respondente e por cartão. Quando você usa esse cartão, o fluxo aguarda uma resposta de qualquer membro do Teams.
Problemas conhecidos
Não é possível coletar dados de cartões adaptáveis, a menos que eles sejam criados usando uma das ações aguardar uma resposta. Cartões adaptáveis que não aguardam, retornam um erro para todas as ações de botão, exceto OpenURL. Saiba mais sobre os botões OpenURL.
Selecionar os botões Action.Submit em um cartão que não inclui o sufixo aguardar uma resposta gera um erro.
Cartões adaptáveis criados usando a ação aguardar uma resposta pode ser enviado apenas uma vez. A execução de fluxo continua após a primeira resposta, e quaisquer outros envios serão ignorados.
Somente as informações na caixa de entrada Atualizar mensagem são mostradas no cartão de substituição depois que os consumidores enviarem o cartão.
Detalhes adicionais, como da ID do usuário da pessoa que enviou o cartão, estarão disponíveis no conteúdo dinâmico em ações posteriores a aguardar uma resposta. No entanto, pode ser necessário incluir o conector de Usuários do Office 365 para concluir as informações de perfil desejadas para o usuário que enviou o cartão.
Depois que os cartões adaptáveis com a ação aguardar uma resposta são enviados, o cartão é redefinido e exibido exatamente igual, a menos que a área de mensagem de substituição/atualização esteja configurada. As mensagens de atualização são uma melhor prática. Elas são recomendadas para atualizar outras e impedir que os consumidores tentem enviar o cartão mais de uma vez.
As entradas Mensagem de Atualização e O cartão deve ser atualizado precisam ser configuradas caso você queira usar um cartão de substituição.
- O Power Automate usa os recursos e serviços exclusivos dos cartões adaptáveis da Microsoft para lidar com os cartões em qualquer host. Este artigo tem como objetivo esclarecer detalhes relacionados a ações de fluxo. Você também pode conferir a documentação completa para saber como criar cartões adaptáveis.