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 interacts with the Wassenger WhatsApp API to update metadata and properties of outbound files previously uploaded or sent. It is useful when you need to modify details such as the filename, reference identifier, display format, tags, message caption, expiration time, or access permissions of a file associated with your WhatsApp messaging workflows.
Practical scenarios include:
- Renaming a media file after upload for better organization.
- Changing the visibility or permission level of a file (e.g., making it public or read-only).
- Adding or updating tags to categorize files.
- Setting or extending expiration times for temporary media.
- Updating the caption text that accompanies a media file in messages.
Properties
| Name | Meaning |
|---|---|
| File ID | The unique identifier of the file to update. |
| Update Fields | A collection of fields to update on the file: |
| - Filename | New filename for the file. |
| - Reference | New reference identifier for the file. |
| - Format | New display format of the file. Options: GIF, Voice Message, Native. |
| - Tags | New tags for the file; multiple values allowed to categorize or label the file. |
| - Message Caption | Text caption to accompany the media file in messages. |
| - Expiration | New expiration time for the file. Options range from 10 minutes up to 2 years. |
| - Permission | New access permission level for the file. Options: Public, Read-only, Private. |
Output
The node outputs JSON data representing the updated file object returned by the Wassenger API. This typically includes the updated metadata fields such as filename, reference, format, tags, caption, expiration, and permission status.
If the file contains binary data, this node does not output the binary content itself but only updates and returns metadata about the file.
Dependencies
- Requires an active Wassenger WhatsApp API account.
- Requires an API key credential configured in n8n for authentication with the Wassenger service.
- Network connectivity to the Wassenger API endpoints.
Troubleshooting
Common issues:
- Invalid or missing File ID will cause the update operation to fail.
- Providing invalid values for fields like expiration or permission may result in API errors.
- Insufficient permissions or expired API keys can cause authentication failures.
Error messages:
"File not found": Check that the File ID is correct and the file exists."Invalid expiration value": Use one of the supported expiration options."Unauthorized"or"Authentication failed": Verify the API key credential is valid and has proper access.
Resolution tips:
- Double-check all input parameters for correctness.
- Ensure the API key is current and properly configured in n8n credentials.
- Review the Wassenger API documentation for valid field values and constraints.
Links and References
- Wassenger API Documentation
- n8n Documentation on Credentials
- Managing Media Files in WhatsApp APIs (for general context)