Skip to main content
Acessar Studio

Parâmetros do robô

Parâmetros são variáveis configuráveis associadas a um robô — como senhas, chaves de acesso, caminhos de pasta ou qualquer valor que possa mudar sem que você precise editar o fluxo do robô. Eles são especialmente úteis para informações sensíveis que não devem ficar visíveis no Designer.

Por que usar parâmetros?​

Imagine um robô que acessa um sistema com usuário e senha. Se você digitar a senha diretamente em uma ação, ela ficará visível para qualquer pessoa que abrir o Designer. Com parâmetros, a senha fica armazenada de forma segura e separada do fluxo — e só precisa ser atualizada em um lugar quando mudar.

Outros casos de uso comuns:

  • Credenciais de e-mail, banco de dados ou sistemas internos
  • Caminhos de pasta que variam por ambiente
  • Códigos de API ou tokens de acesso
  • Configurações que mudam com frequência

Acessando os parâmetros​

  1. Abra o Designer do robô desejado.
  2. Clique no ícone de etiqueta 🏷️ na barra lateral para abrir a tela de parâmetros.

Criando um novo parâmetro​

  1. Clique em Criar parâmetro (ou no botão +).
  2. Preencha os campos:
CampoObrigatórioDescrição
NomeSimIdentificador do parâmetro. Use nomes descritivos, sem espaços (ex.: senha_sistema, caminho_pasta).
ValorSimO valor que será utilizado pelo robô.
DescriçãoNãoTexto explicativo para outros usuários entenderem o que o parâmetro representa.
Tratar como segredo (senha)NãoQuando ativado, o valor fica oculto e não pode ser visualizado por ninguém.
  1. Clique em Salvar.

Parâmetros do tipo senha​

Ao ativar a opção Tratar como segredo (senha), o valor do parâmetro é armazenado de forma completamente oculta — nem você mesmo poderá visualizá-lo depois de salvo. Apenas será possível sobrescrevê-lo com um novo valor.

Parâmetros senha e dispositivos vinculados

Parâmetros do tipo senha são armazenados localmente no dispositivo. Se o dispositivo for desvinculado do robô, os valores de senha serão perdidos e precisarão ser reinseridos ao vincular um novo dispositivo.

Usando um parâmetro em uma ação​

Parâmetros criados ficam disponíveis para seleção em qualquer campo do tipo dinâmico no Designer. Para utilizá-los:

  1. No campo de configuração de uma ação, abra o modo de entrada Parâmetros.
  2. Selecione o parâmetro desejado na lista.

O robô substituirá o parâmetro pelo seu valor real no momento da execução — sem expor o valor no fluxo.

Usando parâmetros em expressões (campos de texto)​

Além de selecionar um parâmetro diretamente pelo modo Parâmetros, você pode embutir o valor de um parâmetro dentro de um campo de texto usando a seguinte sintaxe:

{{PARAMETROS.nome_do_parametro}}

Isso é especialmente útil quando o parâmetro faz parte de um valor maior, como uma URL ou uma mensagem:

ExemploResultado em execução
https://api.exemplo.com/{{PARAMETROS.cliente_id}}/dadoshttps://api.exemplo.com/abc123/dados
Olá, {{PARAMETROS.nome_usuario}}!Olá, Brendon!
Bearer {{PARAMETROS.token_api}}Bearer eyJhbGc...

Para segredos (parâmetros marcados como senha), use:

{{SEGREDOS.nome_do_segredo}}
info

O nome deve ser idêntico ao nome cadastrado no parâmetro (sem espaços). O uso de maiúsculas e minúsculas não faz diferença.

caution

A sintaxe {{PARAMETROS.X}} em campos de texto é processada em tempo de compilação — o valor não fica visível no Designer, mas é incluído no código compilado. Para valores verdadeiramente ocultos, prefira a sintaxe {{SEGREDOS.X}} (parâmetros marcados como senha).

Usando parâmetros em campos de código​

Em campos do tipo Código, você pode referenciar parâmetros e segredos dentro de template literals usando a mesma sintaxe:

// Parâmetro simples
const usuario = `{{PARAMETROS.usuario}}`

// Segredo
const senha = `{{SEGREDOS.senha_sistema}}`

// Interpolado em uma string maior
const url = `https://{{PARAMETROS.servidor}}/api/login`

return usuario

Ao executar, o robô substitui {{PARAMETROS.X}} pelo valor real do parâmetro.

Editando e removendo parâmetros​

  • Para editar um parâmetro, clique sobre ele na lista de parâmetros salvos.
  • Para remover, clique no ícone de exclusão ao lado do parâmetro.
Atualizações não quebram o fluxo

Alterar o valor de um parâmetro não exige nenhuma mudança no fluxo do robô. O robô automaticamente passa a usar o novo valor na próxima execução.

Próximos passos​