Publier une carte de message actionnable sur un groupe Office 365Post an actionable message card to an Office 365 group

Création d’une carte de message intégrant des actionsCreate an actionable message card

Commençons par créer une carte de message intégrant des actions. Nous allons commencer par quelque chose de simple, juste une carte de base avec une action HttpPOST et une action OpenUri. Nous allons utiliser l’aire de jeu de carte pour concevoir la carte.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.

Important

Les connecteurs Office prennent uniquement en charge le format MessageCard hérité pour les cartes.Office connectors only support the legacy MessageCard format for cards. Ils ne prennent pas en charge le format de carte adaptatif.They do not support the Adaptive Card format.

Accédez à Aire de jeu de carte et collez-la dans le JSON suivant :Go to Card Playground and paste in the following JSON:

{
  "@context": "https://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/outlook/actionable-messages" }
      ]
    }
  ]
}

Vous pouvez librement utiliser cet exemple dans l’aire de jeu. Vous pouvez visualiser la référence de carte de message pour plus d’informations relatives aux champs disponibles. Une fois que vous disposez d’une carte qui vous convient, vous pouvez l’envoyer.Feel free to experiment with this simple example in the playground. You can see the message card reference for details on the available fields. Once you have a card you're happy with, you can move on to sending it.

Envoi de messages intégrant des actions via les connecteurs OfficeSending actionable messages via Office connectors

Les connecteurs utilisent des webhooks pour créer des messages de carte de connecteur au sein d’un groupe Office 365. Les développeurs peuvent créer ces cartes en envoyant une demande HTTP avec une charge utile JSON simple vers une adresse de webhook de groupe Office 365. Nous allons essayer de publier des cartes de base sur un groupe.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.

Pour continuer, vous avez besoin d’un abonnement Microsoft 365.You'll need an Microsoft 365 subscription to proceed. Si vous n’avez pas d’abonnement Microsoft 365, vous pouvez obtenir un abonnement Microsoft 365 GRATUIT valable un an dans le cadre du programme pour les développeurs Microsoft 365.If you do not have an Microsoft 365 subscription you can get a one year FREE Microsoft 365 subscription under the Microsoft 365 Developer Program.

Obtenir une URL de webhook de connecteur pour votre groupe Microsoft 365Get a connector webhook URL for a Microsoft 365 Group

  1. Connectez-vous à Outlook sur le web à l’adresse https://outlook.office.com.Log on to Outlook on the web at https://outlook.office.com.

  2. Dans la liste des dossiers, sélectionnez un groupe sous la section Groupes.In the folder list, select a group under the Groups section. Dans le menu du groupe, sélectionnez les points de suspension (...), puis sélectionnez Paramètres.In the group's menu, select the ellipses (...), then select Settings.

    Capture d’écran de l’emplacement du menu paramètres dans un groupe Microsoft 365

  3. Dans le volet Paramètres du groupe , sélectionnez Connecteurs.In the Group Settings pane, select Connectors.

  4. Recherchez et sélectionnez le connecteur Webhook entrant dans la liste des connecteurs disponibles.Locate and select the Incoming Webhook connector in the list of available connectors.

    Capture d’écran de l’élément Webhook entrant dans la liste des connecteurs disponibles

  5. Entrez un nom pour ce connecteur, puis choisissez Créer.Enter a name for this connector and choose Create.

  6. Copiez l’URL de webhook qui s’affiche et enregistrez-la. Choisissez OK.Copy the webhook URL that is displayed and save it. Choose Done.

    Capture d’écran de l’URL de webhook entrant

L’URL de webhook doit ressembler à l’exemple suivant :The webhook URL should look similar 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

Envoyer le messageSend the message

Utilisez Postman pour publier une charge utile de message intégrant des actions sur l’URL de webhook. Ouvrez Postman. Créer un onglet si nécessaire et configurez-le comme suit :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:

  1. Cliquez sur GET et remplacez-le par POST.Click the GET and change to POST.

  2. Dans la zone de texte intitulée Enter request URL, collez l’URL de webhook.In the text box labeled Enter request URL paste the webhook URL.

  3. Cliquez sur Corps en dessous de l’URL, puis sélectionnez l’option brut.Click Body underneath the URL, then select the raw option.

  4. Cliquez sur Texte et indiquez JSON (application/json).Click Text and change to JSON (application/json).

  5. Entrez le fichier JSON de carte de message dans la zone de texte ci-dessous.Enter the message card JSON in the text area below.

    La fenêtre Postman doit se présenter comme suit lorsque vous avez terminé :The Postman window should look like this when you are done:

    Fenêtre de demande Postman configurée pour publier un exemple de message intégrant des actions sur une URL de webhook

  6. Cliquez sur Envoyer pour publier le message.Click Send to post the message.