Botão Enviar do Cartão Adaptável do Copilot Studio Não Funciona: Correção

Você criou um Cartão Adaptável no Copilot Studio e o botão Enviar não faz nada quando o usuário clica. O cartão é exibido corretamente, mas tocar em Enviar não produz resposta, mensagem de erro ou alteração no fluxo da conversa. Essa falha geralmente ocorre porque o tipo de ação do cartão está mal configurado ou a lógica do tópico do bot não lida com a carga útil recebida. Este artigo explica a causa raiz do botão Enviar sem resposta e fornece correções passo a passo para restaurar a interatividade total do cartão.

Por que o Botão Enviar do Cartão Adaptável Para de Responder

O botão Enviar em um Cartão Adaptável envia uma carga útil JSON estruturada de volta para o bot. O Copilot Studio processa essa carga útil por meio de seu mecanismo de tópicos. Se o tipo de ação não for Action.Submit, a plataforma não roteia a carga útil para nenhum tópico. O botão parece clicável, mas não produz efeito visível.

Uma segunda causa comum é uma incompatibilidade entre a carga útil do cartão e as condições de gatilho do tópico. Os tópicos do Copilot Studio usam frases de gatilho e reconhecimento de entidades. As submissões de Cartão Adaptável são mensagens de texto que contêm uma string JSON. Se o tópico espera uma frase de texto simples como “enviar pedido”, mas recebe um objeto JSON, o bot ignora a mensagem.

Uma terceira causa envolve fluxos do Power Automate anexados ao cartão. Quando o botão Enviar aciona um fluxo, o fluxo deve ser de propriedade de um usuário ativo e deve existir no mesmo ambiente do Microsoft Dataverse. Um fluxo desabilitado ou uma referência de conexão ausente resulta em uma falha silenciosa.

Passos para Corrigir o Botão Enviar no Copilot Studio

1. Verifique a propriedade Action.Type no JSON do cartão
   Abra o editor JSON do Cartão Adaptável no Copilot Studio. Localize o array "actions". Cada botão deve ter "type": "Action.Submit". Se o tipo for Action.Execute ou estiver ausente, altere para Action.Submit. Exemplo: {"type": "Action.Submit", "title": "Enviar", "data": {"action": "submitForm"}}. Salve o cartão e teste novamente.
2. Verifique a frase de gatilho e o mapeamento de entidades do tópico
   Vá para o tópico que deve lidar com a submissão do cartão. Na seção de gatilho, adicione uma frase de gatilho que corresponda à chave de dados na carga útil do seu cartão. Por exemplo, se os dados do seu cartão contêm {"action": "submitForm"}, adicione a frase de gatilho submitForm. Em seguida, adicione uma condição que verifica se Activity.Text contém a string JSON esperada. Use a variável System.Activity.Text para inspecionar a mensagem bruta.
3. Confirme se o fluxo do Power Automate está ativo e conectado
   Se o cartão usa um fluxo do Power Automate, abra o fluxo no portal do Power Automate. Certifique-se de que o status do fluxo esteja definido como Ativado. Verifique as referências de conexão usadas pelo fluxo. Reautentique quaisquer conexões expiradas. Volte ao Copilot Studio e salve novamente o tópico que chama o fluxo. Publique o bot e teste o cartão novamente.
4. Teste a carga útil do cartão manualmente no painel de Teste
   No Copilot Studio, abra o painel de Teste. Envie uma mensagem que contenha exatamente a carga útil JSON que seu cartão envia. Use o formato {"action": "submitForm", "field1": "value"}. Se o bot responder corretamente à mensagem manual, mas não ao cartão, o problema está na estrutura JSON do cartão. Se o bot ignorar a mensagem manual também, o gatilho ou a condição do tópico está errado.
5. Ative o log de depuração para o bot
   Vá em Configurações > Geral > Ativar registro detalhado. Reproduza o problema. Baixe o arquivo de log e pesquise por AdaptiveCard ou Submit. O log mostra se o Copilot Studio recebeu a carga útil e qual tópico foi correspondido. Use esses dados para ajustar as condições de gatilho.

Se o Botão Enviar Ainda Não Funcionar

Botão Enviar do Cartão Adaptável do Copilot Studio não envia dados

O botão dispara, mas o bot recebe um objeto vazio {}. Isso acontece quando o cartão usa Action.Submit sem uma propriedade data. Adicione um objeto data à definição da ação. Por exemplo: {"type": "Action.Submit", "title": "Enviar", "data": {"action": "submitSurvey"}}. O bot pode então ler Activity.Text para encontrar a chave action.

Botão Enviar do Cartão Adaptável do Copilot Studio funciona na prévia, mas não em produção

O ambiente de prévia usa um ID de bot diferente do bot publicado. Após a publicação, o tópico deve ser salvo e republicado novamente. Abra o tópico, faça uma pequena alteração, como adicionar um espaço em uma mensagem, salve e publique o bot. O bot de produção agora usa o tópico atualizado.

Botão Enviar do Cartão Adaptável do Copilot Studio aciona o tópico errado

Vários tópicos têm frases de gatilho que correspondem à carga útil do cartão. O bot roteia a submissão para o tópico com a prioridade mais alta. Reordene os tópicos na lista de Tópicos. Arraste o tópico desejado para cima. Alternativamente, adicione uma condição ao tópico que verifique um valor de entidade exclusivo deste cartão, como um campo cardId específico.

Item	Action.Submit (Correto)	Action.Execute (Incorreto)
String do tipo de ação	Action.Submit	Action.Execute
Método de entrega da carga útil	Enviada como mensagem de texto para o bot	Enviada como uma atividade de invocação que o Copilot Studio ignora
Gatilho de tópico necessário	Frase de gatilho correspondente à chave de dados na carga útil	Não suportado — nenhum tópico pode recebê-la
Suporte ao Power Automate	Funciona com gatilhos de fluxo	Não roteia para o mecanismo de fluxo do bot

A causa raiz de um botão Enviar que não funciona é quase sempre o tipo de ação. Altere Action.Execute para Action.Submit e verifique se a frase de gatilho do tópico corresponde à chave de dados da carga útil. Teste a carga útil manualmente usando o painel de Teste antes de publicar. Se o cartão chamar um fluxo do Power Automate, confirme se o fluxo está ativo e suas conexões estão autenticadas. Com essas verificações em vigor, o botão Enviar do Cartão Adaptável enviará dados de forma confiável para o seu bot do Copilot Studio.