---
title: passos
slug: passos
description: Learn how to customize and configure steps within the Fluid platform to create highly flexible and automated integration flows. Each step in a flow performs a specific action, such as extracting and transforming data, and loading it into a destination. Ac
docTags: 
createdAt: 2023-09-26T22:33:29.498Z
---

## Visão geral

Um **passo**, dentro do contexto de um fluxo na plataforma Fluid, é uma unidade individual de operação que executa uma ação específica. Ele define a lógica de negócio ou a manipulação de dados necessária para avançar no processo de integração. Passos são os elementos fundamentais de um fluxo, permitindo a criação de processos detalhados e multifacetados.



![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/yMlQuHo7RPd2Ug_Z9cHU__image.png)

## Função dos passos

Cada passo em um fluxo executa uma tarefa, como:

- Acessar um serviço web
- Processar/transformar dados
- Realizar uma consulta a um banco de dados
- Tomar uma decisão lógica para onde direcionar a execução do fluxo
- Invocar uma API externa (quando aplicável)

Os passos são encadeados para formar um fluxo coerente, onde a saída de um passo serve como entrada para o próximo, estabelecendo uma cadeia lógica de operações.

### Importante: nem todo passo gera uma requisição

Com a atualização no modelo de monitoramento da plataforma, é relevante destacar que:

- **Passo ≠ requisição**
- Muitos tipos de passos não geram chamadas externas e, portanto, **não aparecem** na listagem de requisições.
- Exemplos de passos que não geram requisições: `Transform`, `If`, `Wait`, `Loop`, entre outros.

Esse design melhora a clareza e a adequação dos dados no monitoramento, eliminando ruídos causados por requisições artificiais — um avanço significativo na precisão das métricas.

## Tipos de passos

A plataforma Fluid oferece diferentes tipos de passos, dependendo da complexidade e do conector utilizado:

- **Passos de leitura e escrita**: usados para buscar ou enviar dados em sistemas externos ou internos.
- **Passos de transformação**: modificam dados conforme regras ou lógica definidas.
- **Passos de controle de fluxo**: direcionam a execução com base em condições ou resultados, sem envolvimento externo.

## Configuração dos passos

A configuração de um passo é realizada por meio da interface gráfica:

1. Arraste o conector desejado para o canvas.
2. Acesse a aba **Propriedades**.
3. Defina o **identificador** do passo (obrigatório).
4. Opcionalmente, insira um **nome de visualização**.
5. Configure os **parâmetros** necessários para o comportamento do passo.
6. Especifique as [Conexões](docId\:fDR1Y5sRGt0DnLVqkUekJ) caso seja necessário.
7. Salve as alterações.

### Identificador do passo

- Deve ser único dentro do fluxo.
- Não pode conter espaços ou caracteres especiais.
- Usado internamente e em expressões dinâmicas.
- Se não definido, será exibido no lugar do nome de visualização.

### Nome de visualização

- Rótulo amigável exibido na interface.
- Diferente do identificador, pode conter espaços e caracteres especiais.
- Facilita a leitura e organização dos fluxos.
- Pode ser alterado sem impactar a execução do fluxo.

![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/ajTv27549aAchyXlci7EO_nomear.gif)

:::hint{type="info"}
**Dica: **dê duplo clique no nome do passo para editar os nomes, tanto Identificador (referência técnica) como nome de visualização (rótulo no Canvas). 
:::



![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/giMq7XQo2-Mv29VooTIEZ-20251027-035532.gif)

## Monitoramento e depuração

- Cada passo pode ser monitorado individualmente para identificar sucesso ou falha.
- Ferramentas e logs detalhados ajudam na resolução de problemas em tempo real.
- Agora, com a separação entre **tempo do passo** (processamento interno) e **tempo da requisição** (quando houver), é possível:
  - Identificar com precisão se o gargalo está na lógica interna ou na API externa.
  - Excluir requisições falsas geradas por passos que não fazem chamadas externas.

Isso proporciona maior visibilidade, eficiência e relevância ao monitoramento dos fluxos.

## Importância dos passos

Passos bem configurados garantem um fluxo eficaz e eficiente, representando a lógica de negócio de forma clara e organizada. Eles são a base para automações poderosas capazes de transformar operações e promover grande valor operacional. A nova abordagem de monitoramento (separando processamento interno e chamadas externas) fortalece ainda mais essa confiança.

***

### Saiba mais

- Para entender como funcionam as requisições e sua lógica de separação: [Requisições](https://docs.fluidapi.io/requisicoes)