Erste Schritte mit Nachrichten mit Aktionen in Office 365

Artikel
10/31/2024

Wichtig

Das Onboarding von neuen Anbietern für aktionenfähige Nachrichten im Global-Bereich wird aufgrund von Dienstupgrades vorübergehend bis zum 30. Juni 2024 angehalten. Vorhandene globale Anbieter und das Onboarding von Organisations- und Testbereichsanbietern sind nicht betroffen. Weitere Informationen finden Sie unter Häufig gestellte Fragen zu Aktionen erfordernden Nachrichten.

Unterstützte Szenarien

Das Senden von nutzbaren Nachrichten per E-Mail wird in den folgenden Szenarien unterstützt.

Der Empfänger muss eine Einzelperson sein (keine Gruppe).
Der Empfänger muss in der Nachricht angezeigt werden. Setzen Sie den Empfänger nicht in das Feld „BCC“.
Der Empfänger muss ein Postfach in Outlook.com oder Exchange Online in Office 365 haben.

Hinweis

Office 365-Administratoren können Aktionen erfordernde Nachrichten über das Cmdlet Set-OrganizationConfig deaktivieren. Wenn Aktionen erfordernde Nachrichten nicht gerendert werden, wenden Sie sich an den Administrator, um sicherzustellen, dass die Funktion in Ihrer Organisation aktiviert ist.

Erstellen einer Nachrichtenkarte mit Aktionen

Beginnen wir mit dem Erstellen einer Nachrichtenkarte mit Aktionen. Wir beginnen mit einem einfachen Beispiel, eine einfache Karte mit einer Action.Http-Aktion und einer Action.OpenUrl-Aktion. Wir verwenden die Designer für aktionenfähige Nachrichten, um die Karte zu entwerfen.

Wichtig

Das Beispielkartenmarkup in diesem Thema lässt die originator-Eigenschaft aus. Dies funktioniert in einem Testszenario, bei dem der Empfänger mit dem Absender identisch ist. Beim Senden von Nachrichten mit Aktionen an andere Benutzer muss die originator-Eigenschaft auf eine gültige Anbieter-ID festgelegt werden, die von dem Entwicklerdashboard für E-Mails mit Aktionen generiert wird. Wenn kein Wert für diese Eigenschaft beim Senden an andere Benutzer angegeben wird, wird die Karte entfernt.

Wechseln Sie zum Designer Nachricht mit Aktionen, und fügen Sie den folgenden JSON-Code ein:

