Notificaciones de Teams con Adaptive Cards en Power Automate

Cuando se activa un flujo en Power Automate, un simple mensaje de texto en Teams a menudo no basta. Un paso de aprobación, una votación de equipo o una respuesta sobre un pedido necesitan más que una simple información, necesitan una forma de reaccionar directamente en el chat. Para eso están precisamente las Adaptive Cards: tarjetas interactivas que Power Automate publica directamente en un chat o canal a través del conector de Microsoft Teams, y cuya respuesta el flujo espera a continuación.

Este artículo muestra qué acciones ofrece el conector de Teams para las Adaptive Cards, cómo creas tu primera tarjeta interactiva y qué limitaciones debes tener en cuenta al diseñarla según la documentación oficial de Microsoft. Así mantienes el control desde el principio sobre cómo se comunica tu empleada digital con tu equipo, en lugar de tener que buscar en la documentación tras el primer error.

Qué diferencia a las Adaptive Cards de un simple mensaje de Teams

Según la documentación de Microsoft sobre tarjetas adaptables para Teams las Adaptive Cards son un método independiente de la plataforma para compartir y mostrar bloques de información sin tener que adaptar CSS ni HTML. Describes la tarjeta en formato JSON, y Teams convierte automáticamente esta descripción en una interfaz nativa adaptada al host correspondiente al mostrarla.

La diferencia decisiva respecto a un mensaje de chat normal está en la interactividad: una Adaptive Card puede contener campos de texto, listas de selección y botones con los que los destinatarios responden directamente en el chat. Power Automate recoge esa respuesta y continúa el flujo con los datos introducidos, sin necesidad de un formulario aparte ni de una aplicación adicional.

Las acciones del conector de Microsoft Teams de un vistazo

Según la documentación, el conector de Teams distingue entre tarjetas para personas individuales y tarjetas para canales completos, y en cada caso entre una variante con y sin función de espera:

• Publicar tu propia tarjeta adaptable como bot de flujo a un usuario: la tarjeta aparece en el chat y en las actividades de la destinataria, sin que esta deba ser miembro de una instancia de Teams concreta. Aquí solo funcionan los botones de URL, que simplemente redirigen a una dirección configurada en el flujo.
• Publicar una tarjeta adaptable como bot de flujo a un usuario de Teams y esperar una respuesta: el flujo se pausa hasta que la persona haya reaccionado a la tarjeta y, después, devuelve exactamente una respuesta por destinatario y tarjeta como contenido dinámico.
• Publicar tu propia tarjeta adaptable como bot de flujo en un canal: como arriba, solo que la tarjeta aparece en un canal de equipo al que tú mismo necesitas tener acceso.
• Publicar una tarjeta adaptable como bot de flujo en un canal de Teams y esperar una respuesta: el flujo espera hasta que algún miembro del canal responda y luego procesa su entrada.

Para mensajes proactivos desde un agente de Copilot Studio, según la documentación sobre mensajes proactivos de Teams también están disponibles las acciones Post adaptive card in a chat or channel y Post adaptive card and wait for a response. Aquí seleccionas Microsoft Copilot Studio agent como Post as e indicas el destinatario y el agente deseado.

Construir tu primera Adaptive Card interactiva

Antes de empezar, según la documentación la aplicación Workflows debe estar instalada en Microsoft Teams, de lo contrario la ejecución del flujo falla con un mensaje de error claro. Así construyes la primera tarjeta:

1. Inicia sesión en Power Automate y crea un flujo de nube instantáneo con el desencadenador Activar un flujo manualmente.

2. Añade como nuevo paso la acción Publicar tarjeta adaptable en un canal de Teams y esperar una respuesta y selecciona el equipo y el canal.

3. Pega en el campo Mensaje el código JSON de tu tarjeta. Para empezar basta con una estructura con un encabezado, un texto, un Input.ChoiceSet para las opciones de selección y un botón Action.Submit al final.

4. Introduce en el campo Mensaje de actualización el texto que la tarjeta debe mostrar tras la respuesta. Sin este dato, la tarjeta simplemente se restablece después de cada envío, lo que según la documentación tiende a provocar envíos múltiples innecesarios.

5. Procesa después la respuesta en un paso siguiente, por ejemplo mediante un correo que contenga el valor seleccionado del contenido dinámico de la acción de espera de respuesta.

Cuando ejecutas el flujo, la marca de espera en el historial de ejecución te muestra que Power Automate realmente está esperando la respuesta. Solo después de que la destinataria envíe la respuesta continúa el flujo con los valores introducidos, como se describe en detalle en la guía para crear la primera tarjeta adaptable.

