Partager via

Envoyer des messages Microsoft Teams proactifs

Après avoir publié votre agent et mis l’agent à la disposition des utilisateurs dans Microsoft Teams, vous pouvez avertir les utilisateurs (« destinataires ») dans Microsoft Teams avec des messages proactifs. Les messages proactifs utilisent des flux Power Automate pour diffuser leur contenu et sont utiles dans de nombreux scénarios, notamment :

  • Informer un destinataire que sa demande précédente a été traitée. Par exemple, la demande de congé de l’utilisateur a été approuvée.
  • Fournir des rappels ou des mises à jour de nouvelles. Par exemple, l’agent peut envoyer un message de rappel de terminer une formation en ligne.

Important

Les messages proactifs peuvent être configurés pour les agents et les chatbots classiques créés et personnalisés dans Copilot Studio.

Un agent ne peut pas remettre de messages si le destinataire :

Prérequis

Limitations connues

  • Si l’agent est déconnecté, puis reconnecté à Microsoft Teams, les utilisateurs ne recevront de messages proactifs qu’après avoir réinstallé l’agent.
  • Tous les messages proactifs provenant de Copilot Studio sont soumis à des limites sur Power Automate et à des limitations du connecteur Microsoft Teams.
  • Les messages proactifs ne sont pas enregistrés dans les transcriptions de conversation ni dans les sessions d’analyse.
  • Les messages proactifs doivent être dans le même environnement que le flux Power Automate.
  • Les messages proactifs ne peuvent être publiés que dans une conversation personnelle avec l’agent.

Envoyer un message proactif

  1. Dans Power Automate, ouvrez le flux auquel vous souhaitez envoyer un message proactif.

  2. Ajoutez l’action de connecteur Microsoft TeamsPublier le message dans une conversation instantanée ou un canal.

  3. Pour Publier en tant que, sélectionnez Power Virtual Agents (Version préliminaire).

  4. Pour Publier dans, sélectionnez Discuter avec un bot.

  5. Pour Bot, sélectionnez l’agent à partir duquel vous souhaitez que le message soit envoyé.

  6. Pour Destinataire, entrez le nom ou l’adresse de messagerie du destinataire. Vous pouvez également utiliser du contenu dynamique si les informations sur le destinataire proviennent d’une étape antérieure du flux.

  7. Pour Message, entrez le message que vous souhaitez envoyer.

    Publiez une action de message dans Power Automate.

Lorsque le flux est exécuté, le destinataire recevra le message proactif de l’agent dans Microsoft Teams.

Envoyer une carte adaptative proactive

Important

Cette section explique comment envoyer des cartes adaptatives proactives avec des flux Power Automate. Les cartes adaptatives proactives permettent aux utilisateurs de recevoir des informations à partir d’une conversation inactive avec un agent. Pour savoir comment envoyer des cartes adaptatives dans une conversation active, consultez Afficher une carte adaptative dans Copilot Studio.

En plus d’envoyer des messages proactifs, vous pouvez également envoyer des cartes adaptatives proactives.

Capture d’écran d’une carte adaptative.

Les cartes adaptatives sont un format d’échange de cartes ouvert permettant aux développeurs d’échanger du contenu d’interface utilisateur de manière commune et cohérente. Vous pouvez créer des cartes adaptatives à la main dans JSON, ou si vous préférez une interface par glisser-déposer, vous pouvez utiliser le Concepteur de cartes adaptatives.

Note

Power Automate ne prend pas en charge les cartes adaptatives qui utilisent la fonctionnalité de templating.

Dans cet exemple, vous allez envoyer une carte de récapitulatif de commande à l’utilisateur pour qu’il l’examine.

  1. Dans Power Automate, ajoutez l’action de connecteur Microsoft Teams Publier la carte adaptative dans une conversation instantanée ou un canal à l’étape où vous souhaitez envoyer une carte dans votre flux.

  2. Pour Publier en tant que, sélectionnez Power Virtual Agents (Version préliminaire).

  3. Pour Publier dans, sélectionnez Discuter avec un bot.

  4. Pour Bot, sélectionnez l’agent à partir duquel vous souhaitez que le message soit envoyé.

  5. Pour Destinataire, entrez le nom ou l’adresse de messagerie du destinataire. Vous pouvez également utiliser du contenu dynamique si les informations sur le destinataire proviennent d’une étape antérieure du flux.

  6. Pour Carte adaptative, saisissez le modèle JSON suivant :

    {
    "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"
        }
    ]
}

    Publiez l’action de la carte adaptative dans Power Automate.

Lorsque le flux est exécuté, le destinataire recevra la carte adaptative de l’agent dans Microsoft Teams.

Attendre la réponse de l’utilisateur

