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
Files → Upload File
AI-generatedOverview
This node enables uploading files to the WaliChat WhatsApp API under the "Files" resource with the "Upload File" operation. It supports uploading files by specifying a URL, allowing users to send media content such as images, voice messages, or other file types to WhatsApp contacts or groups via the API.
Common scenarios include:
- Automating the sharing of media files hosted online by providing their URLs.
- Sending voice messages or GIFs as part of WhatsApp communication workflows.
- Managing file metadata like expiration time, access permissions, and tags for better organization and control.
Practical example:
- Uploading a promotional image from a public URL to share in a WhatsApp campaign.
- Sending a voice message file stored on a remote server to a customer support chat.
Properties
| Name | Meaning |
|---|---|
| Upload Method | Method to upload the file. Options: • From URL — Upload file using a URL with full binary data support. • From URL (Without Binary Data Support) — Upload file using a URL but without full binary upload capability. |
| File URL | The URL of the file to be uploaded. 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: GIF, Voice Message, or Native. • Expiration — Time after which the file expires (e.g., 10 minutes, 1 hour, up to 2 years). • Permission — Access level: Public, Read-only, or Private. • Tags — List of tags to categorize or label the file. |
Output
The node outputs JSON data representing the response from the WaliChat API after uploading the file. This typically includes details about the uploaded file such as its ID, URL, metadata, and status.
If binary data is involved (in the full upload method), the node may handle or reference binary content internally, but this version primarily focuses on URL-based uploads.
Dependencies
- Requires an API key credential for authenticating with the WaliChat WhatsApp API.
- Network access to the specified file URLs for downloading/uploading.
- Proper configuration of the node's credentials within n8n to enable API calls.
Troubleshooting
- File URL unreachable or invalid: Ensure the provided URL is accessible and points directly to a valid file.
- Permission errors: Verify that the API key has sufficient rights to upload files and set the requested permissions.
- Unsupported file formats or sizes: Check the API documentation for supported file types and size limits.
- Expiration setting issues: Use one of the predefined expiration options; custom values are not accepted.
- Binary data limitations: When using the "From URL (Without Binary Data Support)" method, some features related to binary handling may not work as expected.
Common error messages might include network errors, authentication failures, or validation errors from the API. Resolving them usually involves checking credentials, input parameters, and network connectivity.
Links and References
- WaliChat WhatsApp API Documentation (general reference for API capabilities)
- n8n Documentation (for configuring credentials and using nodes)