Erste Schritte mit Nachrichten mit Aktionen in Office 365

Wichtig

Aktionen erfordernde Nachrichten verwenden Microsoft Entra ID-basierte Tokenauthentifizierung. Der Übergang von der Legacyauthentifizierung (EAT) wurde am 8. Juni 2026 abgeschlossen. Die Legacyauthentifizierung wird nicht mehr unterstützt.

Integrationen, die nicht aktualisiert wurden, um Microsoft Entra ID Token zu verwenden, funktionieren nicht mehr. Partner müssen Entra ID-basierte Tokenauthentifizierung für alle Integrationen von Aktionen erfordernden Nachrichten verwenden. Weitere Informationen finden Sie unter Aktivieren Microsoft Entra ID Tokens für Aktionen erfordernde Nachrichten.

Wichtig

Das Anbieterportal für aktionenfähige Nachrichten wurde an einen neuen Speicherort verschoben. Besuchen Sie das neue Portal.

Unterstützte Szenarien

In den folgenden Szenarien können Sie Aktionen erfordernde Nachrichten per E-Mail senden.

Der Empfänger muss eine Einzelperson sein (keine Gruppe).
Der Empfänger muss in der Nachricht angezeigt werden. Platzieren Sie den Empfänger nicht in das BCC-Feld.
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 mithilfe des Cmdlets Set-OrganizationConfig deaktivieren. Wenn Nachrichten mit Aktionen nicht gerendert werden, wenden Sie sich an Ihren Administrator, um sicherzustellen, dass das Feature in Ihrem organization aktiviert ist.

Erstellen einer Nachrichtenkarte mit Aktionen

Beginnen wir mit einem einfachen Karte mit einer Action.Http Aktion und einer Action.OpenUrl Aktion. Verwenden Sie die Designer Actionable Message, um die Karte zu entwerfen.Use the Actionable Message Designer to design the Karte.

Wichtig

Das Beispielkartenmarkup in diesem Thema lässt die originator-Eigenschaft aus. Diese Auslassung funktioniert in einem Testszenario, in dem der Empfänger mit dem Absender identisch ist. Wenn Sie Nachrichten mit Aktionen an andere Personen senden, legen Sie die originator Eigenschaft auf eine gültige Anbieter-ID fest, die vom Actionable Email Developer Dashboard generiert wird. Wenn Sie diese Eigenschaft beim Senden an andere Personen leer lassen, wird die Karte entfernt.

Wechseln Sie zum Designer Actionable Message, 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 über eine Karte Sie zufrieden sind, können Sie mit dem Senden fortfahren.

Senden von Nachrichten mit Aktionen per E-Mail

Wichtig

Verwenden Sie zum Entwerfen und Testen von Nachrichten mit Aktionen die Designer. Es sendet Nachrichten mit Aktionen an Sie. Sie können auch den Office 365 SMTP-Server verwenden, um Aktionen erfordernde Nachrichten an sich selbst zu senden. Sie können keine Nachrichten mit Aktionen an andere Benutzer senden, bis Sie sich über die Entwicklernachrichten mit Aktionen Dashboard registrieren.

Um eine Nachricht mit Aktionen Karte in eine E-Mail-Nachricht einzubetten, umschließen Sie die Karte in ein <script> Tag. Fügen Sie das <script> -Tag in den <head> des HTML-Texts der E-Mail ein.

Hinweis

Da Sie die Karte JSON in einem <script> Tag umschließen müssen, muss der Text der E-Mail mit Aktionen html sein. 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. Legen Sie das Attribut auf fest true , 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 die Legacynachricht Karte Format anstelle des Adaptiven Kartenformats verwenden, muss der <script> Tagtyp seinapplication/ld+json.

<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 dem HTML-Code als Text.

Senden der Nachricht

Beispiele für das Senden von Nachrichten finden Sie in den folgenden Ressourcen:

Nachricht mit Aktionen über Microsoft Graph senden: Eine in C# geschriebene Beispielkonsolen-App, die mithilfe von Microsoft Graph eine Nachricht mit Aktionen sendet.
Nachricht mit Aktionen über SMTP senden: Ein Python-Beispielskript, das mithilfe des Office 365 SMTP-Servers eine Umsetzbare Nachricht sendet. Er enthält außerdem eine beispielhafte HTM-Nutzlast für Aktion erfordernden Nachrichtentext.

Ausführen von Aktionen

Beispiele zum Ausführen von Aktionen finden Sie in den folgenden Ressourcen:

Hello Actionable Messages: Ein Beispielprojekt mit 1-Klick-Azure Bereitstellung. Dieses Beispiel ist eine einfache End-to-End-Lösung für aktionenfähige Nachrichten, die Sie innerhalb von 10 Minuten einrichten und verwenden können. Sie dient als Referenz zum Erstellen eines Produktionsaktionsendpunkts.

Tools zur Problembehandlung

Debugger für Aktionen erfordernde Nachrichten: Ein Outlook-Add-In, mit dem Entwickler die Karte Nutzlast in ihren Aktionen erfordernden Nachrichten untersuchen und ermitteln, warum die Karte nicht gerendert wird.

Feedback

War diese Seite hilfreich?

Last updated on 2026-06-28

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