Code da Pluga: como e onde usar nas suas automatizações

O que você verá neste artigo

Nas integrações da Pluga, o bloco Code funciona como um espaço onde você escreve um pequeno script em Python ou JavaScript e conecta esse trecho de código ao restante do fluxo, do mesmo jeito que faria com qualquer outra ferramenta.

É um recurso que abre diversas possibilidades novas, como por exemplo:

Cálculos financeiros com regras próprias;
Padronização de dados que vêm de canais diferentes;
Integração com APIs que ainda não têm conector nativo por aqui;
E por aí vai.

Despertou a curiosidade? Então continua a leitura pra entender como o Code pode aparecer nas suas automatizações.

Como funciona o Code da Pluga na prática

O Code é um bloco nativo da Pluga que roda scripts em Python ou JavaScript dentro do seu fluxo. As duas linguagens funcionam do mesmo jeito, então você escolhe aquela com que se sente mais à vontade.

O Code pode aparecer de duas formas na sua automatização:

Como gatilho:

Quando o Code consulta uma API externa, pega o dado e a partir dali o fluxo começa a rodar

Como ação:

Quando o Code recebe informações de um passo anterior, aplica a lógica que você escreveu e devolve o resultado pra o próximo passo da automatização usar.

Você escolhe a posição do bloco no fluxo, escreve o script e o restante da automatização continua sendo montado do jeito visual que você já conhece.

Você pode usar o Code para:

Aplicar regras de cálculo específicas do seu negócio, como tarifas, comissões e impostos;
Padronizar dados que chegam em formatos diferentes de cada canal (leads, pedidos, cadastros);
Consultar APIs de sistemas que ainda não têm conector nativo na Pluga;
Classificar leads ou registros com um critério exclusivo, antes de mandar pro CRM;
Montar e enviar requisições pra sistemas internos da empresa;

E muito mais.

Exemplos de uso do Code

Nada como ver o recurso rodando em situações reais pra entender onde ele encaixa na sua operação. Separamos quatro casos que aparecem com frequência na base.

Veja também: 15 scripts prontos para copiar e usar no Code da Pluga (Python e JavaScript)

Regras financeiras que mudam por cenário

Muitas empresas trabalham com cobranças em que a taxa efetiva varia conforme o número de parcelas: uma porcentagem pra pagamento à vista, outra de 2 a 6 vezes, outra acima disso.

A plataforma de cobrança sabe cobrar, o ERP sabe registrar, mas ninguém sabe calcular a taxa correta que sobra pra sua empresa em cada operação. E é justamente esse número que precisa entrar limpo no ERP, na planilha de conciliação e no relatório do contador.

O fluxo fica assim: cobrança criada no Asaas ➝ Code aplica a regra ➝ resultado normalizado segue pro seu ERP ou planilha.

Faz muito sentido pra e-commerces com vários meios de pagamento, BPOs financeiros que cuidam da operação de múltiplos clientes e infoprodutores que precisam fechar a conciliação todo mês.

O ganho é ter uma regra escrita uma vez que passa a rodar automaticamente pra cada nova transação, sempre com a mesma precisão.

Leads sempre prontos pra entrar no CRM

Quando você capta leads em vários canais (Facebook Lead Ads, formulário do site, landing page da campanha), é comum que cada canal mande o dado de um jeito. Telefone sem código do país, estado escrito “São Paulo” num lead e “SP” em outro, nome completo num campo único quando o CRM espera primeiro nome e sobrenome separados.

O Code recebe o lead exatamente como veio, faz a limpeza dos campos e entrega tudo já no padrão que o seu CRM espera.

Assim, o time não perde mais tempo padronizando dados, ou corrrigindo dados incorretos.

O fluxo: o lead preenche um formulário, o Code padroniza estado, telefone e separa o nome, e a informação entra no RD Station CRM já no formato certo, do primeiro ao último cadastro.

Encaixa muito bem em agências de marketing (que rodam campanhas pra vários clientes e precisam entregar dado limpo), imobiliárias (que dependem de contato rápido e não podem perder tempo formatando), corretoras e clínicas de saúde e estética.

Com os leads padronizados, o CRM funciona melhor de ponta a ponta: a deduplicação acontece, a cadência automática de mensagem sai certinha e os relatórios por região saem sem furos.

Conecte APIs que a Pluga ainda não integra

Às vezes você precisa de um dado que não mora em nenhuma das ferramentas que a Pluga já integra nativamente:

A cotação do dólar no Banco Central pra atualizar um preço;
Uma API de logística pra calcular frete antes de fechar a venda;
Um serviço de validação de CNPJ antes de cadastrar um cliente novo no ERP.

Ou o caminho inverso: você quer mandar informação pra um sistema interno da empresa, ou pra um SaaS de nicho que ainda não tem conector por aqui.

Nesses casos, o Code atua nas suas duas funções:

Como gatilho, ele consulta a API (Banco Central, API de frete, o que for), pega o dado e o fluxo começa dali.

Como ação, ele monta o payload da requisição, faz o POST pro sistema que você quer e o próximo passo trata o retorno.

Faz especialmente sentido para quem quer consumir APIs específicas do próprio setor, como consultorias, SaaS e agências que atendem verticais mais especializadas.

Lead scoring com regras exclusivas do seu negócio

Muita gente precisa classificar leads antes de mandar pro time de vendas, mas o critério que faz sentido pra cada negócio é composto: combina origem do tráfego, valor do produto de interesse, região, tamanho da empresa e comportamento em página.

E o mais importante: a regra precisa gerar o mesmo resultado toda vez, sem espaço pra interpretação criativa no meio, como uma etapa de IA faria, por exemplo.

