Wavy WhatsAppInstall

Summary

Retrieve, decrypt, or download media from a WhatsApp message payload and append binary file data and metadata.

Inputs

• to (required) — Phone number or WhatsApp JID of the recipient or chat.
• quoted — JSON object or string containing the raw quoted message from a trigger payload.
• mediaUrl — URL or filename of the media to download. If left blank, the media URL is automatically extracted from the incoming JSON payload.
• metadataCollection — Custom key-value metadata fields to append to the media output object.
• routingMode — Enable to route execution items across multiple output branches based on conditions.
• routingRules — Conditional rules specifying which output branch receives the item based on custom expression evaluations.
• includeFallback — Enable to add an extra fallback output branch for items that do not match any routing rule.

Output shape

a list of items containing message metadata, base64 strings, data URIs, and binary media attachments

When Routing Mode is disabled, items are emitted through a single main output. When Routing Mode is enabled, items are routed across dynamic output branches defined in Routing Rules, with an optional Fallback branch.

Examples

Example 1: Download media from an incoming message payload

Set Recipient to {{ $json.chatId }} and leave Media URL blank to auto-detect media from the input payload.

Example 2: Route incoming files by media MIME type

Set Recipient, enable Routing Mode, add a rule checking if {{ $json.metadata.mimeType }} contains image/, and enable Include Fallback Output.

Links

• n8n community nodes installation guide