Nó Get Lists

O nó Get Lists (contact_lists) busca todas as listas de contatos definidas para sua empresa. Use a saída para alimentar loops, checagens de segmentação ou associação dinâmica a listas em etapas seguintes.

Encontre-o na paleta WhatsWave em Automações.

Figura 1: Nó Get Lists — operação GET única

O que faz

A autenticação usa Authorization: Bearer {{api_token}} automaticamente.

Campos de configuração

Nenhum outro campo — consulta somente leitura no escopo da empresa.

Saída

A saída lists contém o array de objetos de lista (IDs, nomes, contagens — formato exato no log de execução). Referencie itens em um nó Loop:

{{contact_lists_1.lists[0].id}}
{{contact_lists_1.lists[0].name}}

Dicas e boas práticas

• Armazene em Variable se vários nós precisarem do mesmo snapshot de listas na mesma execução.
• Combine com Condition — ramifique quando um nome de lista existir antes de inscrever contatos via API em outro lugar.
• Execute antes de workflows de campanha para validar que IDs de lista ainda existem.
• Não confunda com Send List message — Get Lists lê entidades de lista de contatos; Send → List operation envia mensagens de lista interativa WhatsApp.

Exemplos de uso

Exemplo 1 — Escolher list ID por nome

Trigger: Webhook — list_name: VIP.

Fluxo:

1. Get Lists
2. JavaScript — encontra lista cujo nome corresponde a {{trigger.body.list_name}}, retorna id
3. HTTP request ou API interna — adiciona contato à lista (se suportado fora deste nó)

Exemplo 2 — Relatório de contagem de listas

Trigger: Schedule — semanal.

Fluxo:

1. Get Lists
2. Loop — por lista → agrega contagens em JavaScript
3. Send — texto resumo para número de ops

Exemplo 3 — Bloquear workflow se lista não existir

Trigger: Manual — início de campanha.

Fluxo:

1. Get Lists
2. Condition — nome da lista contém slug da campanha → continua; Senão → Return com erro

FAQ

Este nó adiciona contatos a uma lista?

Não — somente leitura. Use APIs de gestão de contatos ou UI para alterar membros.

Por que lists está vazio?

Nenhuma lista criada ainda em Contacts → Lists, ou contexto de empresa incorreto.

Paginação?

GET único retorna listas da empresa — tipicamente pequeno o suficiente para uma resposta.

Artigos relacionados

• Nó Contact
• Nó Loop
• Visão geral WhatsWave