N8N Tools - Uazapi icon

N8N Tools - Uazapi

Complete Uazapi integration - Premium WhatsApp API with advanced messaging and automation

Actions37

Overview

This node integrates with the Uazapi WhatsApp API to manage WhatsApp groups, specifically allowing you to demote group admins back to regular participants. It is useful in scenarios where group admin privileges need to be revoked from certain members, for example, when restructuring group management or limiting administrative access.

Practical examples include:

  • Automatically demoting users who no longer should have admin rights.
  • Managing group roles dynamically based on external triggers or workflows.
  • Maintaining control over group administration in large WhatsApp groups.

Properties

Name Meaning
Group ID The unique identifier of the WhatsApp group where the admin(s) will be demoted.
Participants Comma-separated phone numbers of the group members to demote from admin status (e.g., 5511999999999,5511888888888).
Additional Fields Optional extra parameters:
- Reply to Message ID: ID of a message to reply to.
- Delay (seconds): Delay before sending the request.
- Disable Link Preview: Whether to disable link previews.
- Mention Users: Comma-separated phone numbers to mention in messages.

Output

The node outputs a JSON object containing the response from the Uazapi WhatsApp API after attempting to demote the specified admins. This typically includes confirmation of the operation's success or details about any errors encountered.

If multiple items are processed, the output is an array of such JSON objects paired with their respective input items.

No binary data is output by this operation.

Dependencies

  • Requires an active Uazapi WhatsApp API account with valid credentials including an API key, API token, instance ID, and API URL.
  • The node uses these credentials to authenticate requests to the Uazapi service.
  • Proper configuration of these credentials within n8n is necessary for successful operation.

Troubleshooting

  • Common Issues:

    • Invalid or missing Group ID or participant phone numbers can cause failures.
    • Incorrect formatting of phone numbers (should include country code without symbols).
    • Insufficient permissions or invalid API credentials may result in authorization errors.
    • Network connectivity issues can prevent communication with the Uazapi API.

  • Error Messages:

    • Errors returned from the API will be included in the output JSON under an error field if "Continue On Fail" is enabled.
    • Common error messages might indicate invalid group IDs, unauthorized access, or malformed requests.

  • Resolution Tips:

    • Verify that the Group ID corresponds to an existing WhatsApp group managed by your instance.
    • Ensure participant phone numbers are correctly formatted and belong to current group members.
    • Check that API credentials are correctly set up and have not expired.
    • Use the "Continue On Fail" option to handle errors gracefully in workflows.

Links and References

Discussion