Botón enviar de tarjeta adaptable en Copilot studio no funciona: solución
🔍 WiseChecker

Botón enviar de tarjeta adaptable en Copilot studio no funciona: solución

Creó una Tarjeta Adaptable en Copilot Studio y el botón Enviar no hace nada cuando el usuario hace clic en él. La tarjeta se representa correctamente, pero al pulsar Enviar no se produce ninguna respuesta, ningún mensaje de error ni ningún cambio en el flujo de la conversación. Este fallo suele ocurrir porque el tipo de acción de la tarjeta está mal configurado o la lógica del tema del bot no controla la carga útil entrante. Este artículo explica la causa raíz del botón Enviar que no responde y proporciona soluciones paso a paso para restaurar la interactividad completa de la tarjeta.

Puntos clave: Solución del botón Enviar de Tarjeta Adaptable en Copilot Studio

  • Propiedad Action.Type de la Tarjeta Adaptable: Debe establecerse en Action.Submit — usar Action.Execute o dejarla en blanco impide que el botón funcione en Copilot Studio.
  • Frase de desencadenador y condiciones del tema: El tema del bot debe escuchar la carga útil JSON que envía la tarjeta; de lo contrario, el mensaje se ignora.
  • Conexión del flujo de Power Automate: Si la tarjeta llama a un flujo, la referencia de conexión debe estar activa en el mismo entorno que el bot.

ADVERTISEMENT

Por qué el botón Enviar de la Tarjeta Adaptable deja de responder

El botón Enviar de una Tarjeta Adaptable envía una carga útil JSON estructurada de vuelta al bot. Copilot Studio procesa esta carga útil a través de su motor de temas. Si el tipo de acción no es Action.Submit, la plataforma no enruta la carga útil a ningún tema. El botón parece en el que se puede hacer clic, pero no produce ningún efecto visible.

Una segunda causa común es una discrepancia entre la carga útil de la tarjeta y las condiciones de desencadenador del tema. Los temas de Copilot Studio usan frases de desencadenador y reconocimiento de entidades. Los envíos de Tarjetas Adaptables son mensajes de texto que contienen una cadena JSON. Si el tema espera una frase de texto simple como “submit order” pero recibe un objeto JSON, el bot ignora el mensaje.

Una tercera causa implica flujos de Power Automate adjuntos a la tarjeta. Cuando el botón Enviar desencadena un flujo, el flujo debe ser propiedad de un usuario activo y debe existir en el mismo entorno de Microsoft Dataverse. Un flujo deshabilitado o una referencia de conexión faltante da como resultado un fallo silencioso.

Pasos para solucionar el botón Enviar en Copilot Studio

  1. Verifique la propiedad Action.Type en el JSON de la tarjeta
    Abra el editor JSON de Tarjeta Adaptable en Copilot Studio. Localice la matriz "actions". Cada botón debe tener "type": "Action.Submit". Si el tipo es Action.Execute o falta, cámbielo a Action.Submit. Ejemplo: {"type": "Action.Submit", "title": "Submit", "data": {"action": "submitForm"}}. Guarde la tarjeta y vuelva a probar.
  2. Compruebe la frase de desencadenador del tema y la asignación de entidades
    Vaya al tema que debe controlar el envío de la tarjeta. En la sección de desencadenador, agregue una frase de desencadenador que coincida con la clave de datos en la carga útil de su tarjeta. Por ejemplo, si los datos de su tarjeta contienen {"action": "submitForm"}, agregue la frase de desencadenador submitForm. Luego agregue una condición que compruebe que Activity.Text contiene la cadena JSON esperada. Use la variable System.Activity.Text para inspeccionar el mensaje sin procesar.
  3. Confirme que el flujo de Power Automate esté activo y conectado
    Si la tarjeta usa un flujo de Power Automate, abra el flujo en el portal de Power Automate. Asegúrese de que el estado del flujo esté establecido en On. Compruebe las referencias de conexión utilizadas por el flujo. Vuelva a autenticar las conexiones expiradas. Regrese a Copilot Studio y vuelva a guardar el tema que llama al flujo. Publique el bot y pruebe la tarjeta de nuevo.
  4. Pruebe la carga útil de la tarjeta manualmente en el panel de prueba
    En Copilot Studio, abra el panel de prueba. Envíe un mensaje que contenga la carga útil JSON exacta que envía su tarjeta. Use el formato {"action": "submitForm", "field1": "value"}. Si el bot responde correctamente al mensaje manual pero no a la tarjeta, el problema está en la estructura JSON de la tarjeta. Si el bot también ignora el mensaje manual, el desencadenador o la condición del tema son incorrectos.
  5. Habilite el registro de depuración para el bot
    Vaya a Configuración > General > Habilitar registro detallado. Reproduzca el problema. Descargue el archivo de registro y busque AdaptiveCard o Submit. El registro muestra si Copilot Studio recibió la carga útil y con qué tema coincidió. Use estos datos para ajustar las condiciones del desencadenador.

ADVERTISEMENT

Si el botón Enviar sigue sin funcionar

El botón Enviar de la Tarjeta Adaptable de Copilot Studio no envía ningún dato

El botón se activa pero el bot recibe un objeto vacío {}. Esto ocurre cuando la tarjeta usa Action.Submit sin una propiedad data. Agregue un objeto data a la definición de la acción. Por ejemplo: {"type": "Action.Submit", "title": "Submit", "data": {"action": "submitSurvey"}}. El bot puede entonces leer Activity.Text para encontrar la clave action.

El botón Enviar de la Tarjeta Adaptable de Copilot Studio funciona en la vista previa pero no en producción

El entorno de vista previa usa un id. de bot diferente al del bot publicado. Después de publicar, el tema debe guardarse y volverse a publicar. Abra el tema, haga un cambio menor, como agregar un espacio en un mensaje, guárdelo y publique el bot. El bot de producción ahora usa el tema actualizado.

El botón Enviar de la Tarjeta Adaptable de Copilot Studio desencadena el tema incorrecto

Varios temas tienen frases de desencadenador que coinciden con la carga útil de la tarjeta. El bot enruta el envío al tema con la prioridad más alta. Reordene los temas en la lista de Temas. Arrastre el tema deseado más arriba. Como alternativa, agregue una condición al tema que compruebe un valor de entidad único para esta tarjeta, como un campo cardId específico.

Elemento Action.Submit (Correcto) Action.Execute (Incorrecto)
Cadena de tipo de acción Action.Submit Action.Execute
Método de entrega de carga útil Enviado como mensaje de texto al bot Enviado como una actividad de invocación que Copilot Studio ignora
Desencadenador de tema requerido Frase de desencadenador que coincide con la clave de datos en la carga útil No compatible — ningún tema puede recibirlo
Compatibilidad con Power Automate Funciona con desencadenadores de flujo No se enruta al motor de flujo del bot

La causa raíz de un botón Enviar que no funciona casi siempre es el tipo de acción. Cambie Action.Execute a Action.Submit y verifique que la frase de desencadenador del tema coincida con la clave de datos de la carga útil. Pruebe la carga útil manualmente usando el panel de prueba antes de publicar. Si la tarjeta llama a un flujo de Power Automate, confirme que el flujo esté activo y que sus conexiones estén autenticadas. Con estas comprobaciones en su lugar, el botón Enviar de la Tarjeta Adaptable enviará datos de forma confiable a su bot de Copilot Studio.

ADVERTISEMENT