Senden einer Nachricht mit Aktionen per E-Mail in Office 365

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 HttpPOST-Aktion und einer OpenUri-Aktion. Wir verwenden den Karten-Playground, um die Karte zu gestalten.

Wechseln Sie zum Karten-Playground, und fügen Sie in den folgenden JSON-Code ein:

{
  "@context": "http://schema.org/extensions",
  "@type": "MessageCard",
  "originator": "",
  "themeColor": "0072C6",
  "title": "Visit the Outlook Dev Portal",
  "text": "Click **Learn More** to learn more about Actionable Messages!",
  "potentialAction": [
    {
      "@type": "ActionCard",
      "name": "Send Feedback",
      "inputs": [
        {
          "@type": "TextInput",
          "id": "feedback",
          "isMultiline": true,
          "title": "Let us know what you think about Actionable Messages"
        }
      ],
      "actions": [
        {
          "@type": "HttpPOST",
          "name": "Send Feedback",
          "isPrimary": true,
          "target": "http://..."
        }
      ]
    },
    {
      "@type": "OpenUri",
      "name": "Learn More",
      "targets": [
        { "os": "default", "uri": "https://docs.microsoft.com/en-us/outlook/actionable-messages" }
      ]
    }
  ]
}

Experimentieren Sie mit diesem einfachen Beispiel im Playground herum. Sie können sich die 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.

Senden von Nachrichten mit Aktionen per E-Mail

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.

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.

  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.

    {
      "@context": "http://schema.org/extensions",
      "@type": "MessageCard",
      "originator": "",
      "hideOriginalBody": "true",
      "themeColor": "0072C6",
      "title": "Visit the Outlook Dev Portal",
      "text": "Click **Learn More** to learn more about Actionable Messages!",
      "potentialAction": [
        {
          "@type": "ActionCard",
          "name": "Send Feedback",
          "inputs": [
            {
              "@type": "TextInput",
              "id": "feedback",
              "isMultiline": true,
              "title": "Let us know what you think about Actionable Messages"
            }
          ],
          "actions": [
            {
              "@type": "HttpPOST",
              "name": "Send Feedback",
              "isPrimary": true,
              "target": "http://..."
            }
          ]
        },
        {
          "@type": "OpenUri",
          "name": "Learn More",
          "targets": [
            { "os": "default", "uri": "https://docs.microsoft.com/en-us/outlook/actionable-messages" }
          ]
        }
      ]
    }
    
  2. Schließen Sie den resultierenden JSON-Code in ein <script>-Tag des Typs application/ld+json ein.

    <script type="application/ld+json">{
      "@context": "http://schema.org/extensions",
      "@type": "MessageCard",
      "originator": "",
      "hideOriginalBody": "true",
      "themeColor": "0072C6",
      "title": "Visit the Outlook Dev Portal",
      "text": "Click **Learn More** to learn more about Actionable Messages!",
      "potentialAction": [
        {
          "@type": "ActionCard",
          "name": "Send Feedback",
          "inputs": [
            {
              "@type": "TextInput",
              "id": "feedback",
              "isMultiline": true,
              "title": "Let us know what you think about Actionable Messages"
            }
          ],
          "actions": [
            {
              "@type": "HttpPOST",
              "name": "Send Feedback",
              "isPrimary": true,
              "target": "http://..."
            }
          ]
        },
        {
          "@type": "OpenUri",
          "name": "Learn More",
          "targets": [
            { "os": "default", "uri": "https://docs.microsoft.com/en-us/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 die <head> ein.

    <html>
    <head>
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
      <script type="application/ld+json">{
        "@context": "http://schema.org/extensions",
        "@type": "MessageCard",
        "originator": "",
        "hideOriginalBody": "true",
        "themeColor": "0072C6",
        "title": "Visit the Outlook Dev Portal",
        "text": "Click **Learn More** to learn more about Actionable Messages!",
        "potentialAction": [
          {
            "@type": "ActionCard",
            "name": "Send Feedback",
            "inputs": [
              {
                "@type": "TextInput",
                "id": "feedback",
                "isMultiline": true,
                "title": "Let us know what you think about Actionable Messages"
              }
            ],
            "actions": [
              {
                "@type": "HttpPOST",
                "name": "Send Feedback",
                "isPrimary": true,
                "target": "http://..."
              }
            ]
          },
          {
            "@type": "OpenUri",
            "name": "Learn More",
            "targets": [
              { "os": "default", "uri": "https://docs.microsoft.com/en-us/outlook/actionable-messages" }
            ]
          }
        ]
      }
      </script>
    </head>
    <body>
    Visit the <a href="https://docs.microsoft.com/en-us/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.

Senden der Nachricht

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