Partage via


Conception de votre extension de message Microsoft Teams

Les extensions de message sont des raccourcis permettant d’insérer du contenu d’application ou d’agir sur un message sans quitter la conversation. Pour guider la conception de votre application, les informations suivantes décrivent et illustrent comment les utilisateurs peuvent ajouter, utiliser et gérer des extensions de message dans Teams.

Kit d’interface utilisateur de Microsoft Teams

Vous trouverez des instructions complètes de conception d’extension de message, y compris des éléments que vous pouvez récupérer et modifier si nécessaire, dans le Kit d’interface utilisateur Microsoft Teams.

Ajouter une extension de message

Vous pouvez ajouter une extension de message dans les contextes Teams suivants :

  • À partir du Microsoft Teams Store.
  • Dans un canal, une conversation ou une réunion (avant, pendant et après) près de la zone de rédaction. Il est important de noter que si vous ajoutez une extension de message à l’un de ces emplacements, vous seul pouvez l’utiliser dans ce contexte.

Les exemples suivants montrent comment ajouter une extension de message dans un canal.

Mobile

L’exemple montre comment ajouter une extension de message près de la zone de composition dans un canal sur mobile.

Ordinateur de bureau

L’exemple montre comment ajouter une extension de message près de la zone de composition dans un canal.

Configurer une extension de message

L’authentification n’est pas obligatoire, mais si votre application ressemble à un outil de suivi des tickets, vous devrez peut-être vous connecter pour utiliser l’extension de message.

Pour assurer la cohérence entre les applications Teams, vous ne pouvez pas personnaliser l’écran de connexion. Si vous utilisez l’authentification unique (SSO), les utilisateurs sont connectés automatiquement.

Mobile

L’exemple montre l’écran d’installation de l’extension de message avec un bouton de connexion sur mobile.

Ordinateur de bureau

L’exemple montre l’écran d’installation de l’extension de message avec un bouton de connexion.

Types d’extensions de message

Les extensions de message peuvent avoir des commandes de recherche, des commandes d’action ou les deux. Vos commandes dépendent des fonctionnalités de votre application et de la façon dont elles s’intègrent dans les cas d’usage Teams.

Commandes de recherche

Avec les commandes de recherche, les utilisateurs peuvent utiliser votre extension de message pour rechercher rapidement du contenu externe et les insérer dans un message. Les commandes de recherche sont généralement disponibles dans la zone de rédaction. Par exemple, vous pouvez démarrer ou ajouter à une discussion en partageant un élément de contenu, sans jamais quitter Teams.

Mobile

L’exemple montre une extension de message basée sur la recherche lancée à partir de la zone de composition sur mobile.

Ordinateur de bureau

L’exemple montre une extension de message basée sur la recherche lancée à partir de la zone de composition.

Options de disposition de la zone de rédaction

Vous disposez de certaines options pour afficher les résultats de la recherche d’extension de message, notamment la liste et les vues de grille.

Illustrations montrant les options de disposition pour les résultats de recherche d’extension de message.

Commandes d'action

Les commandes d’action permettent aux utilisateurs de déclencher des actions et de traiter des demandes dans des services externes dans Teams. Par exemple, si votre application assure le suivi des commandes, un utilisateur peut créer une nouvelle commande en utilisant le contenu du message d'un collègue, et ce, directement dans sa conversation.

Les extensions de message basées sur des actions nécessitent souvent que les utilisateurs remplissent un formulaire ou un autre type de configuration au sein d’un modal. Vous pouvez créer ces expériences avec des dialogues (appelés modules de tâche dans TeamsJS v1.x).

Ouvrir une extension de message

La zone de composition et les messages ou les billets sont les principaux contextes dans lesquels les utilisateurs utilisent des extensions de message.

À partir de la zone de rédaction

Une fois ajoutés, les utilisateurs peuvent ouvrir votre extension de message en sélectionnant l’icône de votre application sous la zone de composition. Dans ces exemples, l’extension comporte des commandes de recherche et d’action.

Mobile

L’exemple montre comment ouvrir une extension de message à partir de la zone de composition sur un appareil mobile.

Ordinateur de bureau

L’exemple montre comment ouvrir une extension de message à partir de la zone de composition.

À partir d’un message de conversation ou d’un billet de canal

