Verbinden Sie einen Bot mit Ihrem Outlook-Kanal für handlungsorientierte Nachrichten (Vorschau)

  • Artikel

GILT FÜR: SDK v4

Handlungsorientierte Nachrichten ermöglichen Benutzern, schnelle Aktionen in Outlook auszuführen. Wenn Sie einen Bot mit dem Outlook-Kanal für handlungsorintierte Nachrichten verbinden, kann Ihr Bot adaptive Karten verwenden, um handlungsorientierte Nachrichten zu erstellen und die Kundenbindung zu verbessern.

Hinweis

Der Outlook-Kanal für handlungsorientierte Nachrichten befindet sich in der öffentlichen Vorschau. Features, die in der Vorschau enthalten sind, sind möglicherweise nicht vollständig und werden gegebenenfalls geändert, bevor sie in der öffentlichen Version verfügbar sind. Sie werden nur für Auswertungs- und Erkundungszwecke bereitgestellt.

Warnung

Es verstößt gegen denVerhaltenskodex des Bot Framework, „Spambots“ zu erstellen. Dazu gehören Bots, die unerwünschte oder nicht angeforderte Massen-E-Mails senden.

Voraussetzungen

Hinweis

  • Verwenden Sie nicht Ihre persönlichen E-Mail-Konten für Bots, da jede an dieses E-Mail-Konto gesendete Nachricht an den Bot weitergeleitet wird. Dies kann dazu führen, dass der Bot eine unangemessene Antwort an einen Absender sendet. Aus diesem Grund sollten Bots nur dedizierte Office 365-E-Mail-Konten verwenden.
  • Stellen Sie bei Verwendung von Microsoft Exchange Server zunächst sicher, dass Sie die AutoErmittlung aktiviert haben, bevor Sie den E-Mail-Kanal konfigurieren.

Entwerfen der Nachrichten

Der Outlook-Kanal für handlungsorientierte Nachrichten sendet und empfängt adaptive Karten per E-Mail.

Sie können den Designer für handlungsorientierte Nachrichten für Aktionen verwenden, um Karten für handlungsorientierte Nachrichten zu entwerfen und testen.

Wichtig

Das universelle Bot-Aktionsmodell wird in der Schemaversion 1.4 für adaptive Karten eingeführt. Um diese neuen Funktionen zu verwenden, sollte die Versionseigenschaft Ihrer adaptiven Karten auf 1.4 oder höher festgelegt werden. Siehe Action.Execute im Schema-Explorer für adaptive Karten.

Bot implementieren und einsetzen

Der allgemeine Fluss für den Bot ist, eine handlungsorientierte Nachricht an einen Kunden zu senden und dann dessen Handlung zu verarbeiten.

  1. Wenn der Kunde auf die Karte in einer E-Mail antwortet, sendet Outlook eine Aufrufaktivität an den Bot. Die Eigenschaft der value Aktivität enthält ein Aktionsobjekt mit type, verbund data Eigenschaften. Die Aktivität würde z. B. die folgenden Informationen enthalten, wobei das Verb und die Daten Informationen über die Karte den ursprünglich gesendeten Bots entsprechen.

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

    Informationen zum vollständigen Objektschema finden Sie unter Action.Execute im Schema-Explorer für adaptive Karten.

  2. Der Bot verarbeitet die eingehende Aufrufaktivität und gibt ein Ergebnis zurück, das eine neue adaptive Karte enthält, die den Platz der ursprünglichen adaptiven Karte übernimmt. Die Aufrufantwort könnte wie folgt aussehen:

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

Zugriff anfordern

  1. Öffnen Sie Ihre Botressource im Azure-Portal.
  2. Öffnen Sie den Bereich Kanäle.
  3. Wählen Sie den Outlook-Kanal aus.
  4. Wählen Sie auf der Seite Outlook konfigurieren die Option bitte hier registrieren.
  5. Füllen Sie das Registrierungsformular aus, um den Zugriff anzufordern. Weitere Informationen finden Sie unter Dienst auf dem Entwicklerdashboard für handlungsorientierte E-Mails registrieren.

Nächste Schritte