Connectez un bot vers le canal Outlook pour les messages actionnables (Aperçu)

  • Article

S'APPLIQUE À : SDK v4

Les messages actionnables permettent aux utilisateurs d’effectuer des actions rapides à partir d’Outlook. Lorsque vous connectez un bot au canal Messages actionnables Outlook, votre bot peut utiliser des cartes adaptatives pour créer des messages actionnables, ce qui améliore l’engagement utilisateur.

Remarque

Le canal Outlook pour les messages actionnables est en préversion publique. Les fonctionnalités incluses dans l’aperçu peuvent ne pas être terminées et peuvent subir des modifications avant de devenir disponibles dans la version publique. Elles sont fournies uniquement à des fins d’évaluation et d’exploration.

Avertissement

La création de « spambots », et notamment de bots envoyant du courrier indésirable ou non sollicité en nombre, constitue une violation du Code de conduite de Bot Framework.

Prérequis

Remarque

  • N’utilisez pas vos comptes de courrier personnels pour les bots, car chaque message envoyé à ces comptes sera transféré vers le bot. Ce dernier risque alors d’envoyer une réponse inappropriée à un expéditeur. C’est la raison pour laquelle les bots doivent uniquement utiliser des comptes de courrier O365 dédiés.
  • Si vous utilisez Microsoft Exchange Server, activez Découverte automatique avant de configurer le canal E-mail.

Concevoir les messages

Le canal Outlook pour les messages actionnables envoie et reçoit des cartes adaptatives par e-mail.

Vous pouvez utiliser le Concepteur de messages actionnable pour concevoir et tester des cartes de messages actionnables.

Important

Le modèle d’action de bot universel est introduit dans le schéma des Cartes adaptatives version 1.4. Pour utiliser ces nouvelles fonctionnalités, la propriété de version de votre carte adaptative doit être définie sur la version 1.4 ou ultérieure. Consultez Action.Execute dans l’Explorateur de schémas de cartes adaptatives.

Implémenter et déployer le bot

Le flux général est conçu pour que le bot envoie un message actionnable à un utilisateur, puis gère l’action de l’utilisateur.

  1. Lorsque l’utilisateur répond aux cartes par e-mail, Outlook envoie une activité d’appel au bot. La propriété de l’activité value contient un objet d’action avec les propriétés type, verb et data. Par exemple, l’activité inclut les informations suivantes, où le verbe et les données correspondent aux informations sur la carte que le bot a envoyé initialement.

    "type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}

    Consultez Action.Execute dans l’Explorateur de schémas cartes adaptatives pour obtenir le schéma d’objet complet.

  2. Le bot gère l’activité d’appel entrant et retourne un résultat qui inclut une nouvelle carte adaptative qui prendra la place de la carte adaptative d’origine. La réponse d’appel peut ressembler à ceci :

    {
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}

Demander l’accès

  1. Ouvrez votre ressource bot dans le portail Azure.
  2. Ouvrez le volet Canaux.
  3. Sélectionnez le canal Outlook.
  4. Dans la page Configurer Outlook, sélectionnez s’inscrire ici.
  5. Remplissez le formulaire d’inscription pour demander l’accès. Pour plus d’informations, consultez Inscrire votre service auprès du tableau de bord du développeur de messagerie actionnable.

Étapes suivantes