SparkBot icon

SparkBot

Interact with SparkBot WhatsApp API
Join our community

Actions148

Overview

This node allows users to delete WhatsApp user statuses associated with a specific WhatsApp number (device). It supports multiple deletion methods, including deleting all statuses, deleting scheduled statuses by their IDs, or deleting specific statuses by their WhatsApp IDs. This functionality is useful for managing and cleaning up user status content programmatically, such as removing outdated or unwanted statuses from a WhatsApp business account.

Practical examples:

  • Automatically clear all user statuses at the end of a marketing campaign.
  • Remove specific scheduled statuses that are no longer relevant.
  • Delete particular statuses identified by their unique WhatsApp IDs to maintain updated status content.

Properties

Name Meaning
WhatsApp Number The ID of the WhatsApp number (device) on which the user statuses exist.
Delete Method The method used to delete statuses. Options: "Delete All", "Delete Scheduled Status", "Delete Specific Status".
Scheduled Status IDs (Required if "Delete Scheduled Status" is chosen) Array of 24-character hexadecimal IDs representing scheduled statuses to delete.
Status IDs (Required if "Delete Specific Status" is chosen) Array of WhatsApp IDs (WID) of statuses to delete.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will include confirmation of successful deletions or error information if the operation failed. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the SparkBot WhatsApp API.
  • The node depends on the external SparkBot WhatsApp API service to perform status deletions.
  • The "WhatsApp Number" must be valid and linked to the authenticated account.
  • The node uses dynamic loading of available devices (WhatsApp numbers) via a method named getDevices.

Troubleshooting

  • Common issues:

    • Providing invalid or empty WhatsApp number/device ID will cause failures.
    • Using incorrect or malformed status IDs (not 24-length hex strings for scheduled statuses or invalid WIDs for specific statuses) will result in errors.
    • Attempting to delete statuses without selecting the appropriate delete method or without providing required IDs for that method.
    • API authentication failures due to missing or invalid API key credentials.

  • Error messages and resolutions:

    • "Invalid device ID" — Verify the WhatsApp number selected exists and is correctly loaded.
    • "Missing status IDs" — Ensure that when using selective deletion methods, the corresponding IDs are provided.
    • "Authentication failed" — Check that the API key credential is set up correctly in n8n.
    • "Status not found" — Confirm that the status IDs correspond to existing statuses on the WhatsApp number.

Links and References

Discussion