Créer des applications pour les utilisateurs anonymes

Les utilisateurs anonymes n’ont pas d’identité Microsoft Entra et ne sont pas fédérés avec un locataire. Les participants anonymes sont des utilisateurs externes, mais leur identité n’est pas affichée dans la réunion. Un utilisateur anonyme peut être un présentateur ou un participant, mais pas un organisateur. Vous pouvez créer des bots, des extensions de messagerie, des cartes et des dialogues (appelés modules de tâche dans TeamsJS v1.x) dans votre application pour interagir avec les participants anonymes à la réunion.

Pour que les utilisateurs anonymes interagissent avec les applications dans les réunions Teams, veillez à :

1. Mettez à jour le manifeste de votre application.
2. Activez l’interaction de l’application utilisateur anonyme dans le Centre d’administration Teams.

Mise à jour du manifeste d’application pour les utilisateurs anonymes

Pour permettre aux utilisateurs anonymes d’interagir avec l’application onglet, mettez à jour la supportsAnonymousGuestUsers propriété vers true dans le schéma de manifeste de votre application version 1.16 ou ultérieure. Voici un exemple de manifeste :

"meetingExtensionDefinition": {
    "supportsAnonymousGuestUsers": true
}

Pour plus d’informations, consultez Schéma de manifeste d’application.

Flux d’authentification utilisateur anonyme

Les utilisateurs anonymes ne peuvent pas être authentifiés via l’authentification Microsoft Entra ou getAuthToken à partir du Kit de développement logiciel (SDK) client, car il ne s’agit pas de comptes Microsoft Entra. getAuthToken échoue pour les utilisateurs anonymes en retournant l’erreur useGetAuthToken: Failed with error - User is not authenticated. Si vous avez besoin d’authentifier des utilisateurs anonymes, votre application doit identifier les utilisateurs anonymes et fournir une autre expérience d’authentification dans les réunions. Vous pouvez déterminer si un utilisateur est anonyme en validant le contexte de l’utilisateur.

Paramètre administrateur pour l’interaction de l’application utilisateur anonyme

Les administrateurs Teams peuvent utiliser le Centre d’administration Teams pour activer ou désactiver l’interaction de l’application utilisateur anonyme pour l’ensemble du locataire. Si les utilisateurs anonymes doivent accéder à votre application, assurez-vous que les administrateurs de locataire activent l’interaction de l’application utilisateur anonyme. Ce paramètre est activé par défaut. Pour plus d’informations, consultez Autoriser les utilisateurs anonymes à interagir avec les applications dans les réunions.

Pour tester l’expérience de vos applications pour les utilisateurs anonymes, sélectionnez l’URL dans l’invitation à la réunion et rejoignez la réunion à partir d’une fenêtre de navigateur privé.

In-Meeting getContext à partir de la bibliothèque de client Teams

Les applications reçoivent les informations suivantes pour un utilisateur anonyme lorsqu’ils appellent l’API getContext à partir de la phase d’application partagée. Vous pouvez reconnaître les utilisateurs anonymes en recherchant une userLicenseType valeur de Anonymous.

import * as microsoftTeams from "@microsoft/teams-js";

microsoftTeams.app.getContext().then((context) => {
    if (context.user.licenseType === "Anonymous") {
        // Add your custom logic here
    }
});

{
   "app": {
    "locale": "en-us",
    "sessionId": "e0024c2a-067f-4f43-8423-6acac718b7a0",
    "theme": "dark",
    "parentMessageId": "",
    "userClickTime": 1675776700117,
    "host": {
        "name": "Teams",
        "clientType": "web",
        "sessionId": "",
        "ringId": "general"
    }
  },
  "page": {
    "frameContext": "meetingStage",
    "subPageId": "",
    "isMultiWindow": false,
    "sourceOrigin": ""
  },
  "user": {
    "id": "",
    "licenseType": "Anonymous",
    "loginHint": "",
    "userPrincipalName": ""
 },
 "chat": {
      "id": "19:meeting_ZmMyNWZjMzEtMWU0Mi00NDNmLWJhMmYtNjM4OTY0YmM0NWM2@thread.v2"
 },
  "meeting": {
      "id": "MCMxOTptZWV0aW5nX1ptTXlOV1pqTXpFdE1XVTBNaTAwTkRObUxXSmhNbVl0TmpNNE9UWTBZbU0wTldNMkB0aHJlYWQudjIjMA=="
    }
}

