WaliChat icon

WaliChat

Interact with WaliChat WhatsApp API

Actions148

Files → Update File

AI-generated

Overview

This node interacts with the WaliChat WhatsApp API to update metadata and properties of outbound files previously uploaded or sent via WhatsApp. It allows users to modify attributes such as filename, reference identifier, display format, tags, message caption, expiration time, and access permissions for a specific file.

Typical use cases include:

  • Renaming a file after upload to better reflect its content.
  • Changing the visibility or permission level of a file (e.g., making it public or private).
  • Adding or updating tags to organize files.
  • Setting or extending expiration times for temporary media.
  • Updating the caption text associated with a media file.

For example, a user might update a voice message file to add a descriptive caption and set it to expire in 1 hour, or change a file's permission from private to read-only for sharing purposes.

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.
- Message Caption Text caption to associate with the media file.
- Expiration New expiration time for the file. Options range from 10 minutes up to 2 years.
- Permission New access permission for the file. Options: Public, Read-only, Private.

Output

The node outputs JSON data representing the updated file object returned by the WaliChat API. This typically includes the updated metadata fields such as filename, reference, format, tags, caption, expiration, and permission status.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the WaliChat WhatsApp API.
  • The node depends on the WaliChat API service being accessible and properly configured.
  • No additional environment variables are explicitly required beyond the API key.

Troubleshooting

  • Common Issues:

    • Invalid or missing File ID will cause the update to fail.
    • Providing invalid values for fields like expiration or permission may result in API errors.
    • Network connectivity issues can prevent successful API calls.
    • Insufficient permissions on the API key may block updates.

  • Error Messages:

    • Errors related to "file not found" indicate the File ID does not exist or is inaccessible.
    • Validation errors for fields like expiration or format suggest incorrect input values.
    • Authentication errors imply problems with the provided API key credential.

  • Resolutions:

    • Verify the File ID is correct and corresponds to an existing file.
    • Ensure all input fields conform to expected formats and allowed options.
    • Check API key validity and permissions.
    • Confirm network connectivity and API endpoint availability.

Links and References

Discussion