Wassenger icon

Wassenger

Interact with Wassenger WhatsApp API

Actions148

Overview

This node interacts with the Wassenger WhatsApp API to update labels on a specific chat associated with a WhatsApp number. It allows users to manage chat labels by replacing all existing labels, adding/updating labels (upsert), or removing specified labels only.

Common scenarios where this node is beneficial include:

  • Organizing chats by tagging them with relevant labels for easier filtering and management.
  • Automating label updates based on chat activity or status changes.
  • Removing outdated or irrelevant labels from chats to keep the system clean.

Practical example:

  • A customer support team uses this node to add a "priority" label to chats that require urgent attention.
  • Automatically remove the "pending" label once an issue is resolved by updating the chat labels accordingly.

Properties

Name Meaning
WhatsApp Number The ID of the WhatsApp number (device) to which the chat belongs. This identifies the source WhatsApp account.
Chat ID The unique identifier of the chat to update labels on. Examples: 447362053576@c.us for individual user chats, 44736205357600000000@g.us for group chats.
Labels One or more labels to set on the chat. These are string values representing tags or categories.
Update Type How to update the labels on the chat. Options:
- Replace All: Overwrite all existing labels with the provided ones.
- Add/Update (Upsert): Add new labels or update existing ones without removing others.
- Remove Only: Remove the specified labels from the chat without affecting others.

Output

The node outputs JSON data representing the result of the label update operation on the chat. This typically includes confirmation of the updated labels or the updated chat metadata reflecting the label changes.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Wassenger WhatsApp API via an API key credential configured in n8n.
  • The node depends on the Wassenger API's ability to identify devices (WhatsApp numbers) and chats by their IDs.
  • Proper permissions and valid API credentials are necessary to perform label updates on chats.

Troubleshooting

  • Invalid Chat ID: If the chat ID is incorrect or does not exist, the API may return an error indicating the chat was not found. Verify the chat ID format and existence.
  • Unauthorized Access: Errors related to authentication usually mean the API key is missing, invalid, or lacks required permissions. Check the API key configuration.
  • Labels Format Issues: Ensure labels are provided as strings and multiple labels are correctly formatted as an array.
  • Update Type Misuse: Using the wrong update type might lead to unexpected label states. For example, using "Remove Only" with labels that do not exist will have no effect.
  • API Rate Limits: Frequent updates might hit API rate limits; handle such errors by implementing retries or backoff strategies.

Links and References

Discussion