WaliChat icon

WaliChat

Interact with WaliChat WhatsApp API

Actions148

Chats → Bulk Update Chats

AI-generated

Overview

The node provides bulk update capabilities for WhatsApp chats managed via the WaliChat API. It allows users to perform various actions on multiple chats simultaneously, such as resolving, pinning, muting, assigning agents, blocking, marking as read/unread, and managing labels. This is particularly useful in customer support or sales scenarios where managing large volumes of chat conversations efficiently is critical.

For example, a support team can bulk assign multiple unresolved chats to a specific agent or department, mute several noisy group chats at once, or add/remove labels to categorize chats for better tracking.

Properties

Name Meaning
WhatsApp Number The ID of the WhatsApp number (device) from which the chats are managed.
Action The operation to perform on the selected chats. Options include: Resolve, Unresolve, Pin, Unpin, Mute, Unmute, Assign, Unassign, Block, Unblock, Read, Unread, Labels.
Chat IDs/Phone Numbers List of chat identifiers or phone numbers to update. Can be in formats like +447362053576 or 447362053576@c.us. Multiple values allowed.
Labels to Add (Only when Action is "Labels") Labels to add to the chats. Multiple values allowed.
Labels to Remove (Only when Action is "Labels") Labels to remove from the chats. Multiple values allowed.
Agent ID (Only when Action is "Assign") The ID of the agent to whom the chats will be assigned.
Department ID (Optional, only when Action is "Assign") The ID of the department to assign the chats to.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each JSON object contains the result of the bulk update action performed on the specified chats. The exact structure depends on the action but generally includes confirmation of success or details about the updated chats.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the WaliChat WhatsApp API.
  • The node depends on the WaliChat API endpoints that handle chat management operations.
  • Some properties load options dynamically (e.g., WhatsApp numbers, agents, departments), so proper API access and permissions are necessary.
  • No additional external services beyond WaliChat API are required.

Troubleshooting

  • Common Issues:

    • Invalid or missing WhatsApp number (device) ID may cause failures.
    • Incorrect chat IDs or phone numbers format can lead to errors or no updates applied.
    • Assigning chats to non-existent agents or departments will fail.
    • Attempting unsupported actions on chats may return errors.

  • Error Messages:

    • Errors typically indicate invalid parameters or authorization issues.
    • If the node throws errors related to chat IDs, verify the format and existence of those chats.
    • Authentication errors suggest checking the API key credential configuration.

  • Resolution Tips:

    • Ensure all required fields are correctly filled.
    • Validate chat IDs and phone numbers before running the node.
    • Confirm that the API key has sufficient permissions.
    • Use the "Continue On Fail" option to process other items even if some fail.

Links and References

Discussion