Compartilhar via

Enviar mensagens proativas do Microsoft Teams

Depois de publicar seu agent e disponibilizar o agente aos usuários no Microsoft Teams, você poderá notificar os usuários (" destinatários") no Microsoft Teams com mensagens proativas. As mensagens proativas usam fluxos do Power Automate para entregar seu conteúdo e são úteis em vários cenários, incluindo:

  • Informar ao destinatário que sua solicitação anterior foi concluída. Por exemplo, a solicitação de folga do usuário foi aprovada.
  • Fornecer lembretes ou atualizações de notícias. Por exemplo, o agente pode enviar uma mensagem de lembrete para concluir o treinamento online.

Importante

As mensagens proativas podem ser configuradas para os agentes e chatbots clássicos criados e personalizados no Copilot Studio.

Um agente não pode entregar mensagens se o destinatário:

  • Não tiver o agente instalado no Microsoft Teams.
  • Desinstalou o agente.
  • Bloqueou o agente.
  • Não tem permissão para conversar com o agente; nesse caso, você deverá compartilhar o agente com outros usuários.

Pré-requisitos

Limitações conhecidas

  • Se o agente for desconectado e reconectado ao Microsoft Teams, os usuários não receberão mensagens proativas até que reinstalem o agente.
  • Todas as mensagens proativas do Copilot Studio estão sujeitas a limites no Power Automate e a limitações do conector do Microsoft Teams.
  • As mensagens proativas não são registradas nas transcrições de conversa ou nas Sessões de análise.
  • As mensagens proativas devem estar no mesmo ambiente do fluxo do Power Automate.
  • As mensagens proativas só podem ser postadas em um chat pessoal com o agente.

Enviar uma mensagem proativa

  1. No Power Automate, abra o fluxo para o qual deseja enviar uma mensagem proativa.

  2. Adicione a ação do conector do Microsoft Teams Postar mensagem em um chat ou canal.

  3. Para Postar como, escolha Power Virtual Agents (Versão Preliminar).

  4. Para Postar em, escolha Chat com bot.

  5. Em Bot, selecione o agente do qual você deseja que a mensagem seja enviada.

  6. Para Destinatário, insira o nome ou endereço de email do destinatário. Você também pode usar conteúdo dinâmico se as informações do destinatário vierem de uma etapa anterior do fluxo.

  7. Para Mensagem, digite a mensagem que deseja enviar.

    Ação de postar mensagem no Power Automate.

Quando o fluxo é executado, o destinatário receberá a mensagem proativa do agente no Microsoft Teams.

Enviar um Cartão Adaptável proativo

Importante

Esta seção detalha como enviar Cartões Adaptáveis proativos com os fluxos do Power Automate. Os Cartões adaptáveis proativos permitem que os usuários recebam informações de uma conversa inativa com um agente. Para saber como enviar Cartões Adaptáveis em uma conversar ativa , consulte Mostrar um Cartão Adaptável no Copilot Studio.

Além de enviar mensagens proativas, você também pode enviar Cartões Adaptáveis proativos.

Captura de tela de um cartão adaptável.

Os Cartões Adaptáveis são formatos de troca de cartões aberto que permitem aos desenvolvedores trocar o conteúdo da interface do usuário de maneira comum e consistente. Você pode criar Cartões Adaptáveis manualmente em JSON ou, se preferir uma interface de arrastar e soltar, pode usar o Designer de Cartões Adaptáveis.

Nota

O Power Automate não suporta Cartões Adaptáveis que usam o recurso de modelagem.

Neste exemplo, você enviará um cartão de resumo da ordem para o usuário revisar.

  1. No Power Automate, adicione a ação do conector do Microsoft Teams Postar cartão adaptável em um chat ou canal na etapa em que deseja enviar um cartão em seu fluxo.

  2. Para Postar como, escolha Power Virtual Agents (Versão Preliminar).

  3. Para Postar em, escolha Chat com bot.

  4. Em Bot, selecione o agente do qual você deseja que a mensagem seja enviada.

  5. Para Destinatário, insira o nome ou endereço de email do destinatário. Você também pode usar conteúdo dinâmico se as informações do destinatário vierem de uma etapa anterior do fluxo.

  6. Para Cartão Adaptável, insira o seguinte modelo JSON:

    {
    "type": "AdaptiveCard",
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.5",
    "body": [
        {
            "type": "TextBlock",
            "text": "Order summary",
            "wrap": true,
            "style": "heading"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Name",
                    "value": "John Doe"
                },
                {
                    "title": "Phone number",
                    "value": "(000) 000-0000"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "FactSet",
                    "facts": [
                        {
                            "title": "1x",
                            "value": "Steak"
                        },
                        {
                            "title": "2x",
                            "value": "Side Rice"
                        },
                        {
                            "title": "1x",
                            "value": "Soft Drink"
                        }
                    ],
                    "spacing": "Small"
                }
            ],
            "spacing": "Small"
        }
    ]
}

    Poste o cartão adaptável no Power Automate.

