Prise en main des messages appelant une action dans Office 365

Importante

Les messages actionnables utilisent l’authentification par jeton Microsoft Entra ID. La transition à partir de l’authentification héritée (EAT) s’est terminée le 8 juin 2026. L’authentification héritée n’est plus prise en charge.

Les intégrations qui n’ont pas été mises à jour pour utiliser Microsoft Entra ID jetons ne fonctionnent plus. Les partenaires doivent utiliser l’authentification par jeton basée sur Entra ID pour toutes les intégrations de messages actionnables. Pour plus d’informations, consultez Activer Microsoft Entra ID jeton pour les messages actionnables.

Importante

Le portail du fournisseur de messages actionnables a été déplacé vers un nouvel emplacement. Visitez le nouveau portail.

Scénarios pris en charge

Vous pouvez envoyer des messages actionnables par e-mail dans les scénarios suivants.

  • Le destinataire doit être une personne et non un groupe.
  • Le destinataire doit être visible sur le message. Ne placez pas le destinataire dans le champ CCI.
  • Le destinataire doit disposer d’une boîte aux lettres dans Outlook.com ou Exchange Online dans Office 365.

Remarque

Office 365 administrateurs peuvent désactiver les messages actionnables à l’aide de l’applet de commande Set-OrganizationConfig. Si les messages actionnables ne s’affichent pas, case activée auprès de votre administrateur pour vous assurer que la fonctionnalité est activée dans votre organization.

Création d’une carte de message intégrant des actions

Commençons par quelque chose de simple : une carte de base avec une Action.Http action et une Action.OpenUrl action. Utilisez le Designer Message actionnable pour concevoir le carte.

Importante

L’exemple de balisage de carte dans cette rubrique supprime la originator propriété. Cette omission fonctionne dans un scénario de test, où le destinataire est le même que l’expéditeur. Lors de l’envoi de messages actionnables à toute autre personne, définissez la originator propriété sur un ID de fournisseur valide généré par le tableau de bord du développeur actionnable Email. Si vous laissez cette propriété vide lors de l’envoi à d’autres personnes, le carte est supprimé.

Accédez à la Designer Message actionnable et collez le code JSON suivant :

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

N’hésitez pas à tester cet exemple simple dans la Designer. Pour plus d’informations sur les champs disponibles, consultez la référence carte adaptative. Lorsque vous avez un carte qui vous satisfait, vous pouvez passer à l’envoi.

Envoi de messages actionnables par e-mail

Importante

Pour concevoir et tester des messages actionnables, utilisez le Designer Message actionnable. Il vous envoie des messages actionnables. Vous pouvez également utiliser le serveur SMTP Office 365 pour vous envoyer des messages actionnables. Vous ne pouvez pas envoyer de messages actionnables à d’autres utilisateurs tant que vous ne vous êtes pas inscrit via le tableau de bord du développeur de messages actionnables.

Pour incorporer un message actionnable carte dans un e-mail, encapsulez le carte dans une <script> balise. Insérez la <script> balise dans le <head> du corps HTML de l’e-mail.

Remarque

Étant donné que vous devez encapsuler le carte JSON dans une <script> balise, le corps de l’e-mail de message actionnable doit être au format HTML. Les messages en texte brut ne sont pas pris en charge.

  1. Ajouter l’attribut hideOriginalBody pour contrôler ce qui se produit avec le corps du courrier électronique. Définissez l’attribut sur true afin que le corps ne s’affiche pas.

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

  2. Incluez le fichier JSON résultant dans une balise <script> de type application/adaptivecard+json.

    Remarque

    Si vous utilisez le format de message hérité carte plutôt que le format carte adaptative, le <script> type de balise doit être 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://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}
</script>

  3. Générez un document HTML pour représenter le corps du courrier électronique et incluez la balise <script> dans <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://learn.microsoft.com/outlook/actionable-messages"
      }
    ]
  }
  </script>
</head>
<body>
Visit the <a href="https://learn.microsoft.com/outlook/actionable-messages">Outlook Dev Portal</a> to learn more about Actionable Messages.
</body>
</html>

  4. Envoyez un message via SMTP avec le code HTML comme corps.

Envoi du message

Pour obtenir des exemples d’envoi de messages, consultez les ressources suivantes :

Exécution des actions

Pour obtenir des exemples d’actions, consultez les ressources suivantes :

  • Hello Actionable Messages : exemple de projet avec un déploiement Azure en un clic. Cet exemple est une solution de message actionnable de bout en bout simple que vous pouvez configurer et commencer à utiliser dans les 10 minutes. Il sert de référence pour la création d’un point de terminaison d’action de production.

Outils de résolution de problèmes

  • Débogueur de messages actionnables : complément Outlook que les développeurs utilisent pour inspecter la charge utile carte dans leurs messages actionnables et identifier la raison pour laquelle le carte ne s’affiche pas.
  • Last updated on