{"id":18583,"library":"n8n-nodes-evolution-api-media-downloader","title":"n8n Evolution API Media Downloader","description":"A community node package for n8n (v0.1.0) that adds a node to download media from Evolution API data messages. This package allows users to process incoming WhatsApp messages containing media (images, audio, video, documents) and download the files directly within n8n workflows. The node integrates with the Evolution API webhook format. It is intended for n8n instances running version 0.218.0 or later. The package is minimal and focused on a single use case, with no additional dependencies beyond n8n-workflow.","status":"active","version":"0.1.0","language":"javascript","source_language":"en","source_url":"https://github.com/betorcs/n8n-nodes-evolution-api-media-downloader","tags":["javascript","n8n-community-node-package"],"install":[{"cmd":"npm install n8n-nodes-evolution-api-media-downloader","lang":"bash","label":"npm"},{"cmd":"yarn add n8n-nodes-evolution-api-media-downloader","lang":"bash","label":"yarn"},{"cmd":"pnpm add n8n-nodes-evolution-api-media-downloader","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Runtime peer dependency required for n8n node definition interfaces","package":"n8n-workflow","optional":false}],"imports":[{"note":"This package is ESM-only as per n8n node convention. CommonJS require() will fail at runtime.","wrong":"const EvolutionApiMediaDownloader = require('n8n-nodes-evolution-api-media-downloader')","symbol":"EvolutionApiMediaDownloader","correct":"import { EvolutionApiMediaDownloader } from 'n8n-nodes-evolution-api-media-downloader'"},{"note":"Optional export for advanced node configuration. Not required for basic usage.","symbol":"nodeMetadata","correct":"import { nodeMetadata } from 'n8n-nodes-evolution-api-media-downloader'"},{"note":"Default import is also supported and is the recommended pattern for a single node.","wrong":"import { default as EvolutionApiMediaDownloader } from 'n8n-nodes-evolution-api-media-downloader'","symbol":"default","correct":"import EvolutionApiMediaDownloader from 'n8n-nodes-evolution-api-media-downloader'"}],"quickstart":{"code":"// Install the package in your n8n custom nodes directory\n// npm install n8n-nodes-evolution-api-media-downloader\n\n// Example usage: Create an n8n workflow that uses the node\n// 1. Add a Webhook node (trigger) to receive Evolution API messages\n// 2. Connect it to an Evolution API Media Downloader node\n// 3. Configure the node to extract the media URL from the webhook payload\n\n// The node expects input with JSON like:\n// {\n//   \"data\": {\n//     \"message\": {\n//       \"mediaUrl\": \"https://evolution-api.example.com/media/123\",\n//       \"fileName\": \"document.pdf\",\n//       \"mimeType\": \"application/pdf\"\n//     }\n//   }\n// }\n\n// Node output will contain the downloaded file as binary data\n// Use n8n's Set node to map the binary data for further processing","lang":"javascript","description":"Shows how to install and configure the node in an n8n workflow for downloading media from Evolution API"},"warnings":[{"fix":"Ensure the incoming JSON contains a `data.message.mediaUrl` property. Use n8n's Set node or Function node to restructure data if needed.","message":"The input data structure must match Evolution API's webhook format exactly. Custom API calls may require transformation before using this node.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Verify network connectivity and ensure the Evolution API server allows downloads from the n8n host. Consider using a proxy or VPN.","message":"The node may fail if the media URL is not accessible from the n8n server (e.g., due to network restrictions or authentication).","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Increase n8n's `N8N_PAYLOAD_SIZE_MAX` environment variable or pre-filter small files using a Function node.","message":"Large media files may cause memory issues or timeouts in n8n. The node does not stream to disk.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run `npm install n8n-nodes-evolution-api-media-downloader` inside the directory where n8n loads custom nodes (usually `~/.n8n/nodes/`).","cause":"Package not installed in the n8n custom nodes directory or missing from package.json","error":"ERROR: The import ''n8n-nodes-evolution-api-media-downloader'' could not be resolved"},{"fix":"Install n8n-workflow globally: `npm install -g n8n-workflow`","cause":"Missing peer dependency n8n-workflow","error":"Error: Cannot find module 'n8n-workflow'"},{"fix":"Check the structure of your incoming data. Use a Function node to log the payload and adjust field mappings.","cause":"Input data does not contain the expected path `data.message.mediaUrl`","error":"TypeError: Cannot read properties of undefined (reading 'mediaUrl')"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}