Testar e editar ações personalizadas

Use o botão Testar para executar uma chamada real, ler a resposta e ajustar, ativar ou excluir a ação sem afetar a conversa.

Jun 26, 2026

Veja este passo no vídeo · Ações personalizadas: parâmetros, variáveis e teste

Por que testar antes

Antes de deixar o agente usar uma ação na frente de um cliente, vale a pena testá-la. O botão Testar executa uma chamada real à sua API e mostra a resposta como está, para você confirmar que a URL, os headers e o mapeamento funcionam.

Requisito

O botão Testar só fica habilitado depois de salvar a ação pelo menos uma vez. Se estiver criando uma ação nova, clique primeiro em Salvar ação.

Passos para testar

  1. Abra Agentes de IA, entre no agente e vá até a aba Ações personalizadas.
  2. Clique no lápis (Editar) sobre a ação que deseja testar.
  3. No final do formulário, clique em Testar.
  4. Aguarde o resultado: o botão mostra Testando... e então aparece um painel com a resposta.

Como ler o resultado

  • Um ponto verde e Resposta OK indicam que sua API respondeu com sucesso (HTTP 2xx).
  • Um ponto vermelho e Falhou indicam um erro: o painel mostra o código HTTP ou a mensagem da falha.
  • O corpo JSON é exibido por completo. Compare-o com o Campo a extrair que você configurou para confirmar que aponta para o valor certo.

O botão Testar tem limite de 10 execuções por minuto por usuário. Se ultrapassar, aguarde alguns segundos antes de tentar de novo.

Editar uma ação

  1. Na lista, clique no lápis (Editar).
  2. Altere o que precisar: identidade, método, URL, headers, body, parâmetros ou o campo a extrair.
  3. Clique em Salvar ação. As mudanças se aplicam imediatamente às próximas conversas.

Ativar, desativar ou excluir

  • Ativar/desativar: use o interruptor de cada linha. Uma ação Inativa continua salva, mas o agente não a usa — ideal para pausar sem perder a configuração.
  • Excluir: clique no ícone de lixeira. Ele pede confirmação porque não pode ser desfeito.

Se não funcionar

  • O botão Testar está desabilitado: você ainda não salvou a ação; clique em Salvar ação.
  • Falhou com um código 401 ou 403: verifique o header Authorization e se o token é válido.
  • Falhou com timeout: sua API demorou mais que o Timeout (s) configurado; aumente-o (até 60 s) ou revise o desempenho do endpoint.
  • Resposta OK mas o agente não usa o dado: ajuste o Campo a extrair ou a Descrição da ação.

Dica: teste com dados reais do contato para detectar problemas de formato (ex.: telefones ou e-mails) antes de colocar em produção.

Dica: se for fazer mudanças grandes, desative a ação enquanto a ajusta para que o agente não a use pela metade.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp