Delen via

Proactieve Microsoft Teams-berichten verzenden

Nadat u uw agent hebt gepubliceerd en de agent beschikbaar hebt gesteld aan gebruikers in Microsoft Teams, kunt u gebruikers (ontvangers) hiervan op de hoogte stellen met proactieve berichten in Microsoft Teams. Proactieve berichten gebruiken Power Automate-stromen om de inhoud af te leveren en zijn nuttig in allerlei scenario's:

  • Een ontvanger laten weten dat hun eerdere aanvraag is afgerond. Het verlofverzoek van de gebruiker is bijvoorbeeld goedgekeurd.
  • Het verstrekken van herinneringen of nieuwsupdates. De agent kan bijvoorbeeld een herinneringsbericht sturen om de online training te voltooien.

Belangrijk

Proactieve berichten kunnen worden geconfigureerd voor agenten en klassieke chatbots die zijn gemaakt en aangepast in Copilot Studio.

Een agent kan geen berichten afleveren als de ontvanger:

  • De agent niet heeft geïnstalleerd in Microsoft Teams.
  • De agent heeft verwijderd.
  • Heeft de agent geblokkeerd.
  • Geen toestemming heeft om met de agent te chatten. In dat geval moet u de agent met andere gebruikers delen.

Voorwaarden

Bekende beperkingen

  • Als de verbinding van de agent wordt verbroken en opnieuw wordt gemaakt met Microsoft Teams, ontvangen gebruikers pas proactieve berichten nadat ze de agent opnieuw hebben geïnstalleerd.
  • Voor alle proactieve berichten van Copilot Studio gelden limieten voor Power Automate en aanvraagbeperkingen van de Microsoft Teams-connector.
  • Proactieve berichten worden niet vastgelegd in gesprekstranscripties of analysesessies.
  • Proactieve berichten moeten zich in dezelfde omgeving bevinden als de Power Automate-stroom.
  • Proactieve berichten kunnen alleen in een persoonlijke chat met de agent worden gepost.

Een proactief bericht verzenden

  1. Open in Power Automate de stroom die u een proactief bericht wilt sturen.

  2. Voeg de Microsoft Teams-connector toe en selecteer de actie Bericht posten in chat of kanaal.

  3. Kies voor Posten alsPower Virtual Agents (preview).

  4. Kies voor Posten inChatten met bot.

  5. Selecteer voor Bot de agent waaruit u het bericht wilt verzenden.

  6. Voer voor Ontvanger de naam of het e-mailadres van de ontvanger in. U kunt ook dynamische inhoud gebruiken als de ontvangersinformatie uit een eerdere stap in de stroom komt.

  7. Voer voor Bericht het bericht in dat u wilt verzenden.

    Actie voor Bericht posten in Power Automate.

Wanneer de stroom wordt uitgevoerd, ontvangt de ontvanger het proactieve bericht van de agent in Microsoft Teams.

Een proactieve adaptieve kaart verzenden

Belangrijk

In dit gedeelte wordt beschreven hoe u proactieve adaptieve kaarten kunt verzenden met Power Automate-stromen. Met Proactive Adaptive Cards kunnen gebruikers informatie ontvangen uit een inactief gesprek met een agent. Zie Een adaptieve kaart weergeven in Copilot Studio voor meer informatie over het verzenden van Adaptieve kaarten in een actief gesprek.

Naast het verzenden van proactieve berichten kunt u ook proactieve adaptieve kaarten versturen.

Schermopname van een adaptieve kaart.

Adaptieve kaarten zijn een open kaartuitwisselingsindeling waarmee ontwikkelaars UI-inhoud op een algemene en consistente manier kunnen uitwisselen. U kunt adaptieve kaarten met de hand schrijven in JSON. Als u de voorkeur geeft aan een interface met slepen en neerzetten, kunt u ook de Ontwerper voor adaptieve kaarten gebruiken.

Opmerking

Power Automate ondersteunt geen adaptieve kaarten die gebruikmaken van de sjabloonfunctie.

In dit voorbeeld stuurt u een orderoverzichtskaart die de gebruiker kan bekijken.

  1. Voeg in Power Automate de Microsoft Teams-connectoractie Adaptieve kaart posten in chat of kanaal toe bij de stap waar u een kaart wilt sturen in de stroom.

  2. Kies voor Posten alsPower Virtual Agents (preview).

  3. Kies voor Posten inChatten met bot.

  4. Selecteer voor Bot de agent waaruit u het bericht wilt verzenden.

  5. Voer voor Ontvanger de naam of het e-mailadres van de ontvanger in. U kunt ook dynamische inhoud gebruiken als de ontvangersinformatie uit een eerdere stap in de stroom komt.

  6. Voer voor Adaptieve kaart de volgende sjabloon-JSON in:

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

    Actie voor Adaptieve kaart posten in Power Automate.