Quando o fluxo for executado, o destinatário receberá o Cartão Adaptável do agente no Microsoft Teams.

Aguarde a resposta do usuário

Importante

Esta seção detalha como enviar Cartões Adaptáveis proativos com os fluxos do Power Automate. Os Cartões adaptáveis proativos permitem que os usuários recebam informações de uma conversa inativa com um agente. Para saber como enviar Cartões Adaptáveis em uma conversar ativa , consulte Mostrar um Cartão Adaptável no Copilot Studio.

Os Cartões Adaptáveis suportam a coleta de entrada do usuário. Nesses cenários, você desejará aguardar a resposta do usuário antes que o fluxo continue.

Captura de tela de um cartão adaptável que contém ações para o usuário.

Nota

O Power Automate não suporta Cartões Adaptáveis que usam o recurso de modelagem.

Neste exemplo, você enviará um cartão de confirmação da ordem que permite ao usuário fazer alterações antes que a ordem seja enviada.

  1. No Power Automate, adicione a ação do conector do Microsoft Teams Postar cartão adaptável e aguardar uma resposta na etapa em que deseja enviar um cartão em seu fluxo.

  2. Para Postar como, escolha Power Virtual Agents (Versão Preliminar).

  3. Para Postar em, escolha Chat com bot.

  4. Para Mensagem, insira o seguinte modelo JSON:

    As propriedades na seção actions determinam as opções que são apresentadas ao usuário.

    {
    "type": "AdaptiveCard",
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.0",
    "body": [
        {
            "type": "TextBlock",
            "text": "Order confirmation",
            "wrap": true,
            "style": "heading"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Name",
                    "value": "John Doe"
                },
                {
                    "title": "Phone number",
                    "value": "(000) 000-0000"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "FactSet",
                    "facts": [
                        {
                            "title": "1x",
                            "value": "Steak"
                        },
                        {
                            "title": "2x",
                            "value": "Side Rice"
                        },
                        {
                            "title": "1x",
                            "value": "Soft Drink"
                        }
                    ],
                    "spacing": "Small"
                }
            ],
            "spacing": "Small"
        }
    ],
    "actions": [
        {
            "type": "Action.Submit",
            "title": "Submit Order"
        },
        {
            "type": "Action.Submit",
            "title": "Edit Order"
        }
    ]
}

  5. Para Mensagem de atualização, informe a mensagem de atualização que o destinatário verá depois que fornecer a resposta.

  6. Para Destinatário, insira o nome ou endereço de email do destinatário. Você também pode usar conteúdo dinâmico se as informações do destinatário vierem de uma etapa anterior do fluxo.

  7. Para o Bot, selecione o agente do qual você deseja que o cartão seja enviado.

    Ação Postar cartão adaptável e aguardar uma resposta no Power Automate.

Quando o fluxo for executado, o destinatário receberá o cartão adaptável do agente no Microsoft Teams para o qual ele poderá fornecer uma resposta.

Para usar a resposta do destinatário, selecione submitActionId no menu suspenso de conteúdo dinâmico. O valor desta variável será o title da ação que o usuário escolheu.

Enviar mensagens proativas para vários destinatários

Em alguns cenários, você pode querer enviar a mesma mensagem proativa para vários destinatários.

Esta seção contém exemplos de envio de mensagens para vários destinatários.

Importante

Os pré-requisitos detalhados neste tópico se aplicam a cada destinatário.

Por exemplo, você pode enviar a mesma mensagem para 10 destinatários em uma ação. Se três dos dez destinatários não tiverem o agente instalado, esses três destinatários não receberão a mensagem.

Enviar para colegas de equipe

Neste exemplo, o agente enviará um lembrete aos membros de uma equipe para concluírem o treinamento online.

  1. Adicione o conector do Microsoft Teams e selecione a ação Obter uma equipe em seu fluxo do Power Automate.

  2. Para Equipe, selecione a equipe com os membros para os quais deseja enviar a mensagem.

  3. Adicione o conector Office 365 Groups e selecione a ação Listar membros do grupo.

  4. Para ID do Grupo, selecione Valor personalizado.

  5. Selecione a ID da Equipe no conteúdo dinâmico da ação Obter uma equipe.

  6. Adicione o conector do Microsoft Teams e selecione a ação Postar mensagem em um chat ou canal.

  7. Para Postar como, escolha Power Virtual Agents (Versão Preliminar).

  8. Para Postar em, escolha Chat com bot.

  9. Em Bot, selecione o agente do qual você deseja enviar a mensagem.

  10. Para Destinatário, selecione o conteúdo dinâmico Nome de Princípio de Usuário na ação Listar membros do grupo.

    Exemplo de Enviar para colegas de equipe.

  11. Para Mensagem, digite a mensagem que deseja enviar.

