Posten einer Nachrichtenkarte mit Aktionen in einer Office 365-GruppePost an actionable message card to an Office 365 group

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 HttpPOST-Aktion und einer OpenUri-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 HttpPOST action and an OpenUri action. We'll use the Card Playground to design the card.

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

{
  "@context": "http://schema.org/extensions",
  "@type": "MessageCard",
  "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. Sie können sich die Nachrichtenkartenreferenz 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 über Office 365-ConnectorsSending actionable messages via Office 365 Connectors

Connectors verwenden Webhooks zum Erstellen von Connectorkartennachrichten innerhalb einer Office 365-Gruppe. Entwickler können diese Karten durch Senden einer HTTP-Anforderung mit einer einfachen JSON-Arbeitslast an eine Webhook-Adresse einer Office 365-Gruppe erstellen. Versuchen wir nun, einige einfache Karten in einer Gruppe zu posten.Connectors use webhooks to create Connector Card messages within an Office 365 group. Developers can create these cards by sending an HTTP request with a simple JSON payload to an Office 365 group webhook address. Let's try posting some basic cards to a group.

Sie benötigen ein Office 365-Abonnement, um fortzufahren. Wenn Sie nicht über ein Office 365-Abonnement verfügen, können Sie ein KOSTENLOSES Office 365-Abonnement für ein Jahr unter dem Office 365-Entwicklerprogramm abschließen. Wenn Sie über ein vorhandenes MSDN-Abonnement verfügen, können Sie Ihren kostenlosen Office 365-Vorteil aktivieren.You'll need an Office 365 subscription to proceed. If you do not have an Office 365 subscription you can get a one year FREE Office 365 Subscription under the Office 365 Developer Program. Alternately, if you have an existing MSDN subscription, you can activate your free Office 365 benefit.

Abrufen einer Connector-Webhook-URL für Ihren PosteingangGet a connector webhook URL for your Inbox

  1. Melden Sie sich bei der Office 365-Mail-App an unter https://outlook.office.com. Klicken Sie auf das Zahnradsymbol in der oberen rechten Ecke der Seite, und wählen Sie Integration verwalten aus.Log on to the Office 365 Mail app at https://outlook.office.com. Click the gear icon in the upper-right-hand corner of the page, and select Manage Integrations.

  2. Wählen Sie im Popup Connectors aus.Choose Connectors in the popup.

  3. Suchen Sie in der Liste verfügbarer Connectors den Connector Eingehender Webhook, und wählen Sie Hinzufügen aus.Locate the Incoming Webhook connector in the list of available connectors, and choose Add.

    Screenshot des Elements „Eingehender Webhook“ in der Liste verfügbarer Connectors

  4. Geben Sie einen Namen für diesen Connector ein, und wählen Sie Erstellen aus.Enter a name for this connector and choose Create.

    Screenshot der Seite für zum Erstellen des eingehenden Webhooks

  5. Kopieren Sie die Webhook-URL, die angezeigt wird, und speichern Sie sie. Klicken Sie auf Fertig.Copy the webhook URL that is displayed and save it. Choose Done.

    Screenshot der URL des eingehenden Webhooks

Die Webhook-URL sollte in etwa wie folgt aussehen:The webhook URL should look simliar to the following:

https://outlook.office365.com/webhook/a1269812-6d10-44b1-abc5-b84f93580ba0@9e7b80c7-d1eb-4b52-8582-76f921e416d9/IncomingWebhook/3fdd6767bae44ac58e5995547d66a4e4/f332c8d9-3397-4ac5-957b-b8e3fc465a8c

Senden der NachrichtSend the message

Verwenden Sie Postman, um eine Nachrichtenlast mit Aktionen in der Webhook-URL zu posten. Öffnen Sie Postman. Erstellen Sie bei Bedarf eine neue Registerkarte, und konfigurieren Sie die Registerkarte wie folgt:Use Postman to post an actionable message payload to the webhook URL. Open Postman. Create a new tab if needed and configure the tab as follows:

  • Klicken Sie auf GET, und ändern Sie dies in POST.Click the GET and change to POST.
  • Klicken Sie in das Textfeld mit der Bezeichnung Enter request URL, und fügen Sie die Webhook-URL ein.In the text box labeled Enter request URL paste the webhook URL.
  • Klicken Sie unterhalb der URL auf Body, und wählen Sie dann die Option raw.Click Body underneath the URL, then select the raw option.
  • Klicken Sie auf Text, und ändern Sie dies in JSON (application/json).Click Text and change to JSON (application/json).
  • Geben Sie den JSON-Code der Nachrichtenkarte im Textbereich unten ein.Enter the message card JSON in the text area below.

Wenn Sie fertig sind, sollte das Postman-Fenster wie folgt aussehen:The Postman window should look like this when you are done:

Das Postman-Anforderungsfenster, das so konfiguriert ist, dass eine Beispielnachricht mit Aktionen in einer Webhook-URL gepostet wird

Klicken Sie auf Senden, um die Nachricht zu posten.Click Send to post the message.