Procesar la respuesta en el flujo

Dentro de una Adaptive Card con wait-for-a-response, cada elemento de entrada devuelve su valor a través del ID guardado en el JSON, en el ejemplo de la documentación `acPollChoices` para una lista de selección. Encontrarás este ID en el paso siguiente como contenido dinámico y podrás usarlo directamente en correos, entradas de lista u otras condiciones.

Si en su lugar usas una tarjeta proactiva a través de un agente de Copilot Studio, según la documentación la respuesta devuelve la variable `submitActionId`, cuyo valor corresponde al título de la acción seleccionada. Para ambas variantes: detalles adicionales como el ID de usuario de la persona que respondió solo están disponibles como contenido dinámico después de la acción de espera de respuesta; para datos de perfil completos necesitas además el conector de usuarios de Office 365.

Limitaciones conocidas que deberías conocer

La documentación enumera varios puntos que en la práctica suelen causar confusión:

• Sin una acción de espera de respuesta no se pueden capturar datos de una tarjeta, cualquier botón que no sea Action.OpenUrl devuelve entonces un error.
• Cada tarjeta con wait-for-a-response solo puede enviarse una vez, todos los envíos posteriores se ignoran en silencio.
• Tras el envío, la tarjeta muestra exclusivamente el texto del campo Mensaje de actualización; de lo contrario permanece sin cambios e invita a un nuevo envío inútil.
• Las Adaptive Cards con la función de plantillas de la especificación general de Adaptive Cards no son compatibles con Power Automate.
• En el entorno del Departamento de Defensa de EE. UU., las tarjetas adaptables no están disponibles en general, pero esto solo afecta a un grupo de usuarios muy específico.

Fuentes de error habituales con las tarjetas adaptables

Además de las limitaciones estructurales, Microsoft menciona en sus propios consejos de resolución de problemas tres patrones de error recurrentes:

• Falta la aplicación Workflows: si la aplicación Workflows no está instalada en Teams, la ejecución del flujo falla. La aplicación debe configurarse en la instancia de Teams correspondiente antes de la primera prueba.
• Código JSON con formato incorrecto: la causa suele ser comillas curvas en lugar de rectas, o comillas faltantes alrededor de valores de texto. Una prueba en el diseñador de Adaptive Cards revela de forma fiable este tipo de errores antes de insertar la tarjeta en Power Automate.
• URL de imagen no válidas: las Adaptive Cards no admiten archivos de imagen incrustados, cada imagen debe incluirse mediante una URL accesible públicamente. En caso de duda, comprueba la URL directamente en el navegador antes de introducirla en la tarjeta.

Quien repase estos tres puntos antes de la puesta en producción se ahorra la mayoría de los mensajes de error que en la práctica solo aparecen tras la primera ejecución productiva. Quien utilice Power Automate como empleada digital y valore notificaciones de Teams bien construidas y de bajo mantenimiento encontrará en la consultoría de Power Automate de NordFlux apoyo para construir Adaptive Cards y su correspondiente gestión de errores.

Preguntas frecuentes

¿Puedo usar una Adaptive Card sin una acción de espera de respuesta para las entradas?

No. Según la documentación, las tarjetas sin esta acción devuelven un error para todos los botones excepto Action.OpenUrl, por lo que los datos de los campos de entrada solo pueden capturarse con una de las dos variantes de espera de respuesta.

¿Cuántas veces se puede responder a una misma Adaptive Card?

Solo una vez. Tras el primer envío, el flujo continúa; cada envío adicional de la misma tarjeta se ignora según la documentación, sin que se produzca una nueva respuesta.

¿Por qué mi tarjeta sigue teniendo exactamente el mismo aspecto después de la respuesta?

Porque no se rellenó el campo Mensaje de actualización. Sin este dato, la tarjeta simplemente se restablece después de cada envío, lo que tienta fácilmente a las destinatarias a un segundo envío inútil.

¿Funcionan las Adaptive Cards con funciones de plantillas en Power Automate?

No, la documentación señala explícitamente que la función de plantillas de la especificación general de Adaptive Cards no es compatible con Power Automate. En su lugar, construye la tarjeta con un JSON completamente rellenado, sin plantillas de marcador de posición.

¿Tengo que escribir el código JSON a mano para diseñar una tarjeta?

No necesariamente. El diseñador de Adaptive Cards ofrece una interfaz visual de arrastrar y soltar desde la que copias el código JSON terminado directamente en el campo de mensaje de la acción de Power Automate.