Partilhar via

Enviar mensagens proativas do Microsoft Teams

Depois de publicar o seu agente e disponibilizá-lo aos utilizadores no Microsoft Teams, poderá notificar os utilizadores ("destinatários") no Microsoft Teams com mensagens proativas. As mensagens proativas usam fluxos do Power Automate para entregar o seu conteúdo e são úteis em muitos cenários, incluindo:

  • Informar um destinatário de que o seu pedido anterior foi concluído. Por exemplo, o pedido de folga do utilizador foi aprovado.
  • Fornecer lembretes ou atualizações de notícias. Por exemplo, o agente pode enviar uma mensagem de lembrete para concluir a formação online.

Importante

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

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

Pré-requisitos

Limitações conhecidas

  • Se o agente for desligado e novamente ligado ao Microsoft Teams, os utilizadores não receberão mensagens proativas até que o reinstalem.
  • Todas as mensagens proativas do Copilot Studio estão sujeitas aos limites de Power Automate e aos limites de limitação do conector do Microsoft Teams.
  • As mensagens proativas não são registadas em transcrições de conversações nem em sessões do Google Analytics.
  • As mensagens proativas têm de estar no mesmo ambiente que o fluxo do Power Automate.
  • As mensagens proativas só podem ser publicadas num chat pessoal com o agente.

Enviar uma mensagem proativa

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

  2. Adicione a ação do conector do Microsoft Teams Publicar mensagem num chat ou canal.

  3. Para Post as, escolha Microsoft Copilot Studio (Preview).

  4. Para Publicar em, escolha Chat com bot.

  5. Para Bot, selecione o agente a partir do qual deseja que a mensagem seja enviada.

  6. Para Destinatários, introduza o nome ou o endereço de e-mail do destinatário. Também pode usar conteúdo dinâmico se as informações do destinatário forem provenientes de um passo anterior do fluxo.

  7. Em Mensagem, introduza a mensagem que pretende enviar.

    Publique a ação de mensagem no Power Automate.

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

Enviar um Cartão Adaptativo proativo

Importante

Esta secção detalha como enviar Cartões Adaptativos proativos com fluxos do Power Automate. Os Cartões Adaptativos proativos permitem que os utilizadores recebam informações de uma conversação inativa com um agente.

Além de enviar mensagens proativas, também pode enviar Cartões Adaptativos proativos.

Captura de ecrã de um cartão adaptativo.

Os Cartões Adaptativos são um formato aberto de intercâmbio de cartões que permite aos programadores trocar conteúdo da IU de forma comum e consistente. Pode criar Cartões Adaptativos manualmente no formato JSON ou, se preferir uma interface de arrastar e largar, pode usar o Estruturador de Cartões Adaptativos.

Observação

O Power Automate não suporta Cartões Adaptativos que usam a funcionalidade de modelagem.

Neste exemplo, enviará um cartão de resumo da encomenda para o utilizador rever.

  1. No Power Automate, adicione a ação do conector do Microsoft Teams Publicar cartão adaptativo num chat ou canal no passo para onde deseja enviar o cartão no fluxo.

  2. Para Post as, escolha Microsoft Copilot Studio (Preview).

  3. Para Publicar em, escolha Chat com bot.

  4. Para Bot, selecione o agente a partir do qual deseja que a mensagem seja enviada.

  5. Para Destinatários, introduza o nome ou o endereço de e-mail do destinatário. Também pode usar conteúdo dinâmico se as informações do destinatário forem provenientes de um passo anterior do fluxo.

  6. Para Cartão Adaptativo, introduza 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"
        }
    ]
}

    Publicar cartão adaptativo no Power Automate.

Quando o fluxo é executado, o destinatário receberá o Cartão Adaptativo do agente no Microsoft Teams.

Aguardar pela resposta do utilizador

Importante

Esta secção detalha como enviar Cartões Adaptativos proativos com fluxos do Power Automate. Os Cartões Adaptativos proativos permitem que os utilizadores recebam informações de uma conversação inativa com um agente.

Os Cartões Adaptativos suportam a recolha de entradas de utilizador. Nestes cenários, é aconselhável aguardar a resposta do utilizador antes que o fluxo continue.

Captura de ecrã de um cartão adaptativo que contém ações para o utilizador.

Observação

O Power Automate não suporta Cartões Adaptativos que usam a funcionalidade de modelagem.

