Připojení robota do kanálu Outlooku pro zprávy s možností akce (Preview)

  • Článek

PLATÍ PRO: SDK v4

Zprávy s možností reakce umožňují uživatelům provádět rychlé akce z Outlooku. Když robota připojíte ke kanálu Zprávy s možností akcí Outlooku, může robot pomocí adaptivních karet vytvářet zprávy s možností akcí a zvýšit zapojení uživatelů.

Poznámka:

Kanál Outlooku pro zprávy s možností akce je ve verzi Public Preview. Funkce zahrnuté ve verzi Preview nemusí být dokončené a před zpřístupněním ve veřejné verzi můžou projít změnami. Jsou poskytovány pouze pro účely vyhodnocení a průzkumu.

Upozorňující

Jedná se o porušení pravidla chování služby Bot Framework k vytvoření "spambotů", včetně robotů, kteří odesílají nežádoucí nebo nevyžádané hromadné e-maily.

Předpoklady

  • Znalost adaptivních karet a univerzálního akčního modelu
  • Znalost zpráv s možností akce v Outlooku a skupinách Office 365
  • Robot připravený pro kanál nasazený do Azure.
  • Vyhrazená e-mailová adresa, kterou robot použije k odesílání a přijímání zpráv.

Poznámka:

  • Nepoužívejte vlastní osobní e-mailové účty pro roboty, protože každá zpráva odeslaná do daného e-mailového účtu se robotovi přepošle. To může vést k tomu, že robot nesprávně odesílá odpověď odesílateli. Z tohoto důvodu by roboti měli používat jenom vyhrazené e-mailové účty O365.
  • Pokud používáte Microsoft Exchange Server, před konfigurací e-mailového kanálu povolte automatickou konfiguraci.

Návrh zpráv

Kanál Outlooku pro zprávy s možností akce odesílá a přijímá adaptivní karty prostřednictvím e-mailu.

Pomocí Návrháře zpráv s možností akce můžete navrhovat a testovat karty zpráv s možností akce.

Důležité

Model akcí univerzálního robota se zavádí ve schématu adaptivních karet verze 1.4. Pokud chcete tyto nové funkce použít, měla by být vlastnost verze adaptivní karty nastavená na hodnotu 1.4 nebo novější. Viz Action.Execute v Průzkumníku schémat adaptivních karet.

Implementace a nasazení robota

Obecný postup je, aby robot odeslal uživateli zprávu s možností akce a pak zpracová akci uživatele.

  1. Když uživatel odpoví na kartu v e-mailu, Outlook odešle do robota aktivitu vyvolání. Vlastnost aktivity value obsahuje objekt akce s type, verba data vlastnosti. Aktivita by například obsahovala následující informace, kde příkaz a data odpovídají informacím na kartě, která robot původně odeslal.

    "type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}

    Kompletní schéma objektu najdete v Části Action.Execute v Průzkumníku schémat adaptivních karet.

  2. Robot zpracovává příchozí aktivitu vyvolání a vrací výsledek, který obsahuje novou adaptivní kartu, která bude místo původní adaptivní karty. Odpověď vyvolání může vypadat takto:

    {
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}

Vyžádat si přístup

  1. Na webu Azure Portal otevřete prostředek robota.
  2. Otevřete podokno Kanály.
  3. Vyberte kanál Outlooku.
  4. Na stránce Konfigurovat Outlook vyberte prosím zaregistrovat se tady.
  5. Vyplňte registrační formulář a požádejte o přístup. Další informace najdete v tématu Registrace služby na řídicím panelu pro vývojáře e-mailu s možností akce.

Další kroky