Actualiser un message actionnable lorsque l’utilisateur l’ouvre

Importante

L’intégration de nouveaux fournisseurs de messages actionnables avec une étendue globale est temporairement suspendue jusqu’au 30 juin 2024 en raison de mises à niveau du service. Les fournisseurs globaux existants et l’intégration des fournisseurs d’étendue d’organisation et de test ne sont pas affectés. Pour plus d’informations, consultez Forum aux questions sur les messages actionnables.

Les messages actionnables permettent aux utilisateurs d’effectuer des actions rapides sur un e-mail, souvent en fonction des données présentées dans le carte. Toutefois, les données changent parfois après l’envoi du message actionnable. Par exemple, votre service peut envoyer un message actionnable à plusieurs approbateurs leur demandant d’approuver ou de rejeter une demande. Un approbateur approuve la demande, mais le message actionnable dans la boîte aux lettres de l’autre approbateur demande toujours l’approbation. Désormais, avec la propriété sur les autoInvokeAction messages actionnables, vous pouvez fournir un point de terminaison HTTP pour récupérer une charge utile de carte adaptative à jour avec les informations les plus récentes lorsque l’utilisateur ouvre l’e-mail dans Outlook.

Importante

L’actualisation du message actionnable lorsque l’utilisateur l’ouvre a un impact direct sur les performances perçues de votre solution de message actionnable. Il est essentiel que votre service qui fournit les carte mis à jour réponde aux exigences de performances décrites dans Implémentation de l’API web.

Conditions d’inscription

Les services Messages actionnables inscrits dans le tableau de bord du développeur avec l’étendue Utilisateurs de test ou Organisation peuvent utiliser cette fonctionnalité dès qu’ils sont approuvés. Si votre service est inscrit avec l’étendue globale , vous devez contacter onboardoam@microsoft.com pour activer cette fonctionnalité.

Utilisation d’autoInvokeAction

Pour pouvoir utiliser cette fonctionnalité, votre carte doit utiliser le format carte adaptative. La propriété autoInvokeAction est une propriété spécifique à Outlook ajoutée au type AdaptiveCard. La valeur de cette propriété est une action Action.Http avec la method valeur définie sur POST. La url propriété spécifie un point de terminaison d’API web dans votre service qui fournira la charge utile de carte adaptative mise à jour.

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.0",
  "body": [...],
  "actions": [...],
  "autoInvokeAction": {
    "method": "POST",
    "url": "https://actionablemessages.contoso.com/api/getupdatedcard",
    "body": "",
    "type": "Action.Http"
  }
}

Création de la carte adaptative initiale

Lorsque vous utilisez autoInvokeAction, il est très important que les carte initiales incluses dans le message soient toujours utiles à l’utilisateur final et, dans l’idéal, exploitables. Le autoInvokeAction peut échouer, ou les conditions réseau peuvent le ralentir, auquel cas la carte initiale est tout ce que l’utilisateur final verra.

• N’envoyez pas un carte initial vide avec simplement un autoInvokeAction. Ces cartes seront rejetées par la plateforme de messages actionnables.
• N’envoyez pas un carte initial qui est simplement un espace réservé demandant à l’utilisateur d’attendre.
• Envoyez un carte initial qui présente les informations dans leur état actuel, même si cela signifie que l’utilisateur peut voir des données obsolètes au moment où il ouvre votre message.

Implémentation de l’API web

L’action Action.Http spécifiée dans la autoInvokeAction propriété fonctionne exactement comme toute autre Action.Http action. Pour plus d’informations sur l’implémentation du point de terminaison pour cette action, consultez Implémentation de l’API web.

Le point de terminaison d’un autoInvokeAction doit également répondre aux exigences supplémentaires suivantes.

• Les demandes doivent être retournées dans un délai de 2 secondes.
• Les demandes qui prennent plus de temps sont ignorées par le client et la carte d’origine continue à s’afficher. Le message sera toujours mis à jour sur le serveur.
• Les réponses réussies doivent inclure un CARD-UPDATE-IN-BODY en-tête avec valeur true et une charge utile JSON de carte adaptative.

En cas de réussite, la carte adaptative retournée remplace complètement le carte existant dans l’e-mail. Si l’URL retourne une erreur ou expire, le carte existant continue à s’afficher.

Exemple de scénario d’approbation

Prenons l’exemple de cet exemple de demande de congés carte générée par un outil de demande de congé et envoyée au responsable de l’employé.

Conseil

Vous pouvez accéder au code JSON et modifier cet exemple de carte en sélectionnant l’exemple Approbation de vacances dans la Designer Message actionnable.

Le carte comprend des renseignements pour aider le gestionnaire à prendre une décision, y compris les dates demandées et le nombre de congés restants de l’employé. Ces informations étaient exactes lors de la génération et de l’envoi du message. Toutefois, les données peuvent changer avant que le responsable ne vérifie son e-mail. Par exemple, l’employé peut modifier sa demande dans l’outil de demande de congé pour modifier les dates demandées.

En incluant une autoInvokeAction propriété dans le message actionnable généré par l’outil, votre carte avec les données d’origine est remplacée par une nouvelle carte avec de nouvelles données lorsque le responsable l’ouvre. L’URL spécifiée dans retourne autoInvokeAction la même charge utile JSON, avec de nouvelles valeurs pour les dates de congé demandées.