Erro "The template language function 'int' was invoked with a parameter that is not valid"
A função int só converte textos que sejam inteiros de verdade, como '3' ou '120'. Quando recebe um texto com casa decimal ('3.14'), com letras ('abc') ou um valor nulo, ela não arredonda nem ignora: o fluxo para na hora com InvalidTemplate. O erro aparece na...
A mensagem completa
The template language function 'int' was invoked with a parameter that is not valid. The value cannot be converted to the target type.
No histórico de execuções, essa mensagem aparece dentro de uma frase maior: Unable to process template language expressions in action 'NOME_DA_ACAO' inputs at line '0' and column '0': '...'. O nome da ação é o da ação que contém a expressão e muda de fluxo para fluxo. O trecho em destaque acima é o que identifica o problema.
O que significa
A função int só converte textos que sejam inteiros de verdade, como '3' ou '120'. Quando recebe um texto com casa decimal ('3.14'), com letras ('abc') ou um valor nulo, ela não arredonda nem ignora: o fluxo para na hora com InvalidTemplate. O erro aparece na ação que contém a expressão, não na ação que produziu o valor, o que costuma confundir.
Causas mais comuns
- O texto tem casa decimal. int('3.14') falha mesmo que o número pareça simples; a função não corta nem arredonda.
- O valor veio de um campo vazio ou inexistente (null), por exemplo de uma coluna do SharePoint ou de uma pergunta do Forms que ficou em branco.
- O texto tem letras, símbolos, espaços ou o formato brasileiro (por exemplo '1.234'), que não é um inteiro para a função.
- O dado veio de um arquivo (CSV, Excel) como texto e ninguém conferiu o conteúdo antes de converter.
Como corrigir
- Descubra o valor real que chegou à ação: abra a execução e veja a entrada da ação anterior.
- Se o texto é um inteiro, converta direto: int('3') devolve 3.
- Se o texto tem casa decimal e você quer o inteiro mais próximo, arredonde antes com formatNumber e o formato F0, e só depois use int.
- Se o valor pode vir vazio, trate antes: use coalesce para trocar o vazio por '0' e então converta.
Exemplo: antes e depois
| Expressão | Resultado no Power Automate |
|---|---|
int('3.14') | Erro. The template language function 'int' was invoked with a parameter that is not valid. The value cannot be converted to the target type. |
int(formatNumber(float('3.14'),'F0')) | 3 |
Os dois resultados vêm da execução real de 09/11/2026, e um teste automático do Me Ajuda Flow confere que o texto desta página é idêntico ao registrado.
Como evitar que o erro volte
- Veja o valor real: abra a execução e confira a entrada da ação que falhou, não só a expressão.
- Trate vazio e tipo antes de calcular: use
coalescepara vazio eintoufloatpara texto que parece número. - Confira a expressão antes de rodar: o analisador de fluxo e o verificador de expressões apontam parte desses problemas sem executar o fluxo.
Perguntas frequentes
Por que int('3.14') não arredonda?
Porque a função foi feita para texto que já é um inteiro. Ela não trunca nem arredonda. Para obter o inteiro, converta com float e formate com 'F0', como no exemplo acima.
O erro aparece em outra ação, não onde o valor foi criado. Isso é normal?
É. O Power Automate calcula a expressão no momento em que a ação roda. O valor ruim pode ter sido criado antes, mas só falha onde o int é chamado.