Compartir a través de

Enviar mensajes de Microsoft Teams proactivos

Después de haber publicado su agente y poner el agente a disposición de los usuarios en Microsoft Teams, puede notificar a los usuarios ("destinatarios") en Microsoft Teams con mensajes proactivos. Los mensajes proactivos usan Power Automate para entregar su contenido y son útiles en muchos escenarios, que incluyen:

  • Informar a un destinatario de que se completó su solicitud anterior. Por ejemplo, se aprobó la solicitud de indisponibilidad del usuario.
  • Proporcionar recordatorios o actualizaciones de noticias. Por ejemplo, el agente podría enviar un mensaje de recordatorio para completar el curso en línea.

Importante

Los mensajes proactivos se pueden configurar para agentes y bots de chat clásicos creados y personalizados en Copilot Studio.

Un agente no puede entregar mensajes si el destinatario:

  • No tiene instalado el agente en Microsoft Teams.
  • Ha desinstalado el agente.
  • Ha bloqueado el agente.
  • No tiene permiso para chatear con el agente, en cuyo caso debe compartir el agente con otros usuarios.

Requisitos previos

Limitaciones conocidas

  • Si el agente se desconecta y se vuelve a conectar a Microsoft Teams, los usuarios no recibirán mensajes proactivos hasta después de volver a instalar el agente.
  • Todos los mensajes proactivos de Copilot Studio están sujetos a los límites en Power Automate y a los límites del conector Microsoft Teams.
  • Los mensajes proactivos no se registran en las transcripciones de la conversación o las Sesiones analíticas.
  • Los mensajes proactivos deben estar en el mismo entorno que el flujo de Power Automate.
  • Los mensajes proactivos solo se pueden publicar en un chat personal con el agente.

Enviar mensajes proactivos

  1. En Power Automate, abra el flujo al que desea enviar un mensaje proactivo.

  2. Agregue la acción del conector de Microsoft Teams y seleccione la acción Publicar un mensaje en un chat o canal.

  3. Para Postear como, elija Power Virtual Agents (Avance).

  4. Para Publicar, elija Chatear con bot.

  5. Para Bot, seleccione el agente desde el que desea que se envíe el mensaje.

  6. En Destinatario, escriba el nombre o la dirección de correo electrónico del destinatario. También puede usar contenido dinámico si la información del destinatario proviene de un paso anterior en el flujo.

  7. Para Mensaje, escriba el mensaje que desee enviar.

    Publique la acción de mensaje en Power Automate.

Cuando se ejecuta el flujo, el destinatario recibirá el mensaje proactivo del agente en Microsoft Teams.

Enviar una tarjeta adaptable proactiva

Importante

Esta sección detalla cómo enviar tarjetas adaptables proactivas con flujos de Power Automate. Las tarjetas adaptables proactivas permiten a los usuarios recibir información de una conversación inactiva con un agente. Para aprender a enviar Tarjetas adaptables en una conversación activa , consulte Mostrar un tarjeta adaptable en Copilot Studio.

Además de enviar mensajes proactivos, también puede enviar tarjetas adaptables proactivas.

Captura de pantalla de una tarjeta adaptable.

Las tarjetas adaptables son un formato abierto de intercambio de tarjetas que permite a los desarrolladores intercambiar contenido de la interfaz de usuario de una manera común y coherente. Puede crear tarjetas adaptables a mano en JSON o, si prefiere una interfaz de arrastrar y soltar, puede usar el Diseñador de tarjetas adaptables.

Nota

Power Automate no es compatible con tarjetas adaptables que usan la función de plantilla.

En este ejemplo, enviará una tarjeta de resumen del pedido para que el usuario la revise.

  1. En Power Automate, agregue la acción del conector Microsoft Teams Publicar una tarjeta adaptable en un chat o canal en el paso donde desea enviar una tarjeta en su flujo.

  2. Para Postear como, elija Power Virtual Agents (Avance).

  3. Para Publicar, elija Chatear con bot.

  4. Para Bot, seleccione el agente desde el que desea que se envíe el mensaje.

  5. En Destinatario, escriba el nombre o la dirección de correo electrónico del destinatario. También puede usar contenido dinámico si la información del destinatario proviene de un paso anterior en el flujo.

  6. Para Tarjeta adaptativa, ingrese la siguiente plantilla JSON:

    {
    "type": "AdaptiveCard",
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.5",
    "body": [
        {
            "type": "TextBlock",
            "text": "Order summary",
            "wrap": true,
            "style": "heading"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Name",
                    "value": "John Doe"
                },
                {
                    "title": "Phone number",
                    "value": "(000) 000-0000"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "FactSet",
                    "facts": [
                        {
                            "title": "1x",
                            "value": "Steak"
                        },
                        {
                            "title": "2x",
                            "value": "Side Rice"
                        },
                        {
                            "title": "1x",
                            "value": "Soft Drink"
                        }
                    ],
                    "spacing": "Small"
                }
            ],
            "spacing": "Small"
        }
    ]
}

    Publique una acción de tarjeta adaptable en Power Automate.

