Redis Trigger

Description

The RedisTrigger module is a trigger that initiates a workflow when a message is received on a configured Redis Pub/Sub channel. It supports two subscription types: subscribe for exact channels and psubscribe for patterns with wildcards (*). The module automatically attempts to parse the message as JSON; if it is not valid JSON, it passes it as a string. It provides the channel, parsed message, raw message, and trigger metadata to the next node.

Configuration

Parameters

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Redis connection credentials (host, port, password).
channel	text	Yes	Redis Pub/Sub channel. For psubscribe use patterns with . E.g.: events:, notifications:orders
subscription_type	select	No	Subscription type: Subscribe (exact channel) or PSubscribe (pattern with wildcard *). Default: subscribe.
trigger_id	hidden	No	Registered trigger ID. Automatically generated.

Credentials

A credential with the following fields is required:

• host: Redis server host (e.g.: localhost or redis.example.com).
• port: Connection port (default: 6379).
• password: Redis server authentication password.

Output

{
  "nextModule": "siguiente_modulo",
  "data": {
    "channel": "eventos:pedidos",
    "message": { "pedido_id": 456, "estado": "completado" },
    "raw": "{\"pedido_id\":456,\"estado\":\"completado\"}",
    "_trigger": {
      "type": "redis",
      "channel": "eventos:pedidos",
      "pattern": null,
      "subscription_type": "subscribe",
      "timestamp": "2026-03-23T10:00:00.000Z"
    }
  }
}

Usage Example

Basic case

{
  "label": "Redis Trigger",
  "credentials_id": "credencial_redis",
  "channel": "eventos:*",
  "subscription_type": "psubscribe"
}

Notes

• subscribe listens on an exact channel. psubscribe allows patterns with wildcard * to listen on multiple channels.
• When using psubscribe, the _trigger.pattern field contains the original subscription pattern.
• The message is automatically parsed as JSON. If parsing fails, it is kept as a string.
• The raw field always contains the original unparsed message.

Related Nodes

• MqttTrigger (similar trigger for MQTT messages)
• Webhook (HTTP request trigger)
• decision (to evaluate message content)