{"id":48648,"library":"n8n-nodes-websocket-ws-reconnect","title":"WebSocket Trigger Node for n8n","description":"An n8n community node (v1.0.2) that adds a WebSocket trigger with support for Bearer token and query parameter authentication and automatic reconnection. Designed for n8n workflow automation, it connects to any WebSocket endpoint and uses incoming messages as workflow triggers. The package has no regular release cadence yet but is actively maintained. Key differentiators: built-in auth and reconnect handling, unlike generic WebSocket clients. Peer dependency on n8n-workflow, requires Node >=18.10.","status":"active","version":"1.0.2","language":"javascript","source_language":"en","source_url":"https://github.com/santi648/n8n-nodes-websocket-ws-prueba","tags":["javascript","n8n-community-node-package"],"install":[{"cmd":"npm install n8n-nodes-websocket-ws-reconnect","lang":"bash","label":"npm"},{"cmd":"yarn add n8n-nodes-websocket-ws-reconnect","lang":"bash","label":"yarn"},{"cmd":"pnpm add n8n-nodes-websocket-ws-reconnect","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required to integrate with n8n workflow system","package":"n8n-workflow","optional":false}],"imports":[{"note":"Named export only; default import is not available.","wrong":"import WebSocketTrigger from 'n8n-nodes-websocket-ws-reconnect'","symbol":"WebSocketTrigger","correct":"import { WebSocketTrigger } from 'n8n-nodes-websocket-ws-reconnect'"},{"note":"The package does not re-export the 'ws' WebSocket class; you must use the 'ws' package directly for low-level usage.","wrong":"import { WebSocket } from 'n8n-nodes-websocket-ws-reconnect'","symbol":"WebSocket","correct":"import { WebSocket } from 'ws'"},{"note":"Type definitions come from n8n-workflow, not from this package.","wrong":"import { INodeTypeDescription } from 'n8n-nodes-websocket-ws-reconnect'","symbol":"INodeTypeDescription","correct":"import type { INodeTypeDescription } from 'n8n-workflow'"}],"quickstart":{"code":"// No standalone usage; install as n8n community node\n// Ensure n8n is installed and node_modules linked correctly\n// Package peer depends on n8n-workflow\nimport { WebSocketTrigger } from 'n8n-nodes-websocket-ws-reconnect';\n\nconst trigger = new WebSocketTrigger();\nconst nodeType = trigger.description;\nconsole.log('Node type name:', nodeType.name);","lang":"typescript","description":"Shows how to import the WebSocketTrigger class and access its description for n8n node registration."},"warnings":[{"fix":"npm install n8n-nodes-websocket-ws-reconnect","message":"The package name is 'n8n-nodes-websocket-ws-reconnect' but the npm package is 'n8n-nodes-websocket-ws' - ensure you install the correct one.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Update workflow node type to 'webSocketTrigger' (capital S).","message":"v1.0.0 changed the trigger name from 'websocketTrigger' to 'webSocketTrigger' (camelCase refactor). Workflows using old name will break.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use 'reconnectDelay' instead of 'reconnectInterval'.","message":"The property 'reconnectInterval' was deprecated in v0.9.0 in favor of 'reconnectDelay'.","severity":"deprecated","affected_versions":">=0.9.0 <1.0.0"},{"fix":"Fork the package or submit a PR to customize header name.","message":"Authentication header 'Authorization' is set in the node parameters, but if the websocket server expects a different header name, you must modify the node source code - it is not configurable.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Ensure n8n-workflow is installed in the same node_modules (handled automatically if using n8n community node installer).","message":"Node requires n8n-workflow as a peer dependency; if not installed, n8n will throw 'Cannot find module 'n8n-workflow'' at startup.","severity":"breaking","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'18.10':79 'activ':56 'add':12 'auth':63 'authent':24 'autom':32 'automat':26 'bearer':19 'built':61 'built-in':60 'cadenc':52 'client':70 'communiti':8,83 'connect':34 'depend':72 'design':28 'differenti':59 'endpoint':38 'generic':68 'handl':66 'incom':41 'javascript':80 'key':58 'maintain':57 'messag':42 'n8n':5,7,30,75,82 'n8n-community-node-package':81 'n8n-workflow':74 'node':3,9,78,84 'packag':47,85 'paramet':23 'peer':71 'queri':22 'reconnect':27,65 'regular':50 'releas':51 'requir':77 'support':17 'token':20 'trigger':2,15,45 'unlik':67 'use':40 'v1.0.2':10 'websocket':1,14,37,69 'workflow':31,44,76 'yet':53","created_at":"2026-06-07T16:57:43.050379+00:00","updated_at":"2026-06-07T16:57:43.050379+00:00","problems":[{"fix":"Run 'npm install n8n-workflow' in the n8n node_modules directory.","cause":"Missing peer dependency n8n-workflow.","error":"Cannot find module 'n8n-workflow'"},{"fix":"Use 'webSocketTrigger' (with capital S) as the node type.","cause":"Old trigger name used before v1.0.0.","error":"The trigger 'websocketTrigger' is not registered."},{"fix":"Replace 'reconnectInterval' with 'reconnectDelay' in the node configuration.","cause":"Using deprecated 'reconnectInterval' in node parameters.","error":"TypeError: Cannot read properties of undefined (reading 'reconnectInterval')"},{"fix":"Check that the Bearer token or query parameter is correctly set in the node credentials or parameters.","cause":"Authentication header not sent or wrong credentials.","error":"WebSocket connection failed: Unexpected server response: 401"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/santi648/n8n-nodes-websocket-ws-prueba","github":"https://github.com/santi648/n8n-nodes-websocket-ws-prueba","docs":null,"changelog":null,"pypi":null,"npm":"n8n-nodes-websocket-ws-reconnect","openapi_spec":null,"status_page":null,"smithery":null,"categories":["messaging"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}