Une fois ajoutés, les utilisateurs peuvent sélectionner l’icône Plus dans le message de conversation ou le billet de canal pour rechercher les commandes d’action de votre extension. Votre extension peut être répertoriée sous Plus d’actions en fonction de l’utilisation.

Message de conversation

L’exemple montrant comment ouvrir une extension de messagerie à partir d’un message de conversation.

Billet de canal

L’exemple montre comment ouvrir une extension de message à partir d’un billet de canal sur mobile.

Utiliser une extension de message

Les scénarios suivants montrent les principales façons dont les utilisateurs utilisent les extensions de message.

Insérer du contenu dans un message

1. Sélectionner une extension de message. Les utilisateurs peuvent rechercher le contenu qu'ils veulent partager à partir de la zone de rédaction.

Mobile

Exemple montrant un utilisateur recherchant du contenu à insérer à partir de la zone de rédaction sur un appareil mobile.

Ordinateur de bureau

Exemple montrant un utilisateur recherchant du contenu à insérer à partir de la zone de rédaction.

2. Insérer du contenu. Une fois publiés, d’autres utilisateurs peuvent répondre ou sélectionner le contenu pour afficher plus d’informations dans votre application.

Mobile

Exemple montrant un utilisateur publiant du contenu dans une conversation de canal sur un appareil mobile.

Ordinateur de bureau

Exemple montrant un utilisateur publiant du contenu dans une conversation de canal.

Effectuez des actions sur un message

1. Sélectionner une extension de message. Votre application peut inclure une ou plusieurs commandes d’action.

L’exemple montre un utilisateur qui sélectionne une commande d’action d’extension de message.

2. Terminer l'action. Votre application peut recevoir et traiter le contenu ou les données envoyés par l’action de message. Les utilisateurs terminent l’action dans votre application tout en restant dans leur conversation.

Exemple sur la façon d’agir sur un message.

Les extensions de message vous permettent également d’insérer des liens enrichis à partir d’une URL reconnue dans un message (cette fonctionnalité est appelée le déploiement de liens.)

1. Coller un lien reconnu dans la zone de rédaction.

Mobile

Exemple montrant un utilisateur collant un lien dans la zone de rédaction sur un appareil mobile.

Ordinateur de bureau

Exemple montrant un utilisateur collant un lien dans la zone de rédaction.

2. Insérer du contenu. Si votre application reconnaît l’URL dans la zone de rédaction, elle affiche le lien sous la forme d’une carte qui fournit un aperçu riche en contenu du contenu web. (Pour plus d’informations, consultez les Instructions de conception de Cartes adaptatives .)

Mobile

Exemple montrant comment l'URL, étant donné qu'elle est reconnue par votre application, inclut un contenu enrichi dans la zone de rédaction sur un appareil mobile.

Ordinateur de bureau

Exemple montrant comment l'URL, étant donné qu'elle est reconnue par votre application, inclut un contenu enrichi dans la zone de rédaction.

Gérer une extension de message

En cliquant avec le bouton droit sur votre icône, les utilisateurs peuvent épingler, supprimer ou configurer votre extension de message.

Anatomie

Extension de message dans la zone de composition

Les exemples suivants montrent une extension de message ouverte à partir de la zone de composition.

Mobile

Illustration montrant l’anatomie de l’interface utilisateur d’une extension de message dans la zone de composition sur mobile.

Compteur Description
1 Nom de l’application : nom complet de votre application.
2 Icône de menu Commandes d’action (facultatif): ouvre une liste de commandes d’action pour votre extension de message (si vous en spécifiez une).
3 Zone de recherche : permet aux utilisateurs de trouver le contenu de l’application qu’ils souhaitent insérer.
4 Menu onglet (facultatif) : fournit plusieurs catégories de contenu.
5 Menu commandes d’action (facultatif) : affiche la liste des commandes d’action (le cas échéant).
6 Contenu de l’application : principalement pour afficher les résultats de la recherche.

Desktop

Illustration montrant l’anatomie de l’interface utilisateur d’une extension de message dans la zone de composition.