Neste exemplo, enviará um cartão de confirmação da encomenda que permite que o utilizador efetue alterações antes que a encomenda seja enviada.

  1. No Power Automate, adicione a ação do conector do Microsoft Teams Publicar cartão adaptativo e esperar por uma resposta no passo para onde deseja enviar o cartão no fluxo.

  2. Para Post as, escolha Microsoft Copilot Studio (Preview).

  3. Para Publicar em, escolha Chat com bot.

  4. Em Mensagem, introduza o seguinte modelo JSON:

    As propriedades na secção actions determinam as opções que são apresentadas ao utilizador.

    {
    "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. Em Mensagem de atualização, introduza a mensagem de atualização que o destinatário verá depois de fornecer a resposta.

  6. Para Destinatários, introduza o nome ou o endereço de e-mail do destinatário. Também pode usar conteúdo dinâmico se as informações do destinatário forem provenientes de um passo anterior do fluxo.

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

    Publique o cartão adaptativo e aguarde a ação de resposta no Power Automate.

Quando o fluxo é executado, o destinatário receberá o cartão adaptativo do agente no Microsoft Teams para o qual poderá fornecer uma resposta.

Para usar a resposta do destinatário, selecione submitActionId no menu de lista de opções de conteúdo dinâmico. O valor desta variável será o title da ação escolhida pelo utilizador.

Enviar mensagens proativas para vários destinatários

Em alguns cenários, talvez seja aconselhável enviar a mesma mensagem proativa para vários destinatários.

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

Importante

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

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

Enviar para colegas de equipa

Neste exemplo, o agente enviará um lembrete aos membros de uma equipa para concluir a sua formação online.

  1. Adicione o conector do Microsoft Teams e selecione a ação Obter uma equipa no fluxo do Power Automate.

  2. Para Equipa, escolha a equipa com os membros para os quais pretende enviar a mensagem.

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

  4. Em ID do grupo, selecione Valor personalizado.

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

  6. Adicione o conector Microsoft Teams e selecione a ação Publicar mensagem num chat ou canal.

  7. Para Post as, escolha Microsoft Copilot Studio (Preview).

  8. Para Publicar em, escolha Chat com bot.

  9. Para Bot, selecione o agente ao qual deseja enviar a mensagem.

  10. Em Destinatário, selecione o Nome Principal do Utilizador do conteúdo dinâmico na ação Listar membros do grupo.

    Exemplo de envio para os colegas da equipa.

  11. Em Mensagem, introduza a mensagem que pretende enviar.

Quando o fluxo é executado, cada utilizador da equipa receberá a mensagem proativa num chat privado com o agente.

Enviar a um grupo de segurança

Neste exemplo, o agente enviará um lembrete a um grupo de segurança para concluir a sua formação online.

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

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

  3. Adicione o conector Microsoft Teams e selecione a ação Publicar mensagem num chat ou canal.

  4. Para Post as, escolha Microsoft Copilot Studio (Preview).

  5. Para Publicar em, escolha Chat com bot.

  6. Para Bot, selecione o agente ao qual deseja enviar a mensagem.

  7. Em Destinatário, selecione o Nome Principal do Utilizador dos Membros do Grupo do conteúdo dinâmico na ação Obter membros do grupo.

  8. Em Mensagem, introduza a mensagem que pretende enviar.

    Opção Enviar a um grupo de segurança.

Quando o fluxo é executado, cada utilizador do grupo de segurança receberá a mensagem proativa num 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, o 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.

Advertência

Todas as mensagens proativas do Copilot Studio estão sujeitas aos limites de Power Automate e aos limites de limitação do conector do Microsoft Teams.

Se pretender enviar mensagens para um grande grupo de destinatários, verá erros se atingir o limite de limitação. Pode reduzir o grau de paralelismo ou reduzir o número de destinatários no grupo.

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

    Captura de ecrã da seleção das definições.

  2. Ative o Controlo de simultaneidade e defina o grau de paralelismo.

    Controle de deslize para definir o nível ou simultaneidade.

Configurar opções avançadas para mensagens proativas

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

Painel de opções expandido no conector.

Etiquetar mensagem enviada como uma notificação

Etiquetar como notificação controla se a mensagem tem o texto "Notificação via" à frente do nome do agente. Ao etiquetar a resposta do agente permite que o destinatário identifique a resposta do agente à sua consulta.

A definição mostra o nome do agente em Notificação via.

Quando o destinatário está atualmente num chat ativo com o agente

Às vezes, o agente pode estar a enviar uma mensagem proativa quando o destinatário está numa conversa ativa com o agente.

Pode adiar o envio da mensagem proativa até que terminem a conversa para não interromper o fluxo da conversa.

A caixa Se o chat estiver ativo permite controlar o comportamento:

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

  • Não enviar e definir como êxito: o agente não enviará a mensagem proativa quando o destinatário estiver numa conversa ativa. O código de estado 300 será devolvido.

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

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

O agente só pode entregar mensagens a destinatários que tenham instalado o agente no Microsoft Teams. Os destinatários podem não querer instalar o agente ou ter desinstalado o agente.

Para mensagens de menor importância, pode definir a execução do fluxo para ser marcada como bem sucedida, mesmo quando o destinatário não tiver o agente instalado.

A caixa Se o bot não estiver instalado permite controlar o comportamento:

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

  • Êxito com o código de estado: a execução do fluxo será marcada como bem sucedida, mesmo que o destinatário não possa receber a mensagem porque não instalou o agente. O código de estado 100 será devolvido.

Definição do código de estado

Pode usar o código de estado devolvido para definir diferentes comportamentos de seguimento no seu fluxo. Por exemplo, pode especificar que o fluxo deve tentar novamente durante um período de tempo ou registar um registo sobre a falha.

Código de estado Com êxito (Booleano) Description
200 Verdade A mensagem é entregue com êxito.
100 Falso A mensagem não pôde ser entregue porque o destinatário não tem o agente instalado.
300 Falso A mensagem não pôde ser entregue porque o destinatário está numa conversa ativa com o agente.
  • Last updated on