Important

Cette section explique comment envoyer des cartes adaptatives proactives avec des flux Power Automate. Les cartes adaptatives proactives permettent aux utilisateurs de recevoir des informations à partir d’une conversation inactive avec un agent. Pour savoir comment envoyer des cartes adaptatives dans une conversation active, consultez Afficher une carte adaptative dans Copilot Studio.

Les cartes adaptatives prennent en charge la collecte des entrées des utilisateurs. Dans ces scénarios, vous souhaiterez attendre la réponse de l’utilisateur avant que le flux ne se poursuive.

Capture d’écran d’une carte adaptative contenant des actions pour l’utilisateur.

Note

Power Automate ne prend pas en charge les cartes adaptatives qui utilisent la fonctionnalité de templating.

Dans cet exemple, vous allez envoyer une carte de confirmation de commande qui permet à l’utilisateur d’apporter des modifications avant que la commande ne soit soumise.

  1. Dans Power Automate, ajoutez l’action de connecteur Microsoft Teams Publier la carte adaptative et attendre une réponse à l’étape où vous souhaitez envoyer une carte dans votre flux.

  2. Pour Publier en tant que, sélectionnez Power Virtual Agents (Version préliminaire).

  3. Pour Publier dans, sélectionnez Discuter avec un bot.

  4. Pour Message, saisissez le modèle JSON suivant :

    Les propriétés de la section actions déterminent les options présentées à l’utilisateur.

    {
    "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. Pour Message de mise à jour, entrez le message de mise à jour que le destinataire verra après avoir indiqué sa réponse.

  6. Pour Destinataire, entrez le nom ou l’adresse de messagerie du destinataire. Vous pouvez également utiliser du contenu dynamique si les informations sur le destinataire proviennent d’une étape antérieure du flux.

  7. Pour Bot, sélectionnez l’agent à partir duquel vous souhaitez que la carte soit envoyée.

    Publiez une carte adaptative et attendez une action de réponse dans Power Automate.

Lorsque le flux est exécuté, le destinataire reçoit la carte adaptative de l’agent dans Microsoft Teams, à laquelle il peut ensuite apporter une réponse.

Pour utiliser la réponse du destinataire, sélectionnez submitActionId dans le menu déroulant du contenu dynamique. La valeur de cette variable sera le titre title de l’action choisie par l’utilisateur.

Envoyer des messages proactifs à plusieurs destinataires

Dans certains scénarios, vous souhaiterez peut-être envoyer le même message proactif à plusieurs destinataires.

Cette section contient des exemples d’envoi de messages à plusieurs destinataires.

Important

Les conditions préalables requises détaillées dans cette rubrique s’appliquent à chaque destinataire.

Par exemple, vous pouvez envoyer le même message à 10 destinataires en une seule action. Si trois des 10 destinataires n’ont pas installé l’agent, alors ces trois destinataires ne recevront pas le message.

Envoyer aux membres de l’équipe

Dans cet exemple, l’agent enverra un rappel aux membres d’une équipe afin qu’ils terminent leur formation en ligne.

  1. Ajoutez le connecteur Microsoft Teams et sélectionnez l’action Obtenir une équipe dans votre flux Power Automate.

  2. Pour Équipe, sélectionnez l’équipe avec les membres à qui vous souhaitez envoyer le message.

  3. Ajoutez le connecteur Groupes Office 365 et sélectionnez l’action Lister les membres du groupe.

  4. Pour ID groupe, sélectionnez Valeur personnalisée.

  5. Sélectionnez ID d’équipe dans le contenu dynamique de l’action Obtenir une équipe.

  6. Ajoutez le conecteur Microsoft Teams et sélectionnez l’action Publier le message dans une conversation instantanée ou un canal.

  7. Pour Publier en tant que, sélectionnez Power Virtual Agents (Version préliminaire).

  8. Pour Publier dans, sélectionnez Discuter avec un bot.

  9. Pour Bot, sélectionnez l’agent à partir duquel vous souhaitez envoyer le message.

  10. Pour Destinataire, sélectionnez le contenu dynamique Nom de principe d’utilisateur dans l’action Lister les membres du groupe.

    Exemple Envoyer aux membres de l’équipe.

  11. Pour Message, entrez le message que vous souhaitez envoyer.

Lorsque le flux s’exécute, chaque utilisateur de l’équipe recevra le message proactif dans une conversation privée avec l’agent.

Envoyer à un groupe de sécurité

Dans cet exemple, l’agent enverra un rappel à un groupe de sécurité afin qu’il termine sa formation en ligne.

  1. Ajoutez le connecteur Microsoft Entra ID et sélectionnez l’action Obtenir les membres du groupe dans votre flux Power Automate.

  2. Pour ID de groupe, entrez le GUID du groupe de sécurité.

  3. Ajoutez le conecteur Microsoft Teams et sélectionnez l’action Publier le message dans une conversation instantanée ou un canal.

  4. Pour Publier en tant que, sélectionnez Power Virtual Agents (Version préliminaire).

  5. Pour Publier dans, sélectionnez Discuter avec un bot.

  6. Pour Bot, sélectionnez l’agent à partir duquel vous souhaitez envoyer le message.

  7. Pour Destinataire, sélectionnez le contenu dynamique Nom de principe d’utilisateur des memebres du groupe dans l’action Obtenir les membres du groupe.

  8. Pour Message, entrez le message que vous souhaitez envoyer.

    Envoyez à une option de groupe de sécurité.

Lorsque le flux s’exécute, chaque utilisateur du groupe de sécurité recevra le message proactif dans une conversation privée avec l’agent.

Envoyer un message proactif à plusieurs destinataires en parallèle

Normalement, lors de l’envoi d’un message proactif à plusieurs destinataires, votre agent enverra un message après l’autre. Toutefois, dans certaines situations, il peut être préférable d’envoyer le message à plusieurs destinataires en même temps.

Avertissement

Tous les messages proactifs provenant de Copilot Studio sont soumis à des limites sur Power Automate et à des limitations du connecteur Microsoft Teams.

Si vous envoyez des messages à un grand groupe de destinataires, vous verrez des erreurs si vous atteignez la limitation de requêtes. Vous pouvez réduire le degré de parallélisme ou réduire le nombre de destinataires dans le groupe.

  1. Dans l’action Appliquer à chacun, sélectionnez les trois points horizontaux (. . .), puis Paramètres.

    Paramètres dans le menu Plus d’options.

  2. Activez Contrôle d’accès concurrentiel et définissez le degré de parallélisme.

    Contrôle de curseur pour régler le niveau ou la concurrence.

Configurer les options avancées pour les messages proactifs

Copilot Studio vous permet de contrôler le comportement détaillé de votre agent sous Afficher les options avancées dans le connecteur Microsoft Teams.

Volet d’options étendu dans le connecteur.

Étiqueter le message envoyé en tant que notification

Étiqueter en tant que notification contrôle si le message comporte la mention « Notification via » devant le nom de l’agent. L’étiquetage de la réponse de l’agent permet au destinataire d’identifier la réponse de l’agent à sa demande.

Le paramètre affiche Notification via le nom de l’agent.

Lorsque le destinataire est actuellement dans une discussion active avec l’agent

Parfois, l’agent peut envoyer un message proactif lorsque le destinataire est en conversation active avec l’agent.

Vous pouvez souhaitez reporter l’envoi du message proactif jusqu’à la fin de leur conversation afin de ne pas perturber le flux de la conversation.

La zone Si la conversation instantanée est active vous permet de contrôler le comportement :

  • Envoyer : l’agent enverra le message proactif comme d’habitude.

  • Ne pas envoyer et aboutir : l’agent n’enverra pas le message proactif lorsque le destinataire est en conversation active. Le code statut 300 sera renvoyé.

  • Ne pas envoyer et échouer : l’agent n’enverra pas le message proactif lorsque le destinataire est en conversation active. L’exécution du flux sera marquée comme un échec.

Lorsque le destinataire n’a pas installé l’agent

L’agent ne peut remettre de messages qu’aux destinataires qui ont installé l’agent dans Microsoft Teams. Les destinataires peuvent ne pas vouloir installer l’agent ou avoir désinstallé l’agent.

Pour les messages de moindre importance, vous pouvez définir l’exécution du flux pour qu’elle soit marquée comme réussie même lorsque le destinataire n’a pas installé l’agent.

La case Si le bot n’est pas installé vous permet de contrôler le comportement :

  • Échouer : l’exécution de flux sera marquée comme un échec lorsque le destinataire n’a pas installé l’agent dans Microsoft Teams.

  • Aboutir avec le code de statut : l’exécution de flux sera marquée comme réussie même si le destinataire ne peut pas recevoir le message car il n’a pas installé l’agent. Le code statut 100 sera renvoyé.

Définitions des codes de statut

Vous pouvez utiliser le code de statut renvoyé pour définir différents comportements de suivi dans votre flux. Par exemple, vous pouvez spécifier que le flux doit réessayer sur une période donnée ou consigner un enregistrement sur l’échec.

Code statut Réussi (booléen) Description
200 Vrai Le message a été remis avec succès.
100 False Le message n’a pas pu être remis car le destinataire n’a pas installé l’agent.
300 False Le message n’a pas pu être remis car le destinataire est en conversation active avec l’agent.