Transformar Dados

Quando usar

• Recebeu dados de um webhook com nomes de campos diferentes do que o proximo node espera


• Precisa extrair apenas alguns campos de um objeto grande


• Quer renomear campos para nomes mais claros antes de usar no fluxo


• Precisa converter tipos de dados (ex: string para numero) para usar em condicoes


• Quer padronizar a estrutura de dados vindos de diferentes fontes

---

Como funciona

O node recebe um objeto de origem (selecionado via variavel) e aplica um conjunto de mapeamentos. Cada mapeamento extrai um campo da origem (pelo nome da chave), da um novo nome a ele e define o tipo de dado esperado. O resultado e um novo objeto com a estrutura definida pelos mapeamentos.

O schema de saida e dinamico — ele e atualizado automaticamente conforme voce adiciona ou remove mapeamentos. Isso significa que nodes seguintes conseguem ver as variaveis exatas que este node vai produzir.

---

Configuracoes

Variavel de Origem (Objeto)

Campo obrigatorio. Selecione o objeto cujos campos voce deseja mapear. Aceita variaveis dinamicas.

Exemplo: `{{trigger.output.body}}`, `{{webhook.output.body}}`, `{{findContact.output}}`

Mapeamento de Campos de Saida

Lista de mapeamentos onde cada linha define uma transformacao. Clique em Adicionar mapeamento para incluir uma nova linha.

Cada mapeamento tem tres colunas:

| Coluna | Descricao |
|--------|-----------|
| Campo na Origem | Nome da chave no objeto original. Ex: `nome_cliente`, `email_address` |
| Nome de Saida | Novo nome que essa variavel tera na saida. Ex: `nome`, `email` |
| Tipo | Tipo do dado esperado |

Tipos disponiveis

| Tipo | Icone | Descricao |
|------|-------|-----------|
| Texto | Fonte | Valor textual (string) |
| Numero | Hashtag | Valor numerico (inteiro ou decimal) |
| Booleano | Toggle | Verdadeiro ou falso |
| Data | Calendario | Data/hora |
| Objeto | Chaves | Objeto complexo (JSON) |
| Lista | Colchetes | Array de valores |

---

Dados de saida

O schema de saida e completamente dinamico e depende dos mapeamentos configurados. Cada mapeamento com um "Nome de Saida" preenchido gera uma variavel de saida.

Exemplo: Se voce configurar:

| Campo na Origem | Nome de Saida | Tipo |
|-----------------|---------------|------|
| `nome_cliente` | `nome` | Texto |
| `valor_total` | `valor` | Numero |
| `data_pedido` | `data` | Data |

As variaveis de saida serao:

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `nome` | Texto | Mapeado de `nome_cliente` |
| `valor` | Numero | Mapeado de `valor_total` |
| `data` | Data | Mapeado de `data_pedido` |

---

Dicas

• Use este node como um tradutor entre sistemas. Por exemplo, um webhook envia `customer_name` mas o node de e-mail espera `nome` — o transform faz essa ponte.


• O "Nome de Saida" deve ser um identificador simples, sem espacos ou caracteres especiais. Use `camelCase` ou `snake_case`.


• Defina o tipo correto para cada campo — isso ajuda nodes seguintes (como Se / Senao) a fazer comparacoes adequadas.


• Se o campo na origem nao existir no objeto, o valor sera `null`. Use o node Se / Senao apos o transform para verificar valores nulos se necessario.


• Voce pode adicionar quantos mapeamentos precisar. Apenas os campos mapeados estarao disponiveis na saida — campos nao mapeados sao ignorados.


• Combine com o gatilho Webhook para padronizar dados de diferentes fontes externas em uma estrutura unica antes de processar.