Anslut en robot till Outlook-kanalen för åtgärdsbara meddelanden (förhandsversion)

Artikel
10/24/2023

GÄLLER FÖR: SDK v4

Åtgärdsbara meddelanden gör det möjligt för användare att vidta snabba åtgärder inifrån Outlook. När du ansluter en robot till outlook-kanalen Åtgärdsbara meddelanden kan din robot använda adaptiva kort för att skapa åtgärdsbara meddelanden, vilket förbättrar användarens engagemang.

Kommentar

Outlook-kanalen för åtgärdsbara meddelanden finns i offentlig förhandsversion. Funktioner som ingår i förhandsversionen kanske inte är fullständiga och kan genomgå ändringar innan de blir tillgängliga i den offentliga versionen. De tillhandahålls endast i utvärderings- och utforskningssyfte.

Varning

Det är ett brott mot Bot Frameworks uppförandekod för att skapa "spambots", inklusive robotar som skickar oönskade eller oönskade massutskick.

Förutsättningar

Kunskap om adaptiva kort och den universella åtgärdsmodellen.
Kunskaper om åtgärdsbara meddelanden i Outlook och Office 365-grupper.
En kanalklar robot som distribuerats till Azure.
En dedikerad e-postadress som roboten använder för att skicka och ta emot meddelanden.

Kommentar

Använd inte dina egna personliga e-postkonton för robotar eftersom varje meddelande som skickas till e-postkontot vidarebefordras till roboten. Detta kan leda till att roboten felaktigt skickar ett svar till en avsändare. Därför bör robotar endast använda dedikerade O365-e-postkonton.
Om du använder Microsoft Exchange Server aktiverar du Automatisk upptäckt innan du konfigurerar e-postkanalen.

Utforma meddelandena

Outlook-kanalen för åtgärdsbara meddelanden skickar och tar emot adaptiva kort via e-post.

Du kan använda Den åtgärdsbara meddelandedesignern för att utforma och testa åtgärdsbara meddelandekort.

Viktigt!

Den universella robotåtgärdsmodellen introduceras i schemat Adaptive Cards version 1.4. Om du vill använda dessa nya funktioner bör versionsegenskapen för ditt adaptiva kort anges till 1.4 eller senare. Se Action.Execute i Schemautforskaren för adaptiva kort.

Implementera och distribuera roboten

Det allmänna flödet är att roboten skickar ett åtgärdsbart meddelande till en användare och sedan hanterar användarens åtgärd.

När användaren svarar på kortet via e-post skickar Outlook en anropande aktivitet till roboten. Aktivitetens egenskap innehåller ett åtgärdsobjekt value med typeegenskaperna , verboch data . Aktiviteten skulle till exempel innehålla följande information, där verbet och data motsvarar information på kortet som roboten skickade ut från början.
```
"type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}
```
Se Action.Execute i Schemautforskaren för adaptiva kort för det fullständiga objektschemat.
Roboten hanterar den inkommande anropsaktiviteten och returnerar ett resultat som innehåller ett nytt adaptivt kort som ersätter det ursprungliga adaptiva kortet. Anropssvaret kan se ut så här:
```
{
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}
```

Begär åtkomst

Öppna robotresursen i Azure-portalen.
Öppna fönstret Kanaler .
Välj Outlook-kanalen.
På sidan Konfigurera Outlook väljer du registrera dig här.
Fyll i registreringsformuläret för att begära åtkomst. Mer information finns i Registrera din tjänst med instrumentpanelen för e-postutvecklare.

Nästa steg

Läs mer om åtgärdsbara meddelanden i Outlook och Office 365-grupper.
Läs mer om adaptiva kort för Outlook Åtgärdsbara meddelandeutvecklare

Dela via