SparkBot icon

SparkBot

Interact with SparkBot WhatsApp API

Actions148

Overview

This node allows users to update the profile image of a specified WhatsApp number managed via the SparkBot WhatsApp API. It is useful in scenarios where businesses want to programmatically change their WhatsApp profile picture, for example, to reflect seasonal branding, special promotions, or updated logos without manual intervention.

Practical examples include:

  • Automatically updating the WhatsApp profile image daily with a new promotional banner.
  • Changing the profile picture based on specific campaigns or events.
  • Setting a default profile image when onboarding new WhatsApp numbers.

Properties

Name Meaning
WhatsApp Number The ID of the WhatsApp number whose profile image you want to update.
Image Source The source format of the image to upload. Options: URL (image fetched from a web URL), Base64 (image data encoded in Base64).
Image URL The direct URL of the image to use as the profile picture. Must be JPG or PNG and max 1MB.
Base64 Image The Base64 encoded string of the image data to use as the profile picture. Must be JPG or PNG and max 1MB.

Output

The node outputs JSON data representing the result of the profile image update operation. This typically includes confirmation details such as success status or any returned metadata from the API about the updated profile image.

No binary data output is produced by this node.

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 WhatsApp number must be registered and accessible via the SparkBot platform.

Troubleshooting

  • Common issues:

    • Upload failure due to image size exceeding 1MB limit.
    • Invalid image format errors if the image is not JPG or PNG.
    • Authentication errors if the API key is missing or invalid.
    • Network errors if the provided image URL is unreachable or times out.
  • Error messages and resolutions:

    • "Image size exceeds maximum allowed limit": Ensure the image is less than or equal to 1MB.
    • "Unsupported image format": Use only JPG or PNG images.
    • "Authentication failed": Verify that the API key credential is correctly set up and valid.
    • "Failed to fetch image from URL": Check the URL accessibility and correctness.

Links and References

Discussion