Senden einer Nachricht mit Aktionen per E-Mail in Office 365Send an actionable message via email in Office 365

Unterstützte SzenarienSupported Scenarios

Das Senden von nutzbaren Nachrichten per E-Mail wird in den folgenden Szenarien unterstützt.Sending actionable messages via email is supported in the following scenarios.

  • Der Empfänger muss eine Einzelperson sein (keine Gruppe).The recipient must be an individual, not a group.
  • Der Empfänger muss in der Nachricht angezeigt werden.The recipient must be visible on the message. Setzen Sie den Empfänger nicht in das Feld „BCC“.Do not put the recipient in the BCC field.
  • Der Empfänger muss ein Postfach in Outlook.com oder Exchange Online in Office 365 haben.The recipient must have a mailbox on Outlook.com or Exchange Online in Office 365.

Erstellen einer Nachrichtenkarte mit AktionenCreate an actionable message card

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 den Karten-Playground, um die Karte zu gestalten.Let's start by creating an actionable message card. We'll start with something simple, just a basic card with an Action.Http action and an Action.OpenUrl action. We'll use the Card Playground to design the card.

Wichtig

Das Beispielkartenmarkup in diesem Thema lässt die originator-Eigenschaft aus.The sample card markup in this topic omits the originator property. Dies funktioniert in einem Testszenario, bei dem der Empfänger mit dem Absender identisch ist.This works in a testing scenario, where the recipient is the same as the sender. 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.When sending actionable messages to anyone else, the originator property must be set to a valid provider ID generated by the Actionable Email Developer Dashboard. Wenn kein Wert für diese Eigenschaft beim Senden an andere Benutzer angegeben wird, wird die Karte entfernt.Leaving this property empty when sending to others results in the card being removed.

Wechseln Sie zum Karten-Playground, und fügen Sie Folgendes in den folgenden JSON ein:Go to the Card Playground and paste in the following JSON:

{
  "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://docs.microsoft.com/outlook/actionable-messages"
    }
  ]
}

Experimentieren Sie mit diesem einfachen Beispiel im Playground herum. Sie können sich die adaptive Kartenreferenz ansehen, um detaillierte Informationen zu den verfügbaren Feldern zu erhalten. Wenn Sie mit der Karte zufrieden sind, können Sie fortfahren und sie senden.Feel free to experiment with this simple example in the playground. You can see the adaptive card reference for details on the available fields. Once you have a card you're happy with, you can move on to sending it.

Senden von Nachrichten mit Aktionen per E-MailSending actionable messages via email

Wichtig

Sie können Nachrichten mit Aktionen mithilfe des Karten-Playgrounds entwerfen und testen, mit dem 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.You can design and test actionable messages by using the Card Playground, which allows you to send actionable messages to yourself. You can also send actionable messages to yourself using the Office 365 SMTP server. You will be unable to send actionable messages to any other user until you have registered using the actionable messages developer dashboard.

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.To embed an actionable message card in an email message, we need to wrap the card in a <script> tag. The <script> tag is then inserted into the <head> of the email's HTML body.

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.Because the card JSON must be wrapped in a <script> tag, the body of the actionable message email MUST be HTML. Plain-text messages are not supported.

  1. 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.Add the hideOriginalBody attribute to control what happens with the body of the email. In this case we'll set the attribute to true so that the body will not be shown.

    {
      "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://docs.microsoft.com/outlook/actionable-messages"
        }
      ]
    }
    
  2. Schließen Sie den resultierenden JSON-Code in ein <script>-Tag des Typs application/adaptivecard+json ein.Wrap the resulting JSON in a <script> tag of type application/adaptivecard+json.

    Hinweis

    Wenn Sie dasLegacy-Nachrichtenkartenformat verwenden statt dem adaptiven Kartenformat, <script> muss der Tagtyp application/ld+json sein.If you are using the legacy message card format rather than the Adaptive card format, the <script> tag type MUST be application/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://docs.microsoft.com/outlook/actionable-messages"
        }
      ]
    }
    </script>
    
  3. Generieren Sie ein HTML-Dokument, um den Textkörper der E-Mail darzustellen, und schließen Sie das <script>-Tag in <head> ein.Generate an HTML document to represent the email body and include the <script> tag in the <head>.

    <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://docs.microsoft.com/outlook/actionable-messages"
          }
        ]
      }
      </script>
    </head>
    <body>
    Visit the <a href="https://docs.microsoft.com/outlook/actionable-messages">Outlook Dev Portal</a> to learn more about Actionable Messages.
    </body>
    </html>
    
  4. Senden Sie eine Nachricht über SMTP mit der HTML als Textkörper.Send a message via SMTP with the HTML as the body.

Senden der NachrichtSending the message

Beispiele zum Senden von Nachrichten finden Sie in den folgenden Themen.For examples of sending messages, see the following.

Ausführen von AktionenPerform actions

Beispiele für das Ausführen von Aktionen finden Sie in den folgenden Artikeln.For examples of performing actions, see the following.

  • Aktionen erfordernde Hello-Nachrichten: Ein Beispielprojekt mit Ein-Klick-Bereitstellung in Azure.Hello Actionable Messages: A sample project with one-click button Azure deployment. 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.This sample is a simple end-to-end actionable message solution that can be up and working within 10 minutes, and serves as a reference for building a production action endpoint.

Tools zur ProblembehandlungTroubleshooting tools

  • 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.Actionable Messages Debugger: an Outlook add-in that allows developers to inspect the card payload in their actionable messages and identify why the card is not rendering.