Recepción de todos los mensajes de conversación

El modelo de permisos de consentimiento específico de recursos (RSC), desarrollado originalmente para las API de Microsoft Teams Graph, se está ampliando a escenarios de bot. Con RSC, los propietarios de conversaciones pueden dar su consentimiento para que un bot reciba todos los mensajes de usuario en canales y chats estándar sin ser @mentioned. Esto se puede habilitar especificando las cadenas de permiso o ChatMessage.Read.Chat en el ChannelMessage.Read.Group manifiesto de la aplicación (anteriormente denominado manifiesto de aplicación de Teams). Los propietarios de conversaciones pueden conceder consentimiento durante el proceso de instalación o actualización de la aplicación después de publicar las actualizaciones de la aplicación. Para obtener más información sobre cómo habilitar RSC para la aplicación y dentro de un inquilino, consulte consentimiento específico del recurso.

Permitir que los bots reciban todos los mensajes de canal o chat

Los ChannelMessage.Read.Group permisos y ChatMessage.Read.Chat RSC se extienden a los bots. Con el consentimiento del usuario y la instalación de aplicaciones, estos permisos:

• Permitir que una aplicación de grafos especificada obtenga todos los mensajes en canales y chats, respectivamente.
• Habilite un bot definido en el manifiesto de la aplicación para recibir todos los mensajes de conversación sin estar @mentioned en contextos pertinentes en los que se aplican los permisos.

Filtrado por mensajes de mención

// When ChannelMessage.Read.Group or ChatMessage.Read.Chat RSC is in the app manifest, this method is called even when bot is not @mentioned.
// This code snippet allows the bot to ignore all messages that do not @mention the bot.
protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
        // Ignore the message if bot was not mentioned. 
        // Remove this if block to process all messages received by the bot.
        if (!turnContext.Activity.GetMentions().Any(mention => mention.Mentioned.Id.Equals(turnContext.Activity.Recipient.Id, StringComparison.OrdinalIgnoreCase)))
        {
            return;
        }
        // Sends an activity to the sender of the incoming activity.
        await turnContext.SendActivityAsync(MessageFactory.Text("Using RSC the bot can receive messages across channels or chats in team without being @mentioned."));
}

Permiso de RSC

Los servicios que necesitan acceso a todos los datos de mensajes de Teams deben usar las API de Graph que proporcionan acceso a los datos archivados en canales y chats. Los bots deben usar el ChannelMessage.Read.Group permiso Y ChatMessage.Read.Chat RSC adecuadamente para crear y mejorar la experiencia atractiva para que los usuarios pasen la aprobación de Microsoft Teams Store. La descripción de la aplicación debe incluir cómo usa el bot los datos que lee:

• Los ChannelMessage.Read.Group bots no pueden usar el permiso y ChatMessage.Read.Chat RSC para extraer grandes cantidades de datos de clientes.
• La capacidad de que los bots reciban todos los mensajes en chats mediante ChatMessage.Read.Chat solo está habilitada después de una nueva instalación o una nueva instalación en un chat.
• Si tiene una aplicación que usa el ChatMessage.Read.Chat permiso RSC para escenarios de Graph, pruebe la aplicación siguiendo los pasos descritos en Cargar una aplicación personalizada en una conversación y modifique la aplicación antes de que la característica esté disponible con carácter general. Si no desea que el bot reciba todos los mensajes de chat, implemente el siguiente fragmento de código. Si no se realiza ninguna acción, el bot recibe todos los mensajes después de las nuevas instalaciones.

Actualizar el manifiesto de la aplicación

Para que el bot reciba todos los mensajes de conversación, las cadenas de permiso RSC pertinentes deben especificarse en la authorization.permissions.resourceSpecific propiedad del manifiesto de la aplicación. Para obtener más información, consulte esquema de manifiesto de aplicación.

El código siguiente proporciona un ejemplo del manifiesto de la aplicación:

• webApplicationInfo.id: el identificador de la aplicación Microsoft Entra. El identificador de la aplicación puede ser el mismo que el identificador del bot.
• webApplicationInfo.resource: cualquier cadena. El campo de recurso no tiene ninguna operación en RSC, pero debe agregarse con un valor para evitar la respuesta de error.
• authorization.permissions.resourceSpecific: permisos de RSC para la aplicación con o ambos ChannelMessage.Read.Group y ChatMessage.Read.Chat especificados. Para obtener más información, vea permisos específicos del recurso.

El código siguiente proporciona un ejemplo del manifiesto de aplicación versión 1.12 o posterior:

{
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.12/MicrosoftTeams.schema.json",
    "manifestVersion": "1.12",
    "version": "1.0.0",
    "id": "8239c8f3-ed78-4512-933e-babfd28856f1",
    "packageName": "com.contoso.rscechobot",
    "developer": {
        "name": "Contoso",
        "websiteUrl": "https://www.contoso.com",
        "privacyUrl": "https://www.contoso.com/privacy",
        "termsOfUseUrl": "https://www.contoso.com/tos"
    },
    "icons": {
        "color": "color.png",
        "outline": "outline.png"
    },
    "name": {
        "short": "RscEchoBot",
        "full": "Echo bot with RSC configured for all conversation messages"
    },
    "description": {
        "short": "Echo bot with RSC configured for all channel and chat messages",
        "full": "Echo bot configured with all channel and chat messages RSC permission in manifest"
    },
    "accentColor": "#FFFFFF",
    "staticTabs": [
        {
            "entityId": "conversations",
            "scopes": [
                "personal"
            ]
        },
        {
            "entityId": "about",
            "scopes": [
                "personal"
            ]
        }
    ],
    "webApplicationInfo": {
        "id": "07338883-af76-47b3-86e4-2603c50be638",
        "resource": "https://AnyString"
    },
    "authorization": {
        "permissions": {
            "resourceSpecific": [
                {
                    "type": "Application",
                    "name": "ChannelMessage.Read.Group"
                },
                {
                    "type": "Application",
                    "name": "ChatMessage.Read.Chat"
                }
            ]
        }
    },
    "bots": [
        {
            "botId": "07338883-af76-47b3-86e4-2603c50be638",
            "scopes": [
                "personal",
                "team",
                "groupchat"
            ],
            "supportsFiles": false,
            "isNotificationOnly": false
        }
    ],
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    "validDomains": []
}

Carga de una aplicación personalizada en una conversación

Fragmentos de código

El código siguiente proporciona un ejemplo de los permisos de RSC:

// Handle when a message is addressed to the bot.
// When rsc is enabled the method will be called even when bot is addressed without being @mentioned.
protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
        // Sends an activity to the sender of the incoming activity.
         await turnContext.SendActivityAsync(MessageFactory.Text("Using RSC the bot can receive messages across channels or chats in team without being @mentioned."));
}

// Handle when a message is addressed to the bot.
// When rsc is enabled the method will be called even when bot is addressed without being @mentioned.

this.onMessage(async (context, next) => {
    // Sends a message activity to the sender of the incoming activity.
   await context.sendActivity(MessageFactory.text("Using RSC the bot can receive messages across channels or chats in team without being @mentioned."))
   await next();
});

Ejemplo de código

Consulte también

• Conversaciones de bot
• Consentimiento específico del recurso
• Probar el consentimiento específico del recurso
• Cargar aplicación personalizada en Teams
• Enumerar las respuestas a los mensajes de un canal