Wanneer de stroom wordt uitgevoerd, ontvangt de ontvanger de adaptieve kaart van de agent in Microsoft Teams.

Wachten op respons van de gebruiker

Belangrijk

In dit gedeelte wordt beschreven hoe u proactieve adaptieve kaarten kunt verzenden met Power Automate-stromen. Met Proactive Adaptive Cards kunnen gebruikers informatie ontvangen uit een inactief gesprek met een agent. Zie Een adaptieve kaart weergeven in Copilot Studio voor meer informatie over het verzenden van Adaptieve kaarten in een actief gesprek.

Adaptieve kaarten ondersteunen het verzamelen van gebruikersinvoer. In deze scenario's kunt u wachten op de respons van de gebruiker voordat de stroom wordt voortgezet.

Schermopname van een adaptieve kaart die acties voor de gebruiker bevat.

Opmerking

Power Automate ondersteunt geen adaptieve kaarten die gebruikmaken van de sjabloonfunctie.

In dit voorbeeld stuurt u een orderbevestigingskaart waarmee de gebruiker wijzigingen kan aanbrengen voordat de bestelling wordt ingediend.

  1. Voeg in Power Automate de Microsoft Teams-connectoractie Adaptieve kaart posten en wachten op een antwoord toe bij de stap waar u een kaart wilt sturen in de stroom.

  2. Kies voor Posten alsPower Virtual Agents (preview).

  3. Kies voor Posten inChatten met bot.

  4. Voer voor Bericht de volgende sjabloon-JSON in:

    De eigenschappen in de sectie actions bepalen de opties die aan de gebruiker worden gepresenteerd.

    {
    "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. Voer voor Updatebericht het updatebericht in dat de ontvanger te zien krijgt na het geven van respons.

  6. Voer voor Ontvanger de naam of het e-mailadres van de ontvanger in. U kunt ook dynamische inhoud gebruiken als de ontvangersinformatie uit een eerdere stap in de stroom komt.

  7. Selecteer voor Bot de agent waaruit u de kaart wilt verzenden.

    Adaptieve kaart posten en wachten op een antwoord in Power Automate.

Wanneer de stroom wordt uitgevoerd, ontvangt de ontvanger de adaptieve kaart van de agent in Microsoft Teams waarop ze vervolgens een reactie kunnen geven.

Om de respons van de ontvanger te gebruiken, selecteert u submitActionId uit het vervolgmenu voor dynamische inhoud. De waarde van deze variabele is de title van de actie die de gebruiker heeft gekozen.

Proactieve berichten verzenden naar meerdere ontvangers

In bepaalde scenario´s wilt u misschien hetzelfde proactieve bericht naar meerdere ontvangers sturen.

Dit gedeelte bevat voorbeelden voor het verzenden van berichten naar meerdere ontvangers.

Belangrijk

De vereisten die in dit onderwerp worden beschreven, zijn van toepassing op elke ontvanger.

U kunt bijvoorbeeld hetzelfde e-mailbericht naar 10 geadresseerden verzenden in één actie. Als drie van de 10 ontvangers de agent niet hebben geïnstalleerd, ontvangen die drie ontvangers het bericht niet.

Verzenden naar teamgenoten

In dit voorbeeld stuurt de agent een herinnering naar de leden van een team om hun online training te voltooien.

  1. Voeg de Microsoft Teams-connector toe en selecteer de actie Een team kiezen in uw Power Automate-stroom.

  2. Kies voor Team het team met de leden naar wie u het bericht wilt sturen.

  3. Voeg de Office 365 Groepen-connector toe en selecteer de actie Groepsleden vermelden.

  4. Selecteer Aangepaste waarde in het veld Groep-id.

  5. Selecteer Team-id in de dynamische inhoud van de actie Een team kiezen.

  6. Voeg de Microsoft Teams-connector toe en selecteer de actie Bericht posten in chat of kanaal.

  7. Kies voor Posten alsPower Virtual Agents (preview).

  8. Kies voor Posten inChatten met bot.

  9. Selecteer voor Bot de agent die het bericht moet verzenden.

  10. Selecteer voor Ontvanger de dynamische inhoud User Principal Name (UPC) in de actie Groepsleden vermelden.

    Voorbeeld van verzenden naar teamgenoten.

  11. Voer voor Bericht het bericht in dat u wilt verzenden.

Wanneer de stroom loopt, ontvangt elke gebruiker in het team het proactieve bericht in een privéchat met de agent.

Verzenden naar een beveiligingsgroep

In dit voorbeeld stuurt de agent een herinnering naar een beveiligingsgroep om hun online training te voltooien.

  1. Voeg de Microsoft Entra ID-connector toe en selecteer de actie Groepsleden ophalen in uw Power Automate-stroom.

  2. Voer voor Groep-id de GUID van de beveiligingsgroep in.

  3. Voeg de Microsoft Teams-connector toe en selecteer de actie Bericht posten in chat of kanaal.

  4. Kies voor Posten alsPower Virtual Agents (preview).

  5. Kies voor Posten inChatten met bot.

  6. Selecteer voor Bot de agent die het bericht moet verzenden.

  7. Selecteer voor Ontvanger de dynamische inhoud User Principal Name groepsleden in de actie Groepsleden ophalen.

  8. Voer voor Bericht het bericht in dat u wilt verzenden.

    Optie voor verzenden naar een beveiligingsgroep.

Wanneer de stroom loopt, ontvangt elke gebruiker in de beveiligingsgroep het proactieve bericht in een privéchat met de agent.

Proactieve berichten parallel verzenden naar meerdere ontvangers

Wanneer u een proactief bericht naar meerdere ontvangers stuurt, verstuurt uw agent normaal gesproken het ene bericht na het andere. In sommige situaties kan het echter de voorkeur verdienen om het bericht tegelijkertijd naar meerdere ontvangers te verzenden.

Waarschuwing

Voor alle proactieve berichten van Copilot Studio gelden limieten voor Power Automate en aanvraagbeperkingen van de Microsoft Teams-connector.

Als u berichten naar een grote groep ontvangers verzendt, ziet u fouten als u de beperkingslimiet bereikt. U kunt de mate van parallelliteit verminderen of het aantal ontvangers in de groep verminderen.

  1. Selecteer in de actie Toepassen op elk de drie horizontale puntjes (. . .) en vervolgens Instellingen.

    Instellingen onder het menu Meer opties.

  2. Schakel Gelijktijdigheidsbeheer in en stel de mate van parallellisme in.

    Schuifregelaar voor het instellen van het niveau of gelijktijdigheid.

Geavanceerde opties configureren voor proactieve berichten

Copilot Studio stelt u in staat om het detailgedrag van uw agent te regelen onder Geavanceerde opties weergeven in de Microsoft Teams-connector.

Deelvenster Uitgebreide opties in de connector.

Verzonden bericht als melding labelen

Label als melding bepaalt of het bericht de tekst "Melding via" bevat voor de naam van de agent. Door het antwoord van de agent te labelen kan de ontvanger het antwoord van de agent op de vraag herkennen.

De instelling toont agentnaam met Melding via.

Wanneer de ontvanger momenteel in een actieve chat met de agent is

Soms stuurt de agent een proactief bericht wanneer de ontvanger een actief gesprek voert met de agent.

Misschien wilt u het verzenden van het proactieve bericht uitstellen totdat het gesprek is beëindigd om de gespreksstroom niet te verstoren.

In het vak Als chat actief is kunt u het gedrag bepalen:

  • Verzenden: de agent verzendt het proactieve bericht zoals normaal.

  • Niet verzenden en voltooien: de agent verzendt het proactieve bericht niet wanneer de ontvanger in een actief gesprek is. Statuscode 300 wordt teruggestuurd.

  • Niet verzenden en mislukken: de agent stuurt geen proactief bericht wanneer de ontvanger een actief gesprek voert. De stroomuitvoering wordt als mislukt gemarkeerd.

Wanneer de ontvanger de agent niet heeft geïnstalleerd

De agent kan alleen berichten of kaarten afleveren aan ontvangers die de agent hebben geïnstalleerd in Microsoft Teams. Ontvangers willen de agent mogelijk niet installeren of hebben de agent verwijderd.

Voor berichten of kaarten met een lager belang, kunt u instellen dat de stroomuitvoering als geslaagd wordt gemarkeerd, zelfs als de ontvanger de agent niet heeft geïnstalleerd.

In het vak Als de bot niet is geïnstalleerd kunt u het gedrag bepalen:

  • Mislukt: de stroomuitvoering wordt als mislukt gemarkeerd als de ontvanger de agent niet heeft geïnstalleerd in Microsoft Teams.

  • Slagen met statuscode: de stroomuitvoering wordt gemarkeerd als geslaagd, ook al kan de ontvanger het bericht niet ontvangen omdat hij de agent niet heeft geïnstalleerd. Statuscode 100 wordt teruggestuurd.

Definitie van statuscode

U kunt de geretourneerde statuscode gebruiken om verschillende vervolggedragingen in uw stroom te definiëren. U kunt bijvoorbeeld opgeven dat de stroom het gedurende een bepaalde periode opnieuw moet worden geprobeerd of dat een record over de fout wordt geregistreerd.

Statuscode Geslaagd (Booleaans) Omschrijving
200 True Bericht is afgeleverd.
100 False Bericht kan niet worden afgeleverd omdat de ontvanger de agent niet heeft geïnstalleerd.
300 False Bericht kan niet worden afgeleverd omdat de ontvanger een actief gesprek voert met de agent.