Actions148
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Files Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
Overview
This node integrates with the Wassenger WhatsApp API to upload files as outbound files. It supports uploading files by specifying a URL, allowing users to send media content through WhatsApp channels managed by Wassenger.
Common scenarios where this node is beneficial include:
- Automating the sending of media files (images, voice messages, GIFs) in WhatsApp campaigns or customer support workflows.
- Uploading files dynamically from external URLs to be shared via WhatsApp.
- Managing file metadata such as expiration time, access permissions, and tags for better organization and control.
Practical example:
- A marketing automation workflow that uploads promotional images from a remote server URL to Wassenger, then sends them to targeted customers on WhatsApp.
Properties
| Name | Meaning |
|---|---|
| Upload Method | Method to upload the file. Options: โข From URL โ Upload file directly from a given URL with full binary data support. โข From URL (Without Binary Data Support) โ Upload file from URL but without full binary upload capability. |
| File URL | The URL of the file to upload. Required when using either upload method. |
| File Options | Collection of optional settings for the uploaded file: โข Filename โ Custom name for the uploaded file. โข Reference โ Identifier reference for the file. โข Format โ Display format of the file; options: GIF, Voice Message, Native. โข Expiration โ How long before the file expires; options range from 10 minutes up to 2 years. โข Permission โ Access level for the file; options: Public, Read-only, Private. โข Tags โ List of tags to categorize or label the file. |
Output
The node outputs JSON data representing the response from the Wassenger API after uploading the file. This typically includes details about the uploaded file such as its ID, URL, metadata, and status.
If binary data output is supported (depending on upload method), the node may also provide the file's binary content, but in the current version, full binary upload is only supported with the "From URL" method.
Dependencies
- Requires an API key credential for authenticating with the Wassenger WhatsApp API.
- Network access to the specified file URLs for downloading/uploading files.
- Proper configuration of the Wassenger API credentials within n8n.
Troubleshooting
- File URL unreachable or invalid: Ensure the provided URL is accessible and points to a valid file. Network issues or incorrect URLs will cause upload failures.
- Permission errors: Verify that the API key has sufficient permissions to upload files and set the desired access permission.
- Unsupported file formats: Confirm that the file format matches one of the supported display formats (GIF, Voice Message, Native).
- Expiration value invalid: Use one of the predefined expiration options; custom values are not supported.
- Binary upload limitations: When using the "From URL (Without Binary Data Support)" method, some features related to binary data may not work as expected.
Error messages returned by the node usually contain descriptive text from the Wassenger API. To resolve, check the input parameters, API key validity, and network connectivity.