Tema
Operações com lista · list_operator
Referência do nó
Kind
list_operatorCategoriaDadosPara que serve
Imagina que você tem uma caixa com 50 fichas de clientes e precisa encontrar só as que têm mais de R$ 1.000 em débito, ordenadas pela data mais recente, pegando só as 5 primeiras. O Operações com lista faz isso com as listas do seu fluxo: recebe uma lista de itens e aplica filtros, ordenação, limite ou extração — devolvendo exatamente o que você precisa.
Quando usar
- Filtrar resultados de uma API (ex.: mostrar só produtos com estoque disponível)
- Pegar os N primeiros ou últimos itens de uma lista
- Ordenar uma lista por data, valor ou qualquer campo
- Extrair um único item específico de uma coleção
- Limitar o tamanho de uma lista antes de passar para um nó de iteração
Passo a passo
- Certifique-se de ter uma lista disponível no fluxo — vinda de um nó Requisição HTTP, Buscar dados externos ou de uma variável.
- Arraste o nó **Operações com lista** para o canvas e conecte à fonte da lista.
- Informe a **Variável de entrada** que contém a lista.
- Configure as operações que quer aplicar (filtragem, ordenação, limite, extração).
- Salve. A saída processada fica em
{{list_operator.result}}.
Operações disponíveis
Filtrar
Mantém só os itens que atendem a uma condição.
| Campo | O que preencher |
|---|---|
| Campo | Qual propriedade do item verificar (ex.: status) |
| Operador | igual a / diferente de / contém / maior que / menor que |
| Valor | O valor para comparar (pode usar variáveis {{ }}) |
Ordenar
Reorganiza os itens da lista.
| Campo | O que preencher |
|---|---|
| Campo | Propriedade usada para ordenar (ex.: data_criacao) |
| Direção | Crescente (A→Z, 0→9) ou Decrescente (Z→A, 9→0) |
Limitar
Corta a lista para N itens.
| Campo | O que preencher |
|---|---|
| Máximo de itens | Número inteiro — quantos itens manter |
Extrair item
Pega um único item da lista pelo índice.
| Campo | O que preencher |
|---|---|
| Índice | Posição do item (0 = primeiro, 1 = segundo, -1 = último) |
Exemplo
Cenário: você recebe uma lista de agendamentos do sistema e quer mostrar ao cliente os 3 próximos.
- Filtrar:
statusigual aconfirmado - Ordenar: por
data_horacrescente - Limitar: máximo 3 itens
A lista resultante vai para um nó de Template que monta a mensagem com os 3 horários disponíveis.
Dica
Você pode encadear múltiplas operações no mesmo nó — primeiro filtra, depois ordena, depois limita. A ordem de execução segue a sequência em que as operações aparecem no painel.
Atenção
Se a lista de entrada estiver vazia, o nó retorna uma lista vazia sem erro. Coloque um nó Se/Senão (condição) depois para verificar se {{list_operator.result}} tem pelo menos um item antes de continuar o fluxo.
Dica
Padrão comum: filtrar uma lista e, em seguida, decidir o caminho do fluxo conforme o resultado — veja a receita Filtrar uma lista antes do SE/SENÃO na página do nó Se/Senão (condição).
Saiba mais
- Se / Senão (condição) — decida o caminho do fluxo com base no resultado da lista