Pour plus d’informations sur getContext, consultez Obtenir le contexte à l’aide de la bibliothèque JavaScript Microsoft Teams.

Activités et API du bot

Avec quelques différences, les activités envoyées à votre bot et les réponses qu’il reçoit des API de bot sont cohérentes entre les participants anonymes et non anonymes à la réunion.

Obtenir des membres et obtenir des API à membre unique

Les API obtenir des membres et obtenir un seul membre retournent des informations limitées pour les utilisateurs anonymes :

{ 
  "id": "<GUID1>", 
  "name": "<AnonTest (Guest)>",  
  "tenantId": "<GUID2>", 
  "userRole": "anonymous" 
}

ConversationUpdate, activité MembersAdded et MembersRemoved

MembersAdded

protected override async Task OnTeamsMembersAddedAsync(IList<TeamsChannelAccount> membersAdded, TeamInfo teamInfo, ITurnContext<IConversationUpdateActivity> turnContext, CancellationToken cancellationToken)
  {
     foreach (var teamMember in membersAdded)
     {
         // If UserRole == "anonymous", it indicates an anonymous user
         if (teamMember.UserRole == "anonymous" )
          {
             // Add your custom logic here
          }
          else
          {
           // Add your custom logic here
          }
     }
  }

MembersRemoved

protected override async Task OnTeamsMembersRemovedAsync(IList<TeamsChannelAccount> membersRemoved, TeamInfo teamInfo, ITurnContext<IConversationUpdateActivity> turnContext, CancellationToken cancellationToken)
   foreach (var member in membersRemoved)
   {
      // If AadObjectId is null, it indicates an anonymous user
       if (member.AadObjectId == null)
       {
           // Add your custom logic here
       }
       else
       {
           // Add your custom logic here
       }
   }

Créer une API de conversation

Les bots ne sont pas autorisés à lancer une conversation en face à face avec un utilisateur anonyme. Si un bot appelle l’API Créer une conversation avec l’ID utilisateur d’un utilisateur anonyme, il reçoit un code d’état 400 de demande incorrecte et la réponse d’erreur suivante :

var conversationParameters = new ConversationParameters
    {
       IsGroup = false,
       Bot = turnContext.Activity.Recipient,
       Members = new ChannelAccount[] { teamMember },
       TenantId = turnContext.Activity.Conversation.TenantId,
    };
    
    await ((CloudAdapter)turnContext.Adapter).CreateConversationAsync(
    conversationParameters,
    async (t1, c1) =>
    {
       conversationReference = t1.Activity.GetConversationReference();
       await ((CloudAdapter)turnContext.Adapter).ContinueConversationAsync(
       _appId,
       conversationReference,
       async (t2, c2) =>
       {
         await t2.SendActivityAsync(proactiveMessage, c2);
        },
        cancellationToken);
    },
cancellationToken);

{ 
  "error": {
    "code": "BadArgument",
    "message": "Bot cannot create a conversation with an anonymous user"
  }
} 

Cartes adaptatives

Les utilisateurs anonymes peuvent afficher et interagir avec les cartes adaptatives dans la conversation de réunion. Les actions de carte adaptative se comportent de la même façon pour les utilisateurs anonymes et non anonymes. Pour plus d’informations, consultez Actions de carte.

Problèmes connus et conseils

• Les applications pour les utilisateurs anonymes ne sont pas prises en charge sur les événements en direct, l’infrastructure VDI (Virtual Desktop Infrastructure) et les plateformes Linux.

• Les applications pour les utilisateurs anonymes ne sont pas prises en charge sur les navigateurs Firefox et Safari.

• Les applications pour les utilisateurs anonymes ne sont pas prises en charge dans les réunions de canal Teams.

• L’API getContext ne retourne pas d’ID d’utilisateur pour l’utilisateur anonyme, bien que les API du bot, et il n’est pas possible de mettre en corrélation l’utilisateur anonyme entre ces deux API.

• Les utilisateurs anonymes voient une icône d’application générique sur les messages et les cartes du bot, au lieu de l’icône réelle de l’application.

  

Exemple de code

Étape suivante

Voir aussi

• Applications pour les réunions et les appels Teams
• Créer des applications pour la phase de réunion Teams
• API des applications de réunion
• Fonctionnement des bots Microsoft Teams
• Obtenir un contexte Teams pour votre onglet