Senden einer Nachricht mit Aktionen per E-Mail in Office 365Send an actionable message via email 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 uses an empty string in 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 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 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.You can design and test actionable messages by using the Card Playground, which allows you to send actionable messages to yourself. Sie können Nachrichten mit Aktionen auch über den Office 365-SMTP-Server an sich selbst senden.You can also send actionable messages to yourself using the Office 365 SMTP server. 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 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.Because the card JSON must be wrapped in a <script> tag, the body of the actionable message email MUST be HTML. Nur-Text-Nachrichten werden nicht unterstützt.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.