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 operation updates the profile image of a WhatsApp group associated with a specified WhatsApp number. It allows users to change the group's display picture by providing either a direct URL to an image or base64-encoded image data. This is useful for businesses or communities managing multiple WhatsApp groups who want to keep their group images current and relevant, such as updating branding, event-specific images, or seasonal themes.
Practical examples:
- A marketing team updates the group image to reflect a new campaign logo.
- An event organizer changes the group picture to the event banner before the event starts.
- A community manager refreshes the group photo monthly to keep it engaging.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) from which the group is managed. |
| Group ID | The unique identifier of the WhatsApp group whose image will be updated. |
| Image Source | The source type of the image to update: either a URL pointing to the image or base64-encoded data. |
| Image URL | (If Image Source is URL) The direct URL to the JPG or PNG image file to use as the group picture (max 1MB). |
| Image Data (Base64) | (If Image Source is Base64) The base64-encoded string representing the JPG or PNG image (max 1MB). |
Output
The node outputs JSON data representing the result of the update operation. Typically, this includes confirmation details about the updated group image or status messages returned by the WhatsApp API. The exact structure depends on the API response but generally confirms success or provides error information.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Wassenger WhatsApp API service.
- Needs an API key credential configured in n8n for authentication with the Wassenger API.
- The WhatsApp number (device) must be registered and linked to the Wassenger account.
- The group must exist and be accessible via the provided WhatsApp number.
Troubleshooting
Common issues:
- Providing an invalid or inaccessible image URL may cause the update to fail.
- Using an image larger than 1MB or unsupported formats other than JPG/PNG will likely result in errors.
- Incorrect or expired API credentials will prevent successful communication with the WhatsApp API.
- Specifying a wrong or non-existent group ID will cause the operation to fail.
Error messages and resolutions:
- "Invalid image format or size" โ Ensure the image is JPG or PNG and under 1MB.
- "Group not found" โ Verify the group ID corresponds to a valid group under the selected WhatsApp number.
- "Authentication failed" โ Check that the API key credential is correctly set up and has not expired.
- "Failed to fetch image from URL" โ Confirm the URL is publicly accessible and correct.
Links and References
- Wassenger API Documentation (for detailed API usage and image requirements)
- WhatsApp Group Profile Picture Guidelines