WSAPI icon

WSAPI

Interact with WSAPI WhatsApp API
Join our community

Actions50

Overview

This node interacts with the WSAPI WhatsApp API to manage WhatsApp groups. Specifically, the Set Picture operation allows users to update the profile picture of a WhatsApp group by providing a base64-encoded image. This is useful for automating group management tasks such as branding groups with custom images or updating group pictures programmatically without manual intervention.

Practical examples:

  • Automatically setting a welcome image for new groups created via automation.
  • Updating group pictures periodically based on events or campaigns.
  • Managing multiple groups' pictures in bulk from an external system.

Properties

Name Meaning
Group ID The unique identifier of the WhatsApp group. Format must be groupID@g.us (e.g., 120363123456789@g.us). This specifies which group's picture will be updated.
Picture Base64 The new group picture encoded in base64 format. Supported image formats are JPEG and PNG. Recommended size is 640x640 pixels. This is the image data that will replace the current group picture.

Output

The node outputs JSON data representing the result of the set picture operation. Typically, this includes confirmation of success or details about the updated group picture. If the operation fails, the output contains error information.

The node does not output binary data for this operation; it only returns JSON responses from the API.

Dependencies

  • Requires an active connection to the WSAPI WhatsApp API service.
  • Needs an API key credential configured in n8n to authenticate requests.
  • The base URL for the WSAPI must be set in the credentials.
  • The input image must be provided as a base64-encoded string matching supported formats.

Troubleshooting

  • Invalid Group ID format: Ensure the Group ID follows the pattern number@g.us. Incorrect formatting will cause errors.
  • Unsupported image format or corrupted base64 data: Verify the image is correctly encoded in base64 and is either JPEG or PNG.
  • API authentication errors: Confirm that the API key credential is valid and has necessary permissions.
  • Image size issues: Although not enforced by the node, very large images might cause API rejections or slow performance. Use recommended size (640x640 pixels).
  • Network or connectivity problems: Check network access to the WSAPI endpoint and correct base URL configuration.

Common error messages typically indicate invalid parameters or authentication failures. Reviewing the error message details returned in the node output helps identify the root cause.

Links and References

Discussion