O Code recebe os dados do lead, aplica a lógica de pontuação que você escreveu e devolve um score ou uma categoria (A/B/C).

Depois, o Roteador leva o lead pra cada braço do fluxo: quem é A entra no CRM com prioridade enquanto quem é B segue direto pra cadência de nutrição por e-mail, por exemplo.

Esse tipo de fluxo pode ser especialmente útil para agências de tráfego pago que precisam encaminhar leads para os seus clientes já com a prioridade de atendimento configurada. Ou então SaaS que rodam PLG com sinais de intenção, consultorias que qualificam antes do primeiro contato e escritórios jurídicos que fazem triagem de caso por complexidade.

Como adicionar o Code às automatizações

Como já vimos, o Code se comporta exatamente como as outras ferramentas e funcionalidades nativas da Pluga.

Você posiciona onde faz sentido no fluxo, mapeia os campos que ele vai receber como entrada, escreve o script e declara quais campos ele vai devolver na saída.

Não sabe escrever o script? Peça ajuda a uma IA

Mesmo que você não saiba escrever código em Python ou JavaScript, você pode escrever aquilo que precisa em um chat com uma IA, como o ChatGPT, Claude ou Gemini.

Abaixo, seguem dois modelos de prompt para você copiar e colar na IA para obter um script da maneira certa:

Modelo de prompt para gerar os scripts em Python:

Prompt

Preciso de um código em Python 3 que será executado dentro de uma etapa de automação. Use o dicionário 'input_data' para acessar os dados de entrada e retorne um dicionário com os dados de saída, que será usado nas próximas etapas.Importante: todos os valores em 'input_data' chegam como string. Se precisar fazer conta, converta com float() ou int() antes.O que quero que o código faça:[descreva em uma frase o que o script precisa resolver]Campos de entrada que estarão disponíveis em input_data:- [nome_do_campo_1]: [o que é / exemplo do valor]
- [nome_do_campo_2]: [o que é / exemplo do valor]Campos de saída que preciso que o retorno tenha:- [nome_do_campo_saida_1]: [o que é / tipo]
- [nome_do_campo_saida_2]: [o que é / tipo]

Modelo de prompt para gerar os scripts em JavaScript:

Prompt

Preciso de um código em JavaScript (Node.js 24) que será executado dentro de uma etapa de automação. Use o objeto 'inputData' para acessar os dados de entrada e retorne um objeto com os dados de saída, que será usado nas próximas etapas.Importante: todos os valores em 'inputData' chegam como string. Se precisar fazer conta, converta com Number() antes.O que quero que o código faça:[descreva em uma frase o que o script precisa resolver]Campos de entrada que estarão disponíveis em inputData:- [nome_do_campo_1]: [o que é / exemplo do valor]- [nome_do_campo_2]: [o que é / exemplo do valor]Campos de saída que preciso que o retorno tenha:- [nome_do_campo_saida_1]: [o que é / tipo]- [nome_do_campo_saida_2]: [o que é / tipo]

Uma vez que as chaves de saída estejam declaradas, os dados que saíram do Code viram variáveis normais da Pluga, prontas pra usar no mapeamento de qualquer ferramenta seguinte.

Você pode usar para preencher linhas do Google Sheets, para compor mensagens de Slack ou preencher campos de um CRM, exatamente como faria com qualquer outra ferramenta integrada.

E o Code fica ainda mais interessante quando combinado com outros blocos:

Combinação	O que dá pra fazer
Code + Roteador	O Code calcula uma classificação (pontuação, tier, categoria) e o Roteador direciona para o caminho certo.
Code + Loop	O Code monta uma lista (por exemplo, os itens de um pedido) e o Loop processa item por item.
Code + Delay	O Code calcula uma data específica (tipo “3 dias úteis a partir de hoje, pulando feriados”) e o Delay segura o fluxo até chegar aquele momento.

Com o Code da Pluga, você tem um novo espaço no fluxo pra você trabalhar os dados com total flexibilidade e controle. Faça seu login ou crie uma conta gratuita na Pluga e comece a explorar o Code na sua próxima automatização.

Conhecer o Code da Pluga

Perguntas frequentes

Preciso saber programar pra usar o Code da Pluga?

Ajuda saber ler ou escrever um script pequeno em Python ou JavaScript, mas não precisa ser desenvolvedor. Quem já mexeu em fórmula complexa de planilha ou já ajustou um script pronto costuma se dar bem. E uma dica: você pode usar uma IA (ChatGPT, Claude, Gemini) pra escrever o script pra você, é só pedir com contexto claro sobre o que você precisa.

Python ou JavaScript: qual é a melhor opção?

As duas linguagens funcionam do mesmo jeito dentro do Code. Escolha a que você (ou quem for cuidar do script depois) domina melhor. Se está começando do zero, muita gente acha Python um pouco mais fácil de ler.

Posso usar o Code sozinho, sem outros blocos na automatização?

Pode. O Code pode ser o gatilho da automatização, buscando dado de uma API, e pode ser a última ação, enviando dado pra um sistema externo. Nesses casos, ele começa ou encerra o fluxo sem precisar de um conector nativo.

E se o script der algum erro?

Você testa o script no próprio editor da automatização antes de ativar o fluxo pra valer. Se aparecer alguma mensagem de erro difícil de entender, o time de suporte da Pluga ajuda a decifrar.

O Code está disponível em qual plano?

Isso varia com o plano contratado. Vale conferir na página de planos ou falar com o time da Pluga pra ver o encaixe.

Code da Pluga: rode scripts dentro das suas automatizações