{
  "type": "AdaptiveCard",
  "version": "1.0",
  "body": [
    {
      "type": "TextBlock",
      "text": "Visit the Outlook Dev Portal",
      "size": "large"
    },
    {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
    },
    {
      "type": "Input.Text",
      "id": "feedbackText",
      "placeholder": "Let us know what you think about Actionable Messages"
    }
  ],
  "actions": [
    {
      "type": "Action.Http",
      "title": "Send Feedback",
      "method": "POST",
      "url": "https://...",
      "body": "{{feedbackText.value}}"
    },
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}

Experimentieren Sie gerne mit diesem einfachen Beispiel im Designer. Ausführliche Informationen zu den verfügbaren Feldern finden Sie in der Referenz zu adaptiven Karte. Wenn Sie mit der Karte zufrieden sind, können Sie fortfahren und sie senden.

Senden von Nachrichten mit Aktionen per E-Mail

Wichtig

Sie können Aktionen erfordernde Nachrichten entwerfen und testen, indem Sie die Designer für aktionenfähige Nachrichten verwenden, mit denen Sie Nachrichten mit Aktionen an sich selbst senden können. Sie können Nachrichten mit Aktionen auch über den Office 365-SMTP-Server an sich selbst senden. Sie können Nachrichten mit Aktionen erst dann an andere Benutzer senden, nachdem Sie sich mithilfe des Entwicklerdashboards für Nachrichten mit Aktionen registriert haben.

Um eine Nachrichtenkarte mit Aktionen in eine E-Mail-Nachricht einzubetten, muss die Karte in einem <script>-Tag eingeschlossen werden. Das <script>-Tag wird dann in <head> des HTML-Textkörpers der E-Mail eingefügt.

Hinweis

Da die JSON der Karte in ein <script>-Tag eingeschlossen werden muss, muss der Textkörper der E-Mail mit Aktionen aus HTML bestehen. Nur-Text-Nachrichten werden nicht unterstützt.

Fügen Sie das hideOriginalBody-Attribut hinzu, um zu steuern, was mit dem Textkörper der E-Mail passiert. In diesem Fall legen wir das Attribut auf true fest , damit der Text nicht angezeigt wird.

{
  "type": "AdaptiveCard",
  "version": "1.0",
  "hideOriginalBody": true,
  "body": [
    {
      "type": "TextBlock",
      "text": "Visit the Outlook Dev Portal",
      "size": "large"
    },
    {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
    },
    {
      "type": "Input.Text",
      "id": "feedbackText",
      "placeholder": "Let us know what you think about Actionable Messages"
    }
  ],
  "actions": [
    {
      "type": "Action.Http",
      "title": "Send Feedback",
      "method": "POST",
      "url": "https://...",
      "body": "{{feedbackText.value}}"
    },
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}

Schließen Sie den resultierenden JSON-Code in ein <script>-Tag des Typs application/adaptivecard+json ein.

Hinweis

Wenn Sie dasLegacy-Nachrichtenkartenformat verwenden statt dem adaptiven Kartenformat, <script> muss der Tagtyp application/ld+json sein.

<script type="application/adaptivecard+json">{
  "type": "AdaptiveCard",
  "version": "1.0",
  "hideOriginalBody": true,
  "body": [
    {
      "type": "TextBlock",
      "text": "Visit the Outlook Dev Portal",
      "size": "large"
    },
    {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
    },
    {
      "type": "Input.Text",
      "id": "feedbackText",
      "placeholder": "Let us know what you think about Actionable Messages"
    }
  ],
  "actions": [
    {
      "type": "Action.Http",
      "title": "Send Feedback",
      "method": "POST",
      "url": "https://...",
      "body": "{{feedbackText.value}}"
    },
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}
</script>

Generieren Sie ein HTML-Dokument, um den Textkörper der E-Mail darzustellen, und schließen Sie das <script>-Tag in <head> ein.

<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <script type="application/adaptivecard+json">{
    "type": "AdaptiveCard",
    "version": "1.0",
    "hideOriginalBody": true,
    "body": [
      {
        "type": "TextBlock",
        "text": "Visit the Outlook Dev Portal",
        "size": "large"
      },
      {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
      },
      {
        "type": "Input.Text",
        "id": "feedbackText",
        "placeholder": "Let us know what you think about Actionable Messages"
      }
    ],
    "actions": [
      {
        "type": "Action.Http",
        "title": "Send Feedback",
        "method": "POST",
        "url": "https://...",
        "body": "{{feedbackText.value}}"
      },
      {
        "type": "Action.OpenUrl",
        "title": "Learn More",
        "url": "https://learn.microsoft.com/outlook/actionable-messages"
      }
    ]
  }
  </script>
</head>
<body>
Visit the <a href="https://learn.microsoft.com/outlook/actionable-messages">Outlook Dev Portal</a> to learn more about Actionable Messages.
</body>
</html>

Senden Sie eine Nachricht über SMTP mit der HTML als Textkörper.

Senden der Nachricht

Beispiele zum Senden von Nachrichten finden Sie in den folgenden Themen.

Senden einer Nachricht mit Aktionen über Microsoft Graph: Eine Beispiel-Konsolen-App, geschrieben in C#, die eine Nachricht mit Aktionen mithilfe von Microsoft Graph sendet.
Senden einer Nachricht mit Aktionen per SMTP: Ein Beispiel-Python-Skript, das eine Nachricht mit Aktionen mithilfe des Office 365-SMTP-Servers sendet. Er enthält außerdem eine beispielhafte HTM-Nutzlast für Aktion erfordernden Nachrichtentext.

Ausführen von Aktionen

Beispiele für das Ausführen von Aktionen finden Sie in den folgenden Artikeln.

Aktionen erfordernde Hello-Nachrichten: Ein Beispielprojekt mit Ein-Klick-Bereitstellung in Azure. Bei diesem Beispiel handelt es sich um eine einfache End-to-End-Lösung mit Aktionen erfordernden Nachrichten, die innerhalb von 10 Minuten einsatzbereit ist und als Referenz zum Erstellen eines Aktions-Endpunkts für die Produktion dient.

Tools zur Problembehandlung

Debugger für Aktionen erfordernde Nachrichten: Outlook-Add-In, mit dem Entwickler die Kartennutzlast in Aktionen erfordernden Nachrichten prüfen und erkennen können, warum die Karte nicht gerendert wird.

Freigeben über

Erste Schritte mit Nachrichten mit Aktionen in Office 365

Unterstützte Szenarien

Erstellen einer Nachrichtenkarte mit Aktionen

Senden von Nachrichten mit Aktionen per E-Mail

Senden der Nachricht

Ausführen von Aktionen

Tools zur Problembehandlung

Feedback

Zusätzliche Ressourcen