Actions148
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Files Actions
- Team Actions
- Labels Actions
- Departments 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
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
Overview
This node integrates with the SparkBot WhatsApp API to update the profile image of a specific WhatsApp channel. It allows users to change the channel's display picture by providing either a direct URL to an image or base64-encoded image data. This is useful for businesses or teams managing multiple WhatsApp channels who want to keep their channel images up-to-date, consistent with branding, or customized for different campaigns.
Practical examples:
- Updating the profile picture of a customer support WhatsApp channel to reflect seasonal promotions.
- Changing the image of a newsletter broadcast channel to match current marketing themes.
- Automatically refreshing channel images based on external triggers or events in your workflow.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) associated with the channel. |
| Channel ID | The unique identifier of the channel to update (e.g., 123000098765421000 or 123000098765421000@newsletter). |
| Image Source | The source format of the new image. Options: URL (provide an image URL), Base64 (provide base64-encoded image data). |
| Image URL | The URL of the image to use as the channel profile picture. Must be JPG or PNG and max 1MB. Required if Image Source is URL. |
| Image Data (Base64) | Base64-encoded image data representing the new channel profile picture. Must be JPG or PNG and max 1MB. Required if Image Source is Base64. |
Output
The node outputs JSON data representing the result of the update operation. Typically, this will include confirmation details such as the updated channel information or status messages indicating success or failure.
If the operation involves binary data (such as the image itself), it is handled internally and not outputted directly; only metadata or status is returned.
Dependencies
- Requires an active connection to the SparkBot WhatsApp API.
- Needs an API key credential configured in n8n for authentication with the SparkBot service.
- The image must be accessible via URL or provided as base64-encoded data, and must comply with size and format restrictions (JPG or PNG, max 1MB).
Troubleshooting
Common issues:
- Providing an invalid or inaccessible image URL may cause the update to fail.
- Exceeding the maximum image size (1MB) will likely result in an error.
- Using unsupported image formats other than JPG or PNG will cause rejection.
- Incorrect or missing WhatsApp number or channel ID will prevent the update.
Error messages and resolutions:
- "Invalid image format" — Ensure the image is JPG or PNG.
- "Image size exceeds limit" — Compress or resize the image to be under 1MB.
- "Channel not found" — Verify the channel ID is correct and exists.
- "Authentication failed" — Check that the API key credential is correctly set up and valid.
Links and References
- SparkBot WhatsApp API Documentation (for detailed API usage and image requirements)
- n8n Documentation (for general node usage and credential setup)