Wuzapi Group icon

Wuzapi Group

Manage WhatsApp groups with Wuzapi API

Actions14

Overview

This node allows managing WhatsApp groups via the Wuzapi API. It supports a variety of group-related operations such as creating groups, retrieving group information, managing invite links, joining or leaving groups, changing group settings (name, description, photo, announcement mode, ephemeral messages, locked status), and updating participants by adding, removing, promoting, or demoting them.

The Update Participants operation specifically enables modifying the membership and roles within a WhatsApp group. You can add new participants, remove existing ones, promote participants to admins, or demote admins back to regular participants.

Practical examples:

  • Adding new members to a team chat group automatically when onboarding new employees.
  • Removing inactive users from a community group.
  • Promoting trusted members to admin status for better group management.
  • Demoting admins who no longer need elevated privileges.

Properties

Name Meaning
Group JID The unique identifier (JID) of the WhatsApp group where participants will be updated.
Action The participant action to perform: Add, Remove, Promote, or Demote participants.
Phone Numbers Comma-separated list of phone numbers or JIDs representing the participants to update.

Output

The node outputs JSON data reflecting the response from the Wuzapi API for the performed operation. For the Update Participants operation, this typically includes confirmation details about the success or failure of adding, removing, promoting, or demoting participants in the specified group.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Wuzapi API with valid API credentials configured in n8n.
  • The node depends on the wuzapiApiRequest function to communicate with the Wuzapi REST endpoints.
  • Proper phone number formatting is validated internally before sending requests.

Troubleshooting

  • Common issues:

    • Invalid or improperly formatted group JID or phone numbers may cause request failures.
    • Attempting to promote or demote participants who are not members or admins respectively could result in errors.
    • Network or authentication errors if API credentials are missing or incorrect.

  • Error messages:

    • "Binary property \"<property>\" not found" — Not applicable for this operation but indicates missing binary data if used elsewhere.
    • API error responses will be passed through; check the message for details like invalid group ID or insufficient permissions.

  • Resolution tips:

    • Ensure all phone numbers are correctly formatted and include country codes.
    • Verify that the group JID corresponds to an existing group you have permission to manage.
    • Confirm API credentials are set up correctly in n8n and have necessary scopes.

Links and References

Discussion