Compteur Description
1 Logo de l’application : icône couleur du logo de votre application.
2 Nom de l’application : nom complet de votre application.
3 Icône de menu Commandes d’action (facultatif): ouvre une liste de commandes d’action pour votre extension de message (si vous en spécifiez une).
4 Zone de recherche : permet aux utilisateurs de trouver le contenu de l’application qu’ils souhaitent insérer.
5 Menu onglet (facultatif) : fournit plusieurs catégories de contenu.
6 Menu commandes d’action (facultatif) : affiche la liste des commandes d’action (le cas échéant).
7 Contenu de l’application : principalement pour afficher les résultats de la recherche. L’exemple suivant utilise la disposition de liste (la disposition de la grille est une autre option).
8 Logo de l’application : icône contour du logo de votre application.

Menu de gestion des extensions de message

Illustration montrant l’anatomie de l’interface utilisateur d’un menu de gestion des extensions de message.

Compteur Description
1 Désépingler : disponible si l’utilisateur a épinglé votre application.
2 Supprimer : supprime l’extension de message du canal, de la conversation ou de la réunion.

Meilleures pratiques

Utilisez ces recommandations pour créer une expérience d’application de qualité.

Configuration et utilisation générale

Exemple d’installation et d’utilisation générale.

À faire : intégrer avec l’authentification unique

L’authentification unique facilite, accélère et sécurise le processus de connexion. En outre, si un utilisateur s’est déjà connecté à votre application personnelle, il n’a pas besoin de se reconnecter pour accéder à l’extension de message.

Exemple d’intégration avec l’authentification unique.

À ne pas faire : retirer les utilisateurs de la conversation

Les extensions de message sont des raccourcis censés réduire le changement de contexte. Par exemple, votre extension ne doit pas diriger les utilisateurs vers une page web en dehors de Teams.

À faire : mettre en surbrillance votre extension de message

Les extensions de message ne sont pas toujours faciles à trouver. Incluez des captures d’écran de l’utilisation dans la page de détails de votre application. Si votre application inclut également un bot, vous pouvez inclure la documentation d’aide sur l’extension de message dans une visite guidée de bienvenue du bot.

Création de modèles

Exemple de création de modèles.

À faire : permettre à Teams de gérer une partie du travail de conception si possible

Si cela est pertinent pour vos cas d’usage, envisagez de créer une extension de message basée sur la recherche. Teams affiche ces types d’extensions avec un thème et une accessibilité intégrés.

Exemple de gestion du travail de conception.

À ne pas faire : incorporer l’intégralité de votre application dans une boîte de dialogue

Si votre extension de message nécessite des commandes d’action, gardez la boîte de dialogue simple et affichez uniquement les composants requis pour terminer l’action.

Thèmes

Exemple sur les thèmes.

À faire : tirer parti des jetons de couleur Teams

Chaque thème Teams a son propre modèle de couleurs. Pour gérer automatiquement les modifications de thème, utilisez jetons de couleur (Fluent UI) dans votre conception.

Exemple sur les jetons de couleur.

À ne pas faire : valeurs de couleur du code dur

Si vous n’utilisez pas de jetons de couleur Teams, vos conceptions seront moins évolutives et prendront du temps à gérer.

Actions

Exemple sur les actions.

À faire : inclure des commandes d’action qui ont du sens dans le contexte

Les actions de message doivent être liées à ce qu’un utilisateur examine. Par exemple, fournissez aux utilisateurs un raccourci pour créer un problème ou une tâche en utilisant le texte d'une publication.

Exemple sur les commandes d’action.

À ne pas faire : inclure des commandes d’actions qui ne sont pas contextuelles

Une action de message pour Afficher votre tableau de bord semble probablement déconnectée de la plupart des conversations.

Recherches

À faire : afficher les résultats de la recherche lors de la saisie

Fournissez des résultats de recherche suggérés pendant que les utilisateurs tapent. Ils peuvent trouver le contenu dont ils ont besoin plus rapidement avec un minimum de caractères.

À ne pas faire : demander aux utilisateurs de soumettre une requête

Vous pouvez faire en sorte que les utilisateurs appuient sur une touche ou sélectionnent un bouton pour envoyer des requêtes à votre application. Bien que cela puisse être plus facile pour votre service de services d'applications, les utilisateurs peuvent être déconcertés par le fait qu'ils ne voient pas les résultats de recherche en temps réel au fur et à mesure qu'ils tapent.

À faire : prendre en compte les requêtes sans terme

Par exemple, avant qu’un utilisateur n’écrive quoi que ce soit dans la zone de recherche, affichez ce qu’il a affiché pour la dernière fois sur votre application. Il est possible qu'ils veuillent insérer ce contenu dans leur conversation.