WSAPI icon

WSAPI

Interact with WSAPI WhatsApp API
Join our community

Actions50

Overview

This node interacts with the WSAPI WhatsApp API, specifically allowing you to manage various WhatsApp-related resources. The Account - Set Picture operation lets you update the profile picture of a WhatsApp account by providing an image encoded in Base64 format.

Common scenarios for this operation include:

  • Automatically updating a WhatsApp business profile picture as part of a branding workflow.
  • Changing the profile picture based on events or triggers in other systems.
  • Bulk updating profile pictures across multiple accounts programmatically.

Example: You might use this node to set a new profile picture after uploading an image to a cloud storage service, converting it to Base64, and then passing it to this node to update the WhatsApp account's profile picture.

Properties

Name Meaning
Picture Base64 Base64 encoded image data for the profile picture. Supported formats: JPEG, PNG. Recommended size: 640x640 pixels. Provide the image data as a Base64 string (e.g., starting with data:image/jpeg;base64,).

Output

The output JSON contains the response from the WSAPI WhatsApp API after attempting to set the profile picture. This typically includes confirmation details such as success status or updated account information.

If the operation fails, the output may contain an error message describing the issue.

The node does not output binary data for this operation.

Dependencies

  • Requires an active connection to the WSAPI WhatsApp API.
  • Needs an API key credential configured in n8n to authenticate requests.
  • The base URL for the WSAPI must be set in the credentials configuration.
  • The input image must be provided as a Base64 encoded string in supported formats (JPEG or PNG).

Troubleshooting

  • Invalid Image Format or Data: If the Base64 string is malformed or the image format is unsupported, the API may reject the request. Ensure the image is properly encoded and matches one of the supported formats.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key credential is correctly configured.
  • Image Size Issues: Although not strictly enforced, using images significantly larger than the recommended 640x640 pixels may cause performance issues or rejection by the API.
  • Network or API Endpoint Errors: Check the base URL configuration and network connectivity if requests fail to reach the API.

Common error messages:

  • "The operation "setPicture" is not implemented yet!" — indicates the operation handler was not found; ensure the node version supports this operation.
  • "The resource "account" is not known!" — indicates an invalid resource selection; verify the resource name.

Links and References

Discussion