Cuando se ejecuta el flujo, el destinatario recibirá la tarjeta adaptable del agente en Microsoft Teams.

Esperar respuesta del usuario

Importante

Esta sección detalla cómo enviar tarjetas adaptables proactivas con flujos de Power Automate. Las tarjetas adaptables proactivas permiten a los usuarios recibir información de una conversación inactiva con un agente. Para aprender a enviar Tarjetas adaptables en una conversación activa , consulte Mostrar un tarjeta adaptable en Copilot Studio.

Las tarjetas adaptables admiten la recopilación de información del usuario. En estos escenarios, querrá esperar la respuesta del usuario antes de que continúe el flujo.

Captura de pantalla de una tarjeta adaptable que contiene acciones para el usuario.

Nota

Power Automate no es compatible con tarjetas adaptables que usan la función de plantilla.

En este ejemplo, enviará una tarjeta de confirmación de pedido que permite al usuario realizar cambios antes de enviar el pedido.

  1. En Power Automate, agregue la acción del conector Microsoft Teams Publicar una tarjeta adaptable y esperar una respuesta en el paso donde desea enviar una tarjeta en su flujo.

  2. Para Postear como, elija Power Virtual Agents (Avance).

  3. Para Publicar, elija Chatear con bot.

  4. Para Mensaje, ingrese la siguiente plantilla JSON:

    Las propiedades de la sección actions determinan las opciones que se presentan al usuario.

    {
    "type": "AdaptiveCard",
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.0",
    "body": [
        {
            "type": "TextBlock",
            "text": "Order confirmation",
            "wrap": true,
            "style": "heading"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Name",
                    "value": "John Doe"
                },
                {
                    "title": "Phone number",
                    "value": "(000) 000-0000"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "FactSet",
                    "facts": [
                        {
                            "title": "1x",
                            "value": "Steak"
                        },
                        {
                            "title": "2x",
                            "value": "Side Rice"
                        },
                        {
                            "title": "1x",
                            "value": "Soft Drink"
                        }
                    ],
                    "spacing": "Small"
                }
            ],
            "spacing": "Small"
        }
    ],
    "actions": [
        {
            "type": "Action.Submit",
            "title": "Submit Order"
        },
        {
            "type": "Action.Submit",
            "title": "Edit Order"
        }
    ]
}

  5. Para Mensaje de actualización, introduzca el mensaje de actualización que verá el destinatario después de dar su respuesta.

  6. En Destinatario, escriba el nombre o la dirección de correo electrónico del destinatario. También puede usar contenido dinámico si la información del destinatario proviene de un paso anterior en el flujo.

  7. En Bot, seleccione el agente desde el que desea que se envíe la tarjeta.

    Publique la tarjeta adaptable y espere la acción de respuesta en Power Automate.

Cuando se ejecuta el flujo, el destinatario recibirá la tarjeta adaptable del agente en Microsoft Teams para la que luego pueden dar una respuesta.

Para utilizar la respuesta del destinatario, seleccione submitActionId desde el menú flotante de contenido dinámico. El valor de esta variable será el title de la acción que eligió el usuario.

Enviar mensajes proactivos a varios destinatarios

En algunos escenarios, es posible que desee enviar el mismo mensaje proactivo a varios destinatarios.

Esta sección contiene ejemplos para enviar mensajes a varios destinatarios.

Importante

Los requisitos previos detallados en este tema se aplican a cada destinatario.

Por ejemplo, puede enviar el mismo mensaje a diez destinatarios en una acción. Si tres de los 10 destinatarios no tienen el agente instalado, esos tres destinatarios no recibirán el mensaje.

Enviar a compañeros de equipo

En este ejemplo, el agente enviará un recordatorio a los miembros de un equipo para que completen su curso en línea.

  1. Añada el conector Microsoft Teams y seleccione la acción Obtener un equipo en el flujo de Power Automate.

  2. Para Equipo, Seleccione el equipo con los miembros a los que desea enviar el mensaje.

  3. Añada el conector Grupos de Office 365 y seleccione la acción Lista de miembros del grupo.

  4. Para Id. de grupo, seleccione Valor personalizado.

  5. Seleccione Id. de equipo en el contenido dinámico de la acción Obtener un equipo.

  6. Agregue el conector Microsoft Teams y seleccione la acción Publicar un mensaje en un chat o canal.

  7. Para Postear como, elija Power Virtual Agents (Avance).

  8. Para Publicar, elija Chatear con bot.

  9. Para Bot, seleccione el agente desde el que desea enviar el mensaje.

  10. Para Destinatario, seleccione el contenido dinámico Nombre principal del usuario desde la acción Lista de miembros del grupo.

    Ejemplo de un envío a compañeros de equipo.

  11. Para Mensaje, escriba el mensaje que desee enviar.

