Nó Redis

O nó de workflow Redis (redis_request) executa operações de cache chave-valor no Redis por meio de um proxy HTTP seguro. Assim como o nó Postgres, a WhatsWave não abre conexão TCP direta com o Redis — você opera uma API pequena que traduz comandos JSON em chamadas Redis.

ID do nó no editor: redis_request
Variável de URL padrão: {{redis_api_url}}
Auth: Bearer {{redis_api_token}}

O que faz

A cada execução, o engine:

1. Resolve variáveis em URL, headers e body
2. Envia um POST com payload JSON de comando ao seu proxy Redis
3. Retorna status, data e headers

Pré-requisitos

1. Uma instância Redis (self-hosted, Redis Cloud, ElastiCache, etc.)
2. Um proxy HTTP que aceita comandos JSON e retorna resultados JSON
3. Chaves de integração:
   • redis_api_url — endpoint do proxy (ex.: https://your-service.com/redis)
   • redis_api_token — bearer token validado pelo proxy

Adicione as chaves em Configurações → Chaves de API → Chaves de integração.

Como configurar

Passo 1 — Adicionar o nó

1. Abra Automações
2. Paleta → Dados → Redis
3. Conecte após o gatilho ou nós de lógica

Passo 2 — Templates de operação

Estenda o body para outros comandos que seu proxy suporte (EXPIRE, INCR, HGET, LPUSH, etc.).

Passo 3 — Configurar campos

Exemplo — cache de resposta de API com TTL (se o proxy suportar EXPIRE):

Passo 1 — SET:

{
  "command": "SET",
  "key": "customer:{{trigger.body.phone}}",
  "value": "{{variables.customer_json}}"
}

Passo 2 — nó separado ou proxy combinado:

{
  "command": "EXPIRE",
  "key": "customer:{{trigger.body.phone}}",
  "seconds": 3600
}

Exemplo — chave de deduplicação:

{
  "command": "SET",
  "key": "webhook:{{trigger.body.event_id}}",
  "value": "1",
  "nx": true
}

(Seu proxy pode mapear nx para Redis SET NX.)

Passo 4 — Usar a saída

{{redis_1.data}}
{{redis_1.status}}

Interprete data conforme o formato de resposta do seu proxy (ex.: { "value": "..." } para GET).

Saídas do nó

Contrato da API do proxy

Seu proxy deve aceitar:

{
  "command": "GET",
  "key": "session:abc123"
}

E retornar algo utilizável downstream:

{
  "value": "{"name":"João"}",
  "found": true
}

Requisitos de segurança:

• Autenticar toda requisição com o bearer token
• Bloquear comandos perigosos em produção (FLUSHALL, KEYS * em instâncias grandes, CONFIG)
• Preferir SCAN em vez de KEYS para listagem em proxies de produção
• Namespaces de chaves por company ou workflow (whatswave:{company_id}:{key})
• Usar TLS no endpoint do proxy

Dicas e boas práticas

• Use Redis para cache e dedup, não como banco primário — Postgres/Supabase mantêm a source of truth
• Defina TTLs em chaves de cache para evitar dados obsoletos e crescimento de memória
• Convenção de nomes de chave — entity:id:field (ex.: order:550e8400:status)
• **Evite KEYS *** em produção — implemente SCAN no seu proxy para listagem por padrão
• Serialize JSON como strings no SET; faça parse no nó JavaScript no GET
• Combine GET → Condição → SET para padrões read-through cache
• A infraestrutura da WhatsWave usa Redis para filas — seu nó fala com seu Redis via proxy, não com o cache interno da WhatsWave

Exemplos de casos de uso

Idempotência de webhook

1. Gatilho Webhook
2. Redis GET — webhook:{{trigger.body.id}}
3. Condição — já processado → Return antecipado
4. Processar evento → Redis SET com event ID

Cache de API externa cara

1. Redis GET — product:{{variables.sku}}
2. Condição — cache hit → pular nó HTTP
3. HTTP — buscar produto → Redis SET com TTL de 1 hora

Contador de rate-limit (com suporte a INCR no proxy)

1. Gatilho Webhook
2. Redis INCR — rate:{{contact.phone}}:{{date:today}}
3. Condição — count > 10 → rejeitar mensagem

FAQ

Por que não conectar diretamente ao Redis?
Acesso direto ao Redis a partir de uma plataforma de automação compartilhada é uma preocupação de segurança e isolamento de rede. O padrão de proxy HTTP mantém credenciais e fronteiras de rede sob seu controle.

GET retorna null / vazio?
Chave inexistente ou expirada — normal em cache miss. Ramifique com Condição.

Posso usar Redis lists como filas?
Sim, se seu proxy expuser LPUSH/BRPOP. Para cargas pesadas de fila, considere serviços de fila dedicados.

Redis vs nó Variável?
Variável persiste durante uma execução do workflow. Redis persiste entre execuções e workflows (cache compartilhado).

Template KEYS em produção?
Evite em databases grandes — bloqueia o Redis. Use listagem baseada em SCAN no seu proxy.

Referência da API

Relacionados

• Visão geral de Dados
• Nó Postgres
• Nó Variável
• Nó HTTP