Parâmetros
Parâmetros
Parâmetros são valores configuráveis que podem ser injetados dinamicamente em diferentes passos de um fluxo. Eles tornam os Flowkits flexíveis e reutilizáveis — você define o valor uma vez e ele se propaga por todos os fluxos que o referenciam.
Ativando um Flowkit? Os parâmetros são configurados durante o assistente de ativação. Consulte Ativando pelo Console ou Ativando por API Key.
Criando um Flowkit? Os parâmetros que você define aqui serão solicitados a quem ativar o Flowkit. Consulte Criando um Flowkit.
Como os parâmetros funcionam
Ao ativar um Flowkit, você preenche os valores dos parâmetros definidos pelo criador do Flowkit. Esses valores são injetados nos passos dos fluxos no momento da execução, sem necessidade de editar cada passo individualmente.
Nos fluxos, os parâmetros aparecem com a seguinte sintaxe:
[[flowkit.params.nomeDaVariavel]]Nos campos de configuração dos passos, eles são referenciados com chaves duplas:
{{get `steps.condition.sheet_id`}}
{{get `steps.condition.product_id`}}Vantagens do uso de parâmetros
Flexibilidade — um mesmo Flowkit pode ser ativado com configurações diferentes para cada cliente, projeto ou ambiente, sem duplicar fluxos.
Manutenção centralizada — ao atualizar um parâmetro, a mudança se reflete em todos os fluxos que o utilizam. Não é necessário buscar e editar cada instância manualmente.
Reutilização — parâmetros como IDs de planilha, chaves de API ou URLs de endpoint podem ser compartilhados entre múltiplos fluxos de um mesmo Flowkit.
Exemplos de uso
E-mails personalizados — use parâmetros para inserir dinamicamente nomes de destinatários, assunto e conteúdo, adaptando o fluxo para diferentes campanhas ou públicos.
Integração com APIs — armazene chaves de API e tokens de acesso como parâmetros para facilitar a rotação de credenciais sem alterar a lógica dos fluxos.
Identificadores de recursos — IDs de planilhas, produtos, contas ou canais podem ser parametrizados, tornando o Flowkit aplicável a múltiplos contextos com uma única ativação.
Ambientes múltiplos — use parâmetros para alternar entre endpoints de homologação e produção sem modificar os fluxos.
Criando parâmetros em um Flowkit
Se você é o criador do Flowkit, defina os parâmetros na etapa de Configuração de Parâmetros durante a criação. Para cada parâmetro, especifique:
Campo | Descrição |
|---|---|
key | Identificador do parâmetro, usado na sintaxe de referência nos passos |
type | Tipo do valor esperado: string, number, boolean |
required | Se o preenchimento é obrigatório durante a ativação |
description | Instrução exibida para quem for ativar o Flowkit |