Cuando se ejecuta el flujo, cada usuario del equipo recibirá el mensaje proactivo en un chat privado con el agente.

Enviar a un grupo de seguridad

En este ejemplo, el agente enviará un recordatorio a un grupo de seguridad para que completen su curso en línea.

  1. Añada el conector Microsoft Entra ID y seleccione la acción Obtener miembros de grupo en el flujo de Power Automate.

  2. Para Identificación del grupo, ingrese el GUID del grupo de seguridad.

  3. Agregue el conector Microsoft Teams y seleccione la acción Publicar un mensaje en un chat o canal.

  4. Para Postear como, elija Power Virtual Agents (Avance).

  5. Para Publicar, elija Chatear con bot.

  6. Para Bot, seleccione el agente desde el que desea enviar el mensaje.

  7. Para Recipiente, seleccione el contenido dinámico Nombre principal del usuario de los miembros del grupo desde la acción Obtener miembros del grupo.

  8. Para Mensaje, escriba el mensaje que desee enviar.

    Envíe a una opción grupo de seguridad.

Cuando se ejecuta el flujo, cada usuario del grupo de seguridad recibirá el mensaje proactivo en un chat privado con el agente.

Enviar mensajes proactivos a varios destinatarios en paralelo

Normalmente, cuando se envía un mensaje proactivo a varios destinatarios, su agente enviará un mensaje tras otro. Sin embargo, en algunas situaciones, puede ser preferible enviar el mensaje a varios destinatarios al mismo tiempo.

Advertencia

Todos los mensajes proactivos de Copilot Studio están sujetos a los límites en Power Automate y a los límites del conector Microsoft Teams.

Si está enviando mensajes a un gran grupo de destinatarios, verá errores si alcanza el límite de limitación. Puede reducir el grado de paralelismo o reducir el número de destinatarios en el grupo.

  1. En la acción Aplicar a cada, seleccione los tres puntos horizontales (. . .) y luego Ajustes.

    Configuración en el menú de más opciones.

  2. Active Control de concurrencia y establezca el grado de paralelismo.

    Control deslizante para configurar el nivel o la simultaneidad.

Configurar opciones avanzadas para mensajes proactivos

Copilot Studio le permite controlar el comportamiento detallado de su agente en Mostrar opciones avanzadas en el conector Microsoft Teams.

Panel de opciones ampliado en el conector.

Etiquetar el mensaje enviado como notificación

Etiquetar como notificación controla si el mensaje o la tarjeta tiene el texto "Notificación a través de" delante del nombre del agente. Etiquetar la respuesta del agente permite al destinatario identificar la respuesta del agente a su consulta.

La configuración muestra Notificación a través del nombre del agente.

Cuando el destinatario está actualmente en un chat activo con el agente

A veces, el agente puede estar enviando un mensaje proactivo cuando el destinatario está en una conversación activa con el agente.

Es posible que desee posponer el envío del mensaje proactivo hasta que hayan terminado su conversación para no interrumpir el flujo de la conversación.

El cuadro Si el chat está activo le permite controlar el comportamiento:

  • Enviar: el agente enviará el mensaje o proactivo como de costumbre.

  • No enviar y correcto: el agente no enviará el mensaje proactivo cuando el destinatario está en una conversación activa con el bot. Se devolvería el código de estado 300.

  • No enviar y error: el agente no enviará el mensaje proactivo cuando el destinatario está en una conversación activa con el bot. La ejecución de flujo se marcará como error.

Cuando el destinatario no ha instalado el agente

El agente solo puede enviar mensajes o tarjetas proactivos a los destinatarios que hayan instalado el agente en Microsoft Teams. Es posible que los destinatarios no quieran instalar el agente o que lo hayan desinstalado.

Para mensajes de menor importancia, puede configurar la ejecución del flujo para que se marque como correcta incluso cuando el destinatario no tenga el agente instalado.

El cuadro Si el bot no está instalado le permite controlar el comportamiento:

  • Error: la ejecución del flujo se marcará como una error cuando el destinatario no haya instalado el agente en Microsoft Teams.

  • Correcto con código de estado: la ejecución del flujo se marcará como correcta aunque el destinatario no pueda recibir el mensaje porque no haya instalado el agente. Se devolvería el código de estado 100.

Definición del código de estado

Puede utilizar el código de estado devuelto para definir diferentes comportamientos de seguimiento en su flujo. Por ejemplo, puede especificar que el flujo debe intentarlo nuevamente durante un período de tiempo o registrar un registro sobre el error.

Código de estado Correcto (booleano) Description
200 VERDADERO El mensaje se entregó correctamente.
100 False No se pudo entregar el mensaje porque el destinatario no tiene el agente instalado.
300 False No se pudo entregar el mensaje porque el destinatario está en una conversación activa con el agente.