{"id":17826,"library":"n8n-nodes-waha","title":"n8n WAHA Community Node","description":"The `@devlikeapro/n8n-nodes-waha` package provides community-contributed nodes for n8n, enabling seamless integration with WAHA (WhatsApp HTTP API). This allows n8n users to automate WhatsApp messaging and interactions within their workflows, leveraging a self-hosted WhatsApp API solution. The current stable version is 2024.11.5, with frequent releases indicated by the recent `2024.9.x` and `2024.11.x` versioning. Key differentiators include its open-source nature, the ability to operate WhatsApp automation without Meta's per-message fees, and the nodes being generated from WAHA's OpenAPI specification, ensuring comprehensive API coverage.","status":"active","version":"2024.11.5","language":"javascript","source_language":"en","source_url":"https://github.com/devlikeapro/n8n-nodes-waha","tags":["javascript","n8n-community-node-package"],"install":[{"cmd":"npm install n8n-nodes-waha","lang":"bash","label":"npm"},{"cmd":"yarn add n8n-nodes-waha","lang":"bash","label":"yarn"},{"cmd":"pnpm add n8n-nodes-waha","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"This is an n8n community node package and requires an n8n instance to function. n8n is a peer dependency.","package":"n8n","optional":false},{"reason":"The nodes connect to a running WAHA instance; WAHA is a separate self-hosted service, not a JavaScript dependency, but essential for the node's operation.","package":"WAHA (WhatsApp HTTP API)","optional":false}],"imports":[{"note":"This package provides n8n nodes which are installed into an n8n instance and used via its graphical interface. Direct JavaScript imports are typically only for developers building or extending the node itself, not for end-users. If developing, a node class (e.g., 'WahaNode') implementing `INodeType` would be exported.","symbol":"WahaNode","correct":"/* End-users do not directly import symbols from n8n community nodes. */"},{"note":"Similar to WahaNode, credentials for n8n nodes (like 'WAHACredential') are managed within the n8n application UI and not imported directly in user-facing JavaScript code.","symbol":"WAHACredential","correct":"/* End-users do not directly import symbols from n8n community nodes. */"}],"quickstart":{"code":"# 1. Install n8n (if not already installed, e.g., via npm or Docker)\nnpm install -g n8n\n\n# 2. Add the WAHA community node to your n8n instance via CLI:\nn8n add:community-node @devlikeapro/n8n-nodes-waha\n\n# 3. Start your n8n instance (if not running):\nn8n start\n\n# 4. In the n8n UI (e.g., http://localhost:5678):\n#    a. Go to 'Credentials' and add a new 'WAHA API' credential.\n#       - Name: MyWahaAPI\n#       - Base URL: http://localhost:3000 (or your WAHA instance URL)\n#       - API Key: YOUR_WAHA_API_KEY (if WAHA is configured with one)\n#    b. Create a new workflow. Drag and drop:\n#       - 'WAHA Trigger' node: Configure it to listen for 'message' events.\n#         - Webhook URL: Copy the URL provided by the node after saving the workflow and configure your WAHA session to send events to this URL.\n#         - Session: 'default' (or your WAHA session name)\n#       - 'Set' node (to extract message text):\n#         - Mode: 'Merge Data'\n#         - Keep Only Set: true\n#         - Add Field:\n#           - Name: 'text'\n#           - Value: `{{$json.body.message.text.body}}`\n#       - 'WAHA' (action) node (to send a reply):\n#         - Credential: 'MyWahaAPI'\n#         - Operation: 'Send Text'\n#         - Chat ID: `{{$json.body.message.chatId}}` (to reply to the sender)\n#         - Text: `Echo: {{$json.text}}`\n#         - Session: 'default'\n\n# This workflow sets up an 'echo' bot: any message received by WAHA will be echoed back to the sender via n8n.","lang":"javascript","description":"Demonstrates how to install the n8n-nodes-waha community node, configure WAHA API credentials, and build a basic n8n workflow using the WAHA Trigger and WAHA Send Text Message nodes to create an 'echo' bot."},"warnings":[{"fix":"Adhere strictly to WhatsApp's terms of service and best practices to minimize risk. Use the API responsibly and be aware of potential changes.","message":"The WAHA API, which this node connects to, utilizes unofficial WhatsApp Web sessions. This carries a risk of WhatsApp account restrictions or bans if used irresponsibly or if WhatsApp changes its policies.","severity":"gotcha","affected_versions":">=2024.9.1"},{"fix":"Ensure a WAHA instance is properly installed, configured, and running before attempting to use the n8n nodes. Monitor its health and accessibility.","message":"Operating WAHA requires a separate, self-hosted instance of the WAHA application to be running and accessible to your n8n instance. This incurs infrastructure and maintenance overhead, even though WAHA Core is open-source.","severity":"gotcha","affected_versions":">=2024.9.1"},{"fix":"Implement robust security measures for your WAHA instance, including strong authentication, network firewalls, and restricting public access where possible.","message":"Publicly exposing an unsecured WAHA instance can lead to security vulnerabilities and abuse, as reported by the community.","severity":"gotcha","affected_versions":">=2024.9.1"},{"fix":"Regularly update the `@devlikeapro/n8n-nodes-waha` package. Consult WAHA and n8n-nodes-waha release notes for compatibility information before upgrading WAHA.","message":"Due to the nodes being generated from the WAHA OpenAPI specification, breaking changes in the underlying WAHA API might lead to unexpected behavior or require node updates, especially during major WAHA version upgrades.","severity":"gotcha","affected_versions":">=2024.9.1"},{"fix":"If encountering this, input any placeholder string (e.g., 'none') into the API Key field to allow saving the credential, if your WAHA instance truly does not require an API key.","message":"When configuring WAHA API credentials in n8n, a known issue might prevent saving if the API Key field is left empty, even if your WAHA instance doesn't require one.","severity":"gotcha","affected_versions":">=2024.9.1"}],"env_vars":null,"last_verified":"2026-04-23T00:00:00.000Z","next_check":"2026-07-22T00:00:00.000Z","problems":[{"fix":"Ensure your n8n instance is up-to-date. Try restarting n8n after the installation attempt. If running in Docker, ensure correct volume mounts and permissions. Consider clearing the n8n cache or reinstalling the node.","cause":"This error often indicates an issue with n8n's environment or a potential conflict during community node installation, possibly related to JavaScript module loading.","error":"Error during the installation of @devlikeapro/n8n-nodes-waha: “Class extends value undefined is not a constructor or null”"},{"fix":"Verify that your WAHA instance is running and accessible from n8n. Check your WAHA API credentials in n8n. Inspect WAHA's own logs for specific error messages. Ensure the WAHA session you're targeting is active and configured correctly.","cause":"These errors typically indicate a problem communicating with the external WAHA API, or an issue within the WAHA service itself (e.g., WAHA not running, incorrect API key, WAHA session not active, or a malformed request).","error":"{ \"errorMessage\": \"The service was not able to process your request\", \"errorDescription\":... } or \"Node execution failed\""},{"fix":"Verify the installation command completed without errors. Ensure n8n was restarted after installation. Check n8n's logs for any errors related to loading community nodes. Confirm `n8n-community-node-package` keyword is in package.json.","cause":"The community node was not successfully installed or loaded by n8n. This often happens if the `n8n add:community-node` command failed or if n8n wasn't restarted.","error":"WAHA nodes (e.g., 'WAHA Trigger', 'WAHA Send Message') do not appear in the n8n node palette after installation."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}