Quando o fluxo for executado, cada usuário da equipe receberá a mensagem proativa em um chat privado com o agente.

Enviar para um grupo de segurança

Neste exemplo, o agente enviará um lembrete a um um grupo de segurança para concluírem o treinamento online.

  1. Adicione o conector do Microsoft Entra ID e selecione a ação Obter membros do grupo em seu fluxo do Power Automate.

  2. Para ID do grupo, insira o GUID do grupo de segurança.

  3. Adicione o conector do Microsoft Teams e selecione a ação Postar mensagem em um chat ou canal.

  4. Para Postar como, escolha Power Virtual Agents (Versão Preliminar).

  5. Para Postar em, escolha Chat com bot.

  6. Em Bot, selecione o agente do qual você deseja enviar a mensagem.

  7. Para Destinatário, selecione o conteúdo dinâmico Nome de Princípio de Usuário dos Membros do Grupo na ação Obter membros do grupo.

  8. Para Mensagem, digite a mensagem que deseja enviar.

    Envie para uma opção de grupo de segurança.

Quando o fluxo for executado, cada usuário no grupo de segurança receberá a mensagem proativa em um chat privado com o agente.

Enviar mensagem proativa para vários destinatários em paralelo

Normalmente, ao enviar uma mensagem proativa para vários destinatários, seu agente enviará uma mensagem após a outra. No entanto, em algumas situações, pode ser preferível enviar a mensagem para vários destinatários ao mesmo tempo.

Aviso

Todas as mensagens proativas do Copilot Studio estão sujeitas a limites no Power Automate e a limitações do conector do Microsoft Teams.

Se estiver enviando mensagens para um grande grupo de destinatários, você verá erros se atingir a restrição de limite. Você poderá reduzir o grau de paralelismo ou reduzir o número de destinatários no grupo.

  1. Na ação Aplicar a cada, selecione os três pontos horizontais (. . .) e depois Definições.

    Configurações no menu de mais opções.

  2. Ative a opção Controle de simultaneidade e defina o grau de paralelismo.

    Controle deslizante para definir o nível ou simultaneidade.

Configurar opções avançadas para mensagens proativas

O Copilot Studio permite que você controle o comportamento detalhado em seu agente em Mostrar opções avançadas no conector do Microsoft Teams.

Painel de opções expandido no conector.

Rótulo de mensagem enviada como uma notificação

Rotular como notificação controla se a mensagem tem o texto "Notificação por meio de" na frente do nome do agente. Rotular a resposta do agente permite que o destinatário identifique a resposta do agente à sua pergunta.

A configuração mostra Notificação por meio do nome do agente.

Quando o destinatário está em um chat ativo com o agente

Às vezes, o agente pode enviar uma mensagem ou cartão proativo quando o destinatário está em uma conversa ativa com o agente.

Você pode adiar o envio da mensagem proativa até que a conversa seja concluída para não interromper o fluxo da conversa.

A caixa Se o chat estiver ativo permite que você controle o comportamento:

  • Enviar: o agente enviará a mensagem proativa normalmente.

  • Não enviar e ter êxito: o agente não enviará a mensagem proativa quando o destinatário estiver em uma conversa ativa. O código de status 300 será retornado.

  • Não enviar e falhar: o agente não enviará a mensagem proativa quando o destinatário estiver em uma conversa ativa. A execução do fluxo será marcada como com falha.

Quando o destinatário não tiver instalado o agente

O agente só pode entregar mensagens ou cartões aos destinatários que tiverem instalado o agente no Microsoft Teams. Os destinatários podem não querer instalar o agente ou desinstalaram o agente.

Para mensagens ou cartões de menor importância, você pode definir a execução do fluxo para ser marcada como com êxito, mesmo quando o destinatário não tiver o agente instalado.

A caixa Se o bot não estiver instalado permite que você controle o comportamento:

  • Com falha: a execução do fluxo será marcada como com falha quando o destinatário não tiver instalado o agente no Microsoft Teams.

  • Com êxito com código de status: a execução do fluxo será marcada como com êxito, embora o destinatário não possa receber a mensagem ou o cartão porque não instalou o agente. O código de status 100 será retornado.

Definição do código de status

Você pode usar o código de status retornado para definir diferentes comportamentos de acompanhamento em seu fluxo. Por exemplo, você pode especificar que o fluxo deve tentar novamente durante um período ou fazer um registro em log sobre a falha.

Código de status Com êxito (booliano) Descrição
200 Verdadeiro Mensagem entregue com êxito.
100 Falso Não foi possível entregar a mensagem porque o destinatário não tem o agente instalado.
300 False Não foi possível entregar a mensagem porque o destinatário está em uma conversa ativa com o agente.