Dela via

Skicka proaktiva Microsoft Teams-meddelanden

När du har publicerat agenten och gjort den tillgänglig för användarna i Microsoft Teams kan du meddela användarna (mottagarna) i Microsoft Teams med proaktiva meddelanden. Proaktiva meddelanden använder Power Automate-flöden för att leverera innehåll och de är användbara i många situationer, till exempel:

  • Ge en mottagare information om att deras tidigare begäran har slutförts. Till exempel har användarens begäran om ledighet godkänts.
  • Ge uppdateringar om påminnelser eller nyheter. En agent kan till exempel skicka ett påminnelsemeddelande om att slutföra onlineutbildningen.

Viktigt

Proaktiva meddelanden kan konfigureras för agenter och vanliga chattrobotar som skapats och anpassats i Copilot Studio.

En agent kan inte leverera meddelanden om mottagaren:

  • Inte har installerat agenten i Microsoft Teams.
  • Har avinstallerat agenten.
  • Har blockerat agenten.
  • Inte har behörighet att chatta med agenten, i vilket fall du måste dela agenten med andra användare.

Förutsättningar

Kända begränsningar

  • Om agenten är bortkopplad och återansluts till Microsoft Teams får användarna inte proaktiva meddelanden förrän de har installerat om agenten.
  • Alla proaktiva meddelanden från Copilot Studio omfattas av begränsningarna i Power Automate och begränsningarna för Microsoft Teams-anslutningsprogram.
  • Proaktiva meddelanden loggas inte i konversationstranskriptionerna eller Analyssessioner.
  • Proaktiva meddelanden måste finnas i samma miljö som Power Automate-flödet.
  • Proaktiva meddelanden kan bara läggas upp i en personlig chatt med agenten.

Skicka proaktivt meddelande

  1. I Power Automate öppnar du flödet som du vill ska skicka ett proaktivt meddelande.

  2. Lägg till Microsoft Teams-anslutningsprogramåtgärden Publicera meddelande i en chatt eller en kanal.

  3. För Post som väljer du Microsoft Copilot Studio (förhandsversion).

  4. För Publicera i, välj Chatta med robot.

  5. Välj agenten från vilken du vill att meddelandet skickas för Robot.

  6. För Mottagare, ange mottagarens namn eller e-postadress. Du kan också använda dynamiskt innehåll om mottagarinformationen kommer från ett tidigare steg i flödet.

  7. För Meddelande, ange meddelandet du vill skicka.

    Publicera en meddelandeåtgärd i Power Automate.

När flödet körs får mottagaren det proaktiva meddelandet från agenten i Microsoft Teams.

Skicka ett proaktivt adaptivt kort

Viktigt

Det här avsnittet innehåller information om hur du skickar proaktiva adaptiva kort med Power Automate-flöden. Proaktiva Adaptiva kort gör det möjligt för användare att ta emot information från en inaktiv konversation med en agent.

Förutom att skicka proaktiva meddelanden kan du också skicka proaktiva adaptiva kort.

Skärmbild för ett adaptivt kort.

Adaptiva kort är ett öppet kortutbytesformat som gör det möjligt för utvecklare att utbyta UI-innehåll på ett gemensamt och konsekvent sätt. Du kan skapa adaptiva kort för hand i JSON, eller om du föredrar ett dra och släpp-gränssnitt kan du använda Designer för adaptiva kort.

Obs

Power Automate har inte stöd för adaptiva kort som använder mallfunktionen.

I det här exemplet skickar du ett ordersammanfattningskort som användaren kan granska.

  1. I Power Automate lägger tu dill Microsoft Teams-anslutningsprogramåtgärden Publicera adaptivt kort i en chatt eller en kanal i steget där du vill skicka kort i ditt flöde.

  2. För Post som väljer du Microsoft Copilot Studio (förhandsversion).

  3. För Publicera i, välj Chatta med robot.

  4. Välj agenten från vilken du vill att meddelandet skickas för Robot.

  5. För Mottagare, ange mottagarens namn eller e-postadress. Du kan också använda dynamiskt innehåll om mottagarinformationen kommer från ett tidigare steg i flödet.

  6. För adaptiva kort, ange följande mall 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"
        }
    ]
}

    Åtgärden Publicera adaptivt kort i Power Automate.

När flödet körs får mottagaren det adaptiva kortet från agenten i Microsoft Teams.

Vänta på användarsvar

Viktigt

Det här avsnittet innehåller information om hur du skickar proaktiva adaptiva kort med Power Automate-flöden. Proaktiva Adaptiva kort gör det möjligt för användare att ta emot information från en inaktiv konversation med en agent.

Adaptiva kort stöder insamling av användardata. I de här scenarierna bör du vänta på användarens svar innan flödet fortsätter.

Skärmbild på ett adaptivt kort som innehåller åtgärder för användaren.

Obs

Power Automate har inte stöd för adaptiva kort som använder mallfunktionen.

I det här exemplet skickar du ett orderbekräftelsekort som gör att användaren kan göra ändringar innan ordern skickas.

  1. I Power Automate lägger du till Microsoft Teams-anslutningsprogramåtgärden Publicera adaptivt kort och vänta på svar och vänta på ett svar i steget där du vill skicka kort i ditt flöde.

  2. För Post som väljer du Microsoft Copilot Studio (förhandsversion).

  3. För Publicera i, välj Chatta med robot.

  4. För Meddelande, ange följande mall JSON:

    Egenskaperna i avsnittet actions avgör vilka alternativ som visas för användaren.

    {
    "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. För Uppdatera meddelande, ange uppdateringsmeddelandet som mottagaren kommer att se efter att ha lämnat sitt svar.

  6. För Mottagare, ange mottagarens namn eller e-postadress. Du kan också använda dynamiskt innehåll om mottagarinformationen kommer från ett tidigare steg i flödet.

  7. Välj agenten från vilken du vill att kortet skickas för Robot.

    Publicera adaptivt kort och invänta svarsåtgärd i Power Automate.

När flödet körs kommer mottagaren att få det adaptiva kortet från agenten i Microsoft Teams som de sedan kan ge ett svar på.

Om du vill använda svaret från mottagaren väljer du submitActionId på den utfällda menyn för dynamiskt innehåll. Värdet för variabeln är den title åtgärd som användaren väljer.

Skicka proaktiva meddelanden till flera mottagare

I en del scenarier vill du kanske skicka samma proaktiva meddelande till flera mottagare samtidigt.

Det här avsnittet innehåller exempel på hur du skickar meddelanden till flera mottagare.

Viktigt

De krav som anges i ämne gäller varje mottagare.

Du kan till exempel skicka samma meddelande till 10 mottagare i en åtgärd. Om tre av de 10 mottagarna inte har agenten installerad, kommer de tre mottagarna inte att ta emot meddelandet.

Skicka till lagkamrater

I det här exemplet kommer agenten att skicka en påminnelse till medlemmarna i ett team om att slutföra sin onlineutbildning.

  1. Lägg till Microsoft Teams-anslutningsprogrammet och välj åtgärden Hämta ett team i ditt Power Automate-flöde.

  2. För Team, markera teamet med de medlemmar du vill skicka meddelandet till

  3. Lägg till anslutningsprogrammet Office 365-grupper och välj åtgärden Visa gruppmedlemskap.

  4. För Grupp-ID väljer du Kundvärde.

  5. Välj Team-ID i det dynamiska innehållet i åtgärden Hämta ett team.

  6. Lägg till Microsoft Teams-anslutningsprogrammet och välj åtgärden Publicera meddelande i en chatt eller en kanal.

  7. För Post som väljer du Microsoft Copilot Studio (förhandsversion).

  8. För Publicera i, välj Chatta med robot.

  9. Välj agenten från vilken du vill skicka meddelandet för Robot.

  10. För Mottagare, välj dynamiskt innehåll Användarens huvudnamn från åtgärden Visa gruppmedlemskap.

    Exempel på skicka till lagkamrater.

  11. För Meddelande, ange meddelandet du vill skicka.

När flödet körs får varje användare i teamet det proaktiva meddelandet i en privat chatt med agenten.

Skicka till en säkerhetsgrupp

I det här exemplet kommer agenten att skicka en säkerhetsgrupp för att slutföra sin onlineutbildning.

  1. Lägg till Microsoft Entra ID-anslutningsprogrammet och välj åtgärden Hämta gruppmedlemmar i ditt Power Automate-flöde.

  2. För Grupp-ID, ange säkerhetsgruppens GUID.

  3. Lägg till Microsoft Teams-anslutningsprogrammet och välj åtgärden Publicera meddelande i en chatt eller en kanal.

  4. För Post som väljer du Microsoft Copilot Studio (förhandsversion).

  5. För Publicera i, välj Chatta med robot.

  6. Välj agenten från vilken du vill skicka meddelandet för Robot.

  7. För Mottagare, välj dynamiskt innehåll Användarens huvudnamn för gruppmedlemmar från åtgärden Hämta gruppmedlemskap.

  8. För Meddelande, ange meddelandet du vill skicka.

    Alternativet Skicka till en säkerhetsgrupp.

När flödet körs får varje användare i säkerhetsgrupp det proaktiva meddelandet i en privat chatt med agenten.

Skicka proaktivt meddelande till flera mottagare parallellt

Om ett proaktivt meddelande skickas till flera mottagare skickar agenten vanligtvis meddelanden efter varandra. I vissa situationer kan det dock vara bättre att skicka meddelandet till flera mottagare samtidigt.

Varning

Alla proaktiva meddelanden från Copilot Studio omfattas av begränsningarna i Power Automate och begränsningarna för Microsoft Teams-anslutningsprogram.

Om du skickar meddelanden till en stor grupp mottagare visas fel om du trycker på begränsningsgränsen. Du kan minska grad av parallellitet eller minska antalet mottagare i gruppen.

  1. I Tillämpa på varje åtgärd, välj de tre prickarna (...) och sedan Inställningar.

    Skärmdump av att välja inställningar.

  2. Aktivera samtidighetskontroll och ange parallelliseringsgraden.

    Reglagekontroll för inställning av nivå eller effektivitet.

Konfigurera avancerade alternativ för proaktiva meddelanden

Med Copilot Studio kan du kontrollera detaljerat beteende för din agent under Visa avancerade alternativ i Microsoft Teams-anslutningsprogrammet.

Fönster för utökade alternativ i anslutningsprogram.

Etikett skickat meddelande som en avisering

Märk som avisering styr om meddelandet har texten Meddelande via framför agentens namn. Genom att märka agentens svar kan mottagaren identifiera agentens svar på sin förfrågan.

Inställningen visar Avisering via agentnamnet.

När mottagaren för närvarande är i en aktiv chatt med agenten

Ibland kan agenten skicka ett proaktivt meddelande när mottagaren är i en aktiv konversation med agenten.

Du kanske vill skjuta upp att skicka det proaktiva meddelandet tills de har avslutat sin konversation för att inte störa konversationsflödet.

Om rutan Om chatt är aktiv kan du kontrollera hur den fungerar:

  • Skicka: Agenten skickar det proaktiva meddelandet som vanligt.

  • Skicka inte och slutför: agenten skickar inte det proaktiva meddelandet när mottagaren har en aktiv konversation. Statuskod 300 kommer att returneras.

  • Skicka inte och misslyckas: agenten skickar inte det proaktiva meddelandet när mottagaren är i en aktiv konversation. Flödeskörningen markeras som ett fel.

När mottagaren inte har installerat agenten

Agenten kan bara leverera meddelanden eller kort till mottagare som har installerat agenten i Microsoft Teams. Mottagare vill kanske inte installera agenten eller har avinstallerat agenten.

För meddelanden med lägre betydelse kan du ställa in att flödeskörningen ska markeras som lyckad även när mottagaren inte har agenten installerad.

Om rutan Om roboten inte har installerats kan du kontrollera hur den fungerar:

  • Misslyckades: körningen av flödet markeras som ett fel när mottagaren inte har installerat agenten i Microsoft Teams.

  • Lyckas med statuskoden: flödeskörningen markeras som lyckas även om mottagaren inte kan ta emot meddelandet eftersom de inte har installerat agenten. Statuskod 100 kommer att returneras.

Definition av statuskod

Du kan använda den returnerade statuskoden för att definiera olika uppföljningsbeteenden i ditt flöde. Du kan till exempel ange att flödet ska försöka igen under en tidsperiod eller logga en post om felet.

Statuskod Slutförd (boolesk) Description
200 Sant Meddelande levereras korrekt.
100 Falsk Det gick inte att leverera meddelande eftersom mottagaren inte har installerat agenten.
300 Falsk Meddelande kunde inte levereras eftersom mottagaren är i en aktiv konversation med agenten.
  • Last updated on