Nó Instances

O nó Instances (wave_instances) lista linhas WhatsApp ou Instagram conectadas à sua empresa, ou busca detalhes de uma instância — status de conexão, canal, agentes vinculados e metadados.

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

Figura 1: Nó Instances — list com busca e paginação

O que faz

Operação: List instances (wave_inst_list)

Endpoint: GET /instances/fetch

Operação: Get instance (wave_inst_get)

Endpoint: GET /instances/get

Forneça instance_id ou phone_number para identificar a linha.

Dicas e boas práticas

• Verifique status de conexão antes do Send em workflows de monitoramento — pule ou alerte quando a instância estiver desconectada.
• Busque por telefone parcial quando o webhook só tiver número local — normalize para E.164 em um nó Variable antes.
• Use saída do Get para definir instance_id dinamicamente no Send ao rotear por região ou marca.
• Máximo limit é 100 — pagine com page para frotas grandes.
• Instâncias Instagram aparecem na mesma listagem — filtre por canal em JavaScript se necessário.

Exemplos de uso

Exemplo 1 — Rotear mensagem para linha regional

Trigger: Webhook — region: SP.

Fluxo:

1. Instances — List, search: {{trigger.body.region_code}}
2. Send — instance_id: {{instances_1.data[0].id}}

Exemplo 2 — Alerta quando desconectado

Trigger: Schedule — a cada 15 minutos.

Fluxo:

1. Instances — List
2. Loop — por instância → Condition se status desconectado → Send alerta para número de ops

Exemplo 3 — Validar instância antes de envio de template

Trigger: Webhook — lote de campanha.

Fluxo:

1. Instances — Get, phone_number: {{trigger.body.from_line}}
2. Condition — se conectado → envio de template Meta; Senão → Return com erro

FAQ

Diferença entre instance_id e phone_number entre nós?

Send/Conversations costumam usar UUID (instance_id); Messages/Meta Templates usam telefone. Este nó suporta ambos no Get.

A listagem inclui Instagram?

Sim — a busca suporta handles @instagram.

Posso conectar instância a partir de um workflow?

Não — provisionamento é feito nas configurações WhatsWave. Este nó é somente leitura.

Artigos relacionados

• Nó Send
• Nó Instagram
• Nó Meta Templates