Wazzap API icon

Wazzap API

Interact with Wazzap API
Join our community

Actions23

Overview

The node interacts with the Wazzap API to manage WhatsApp groups. Specifically, for the "👥 Group" resource and the "⭐ Promote Admins" operation, it promotes specified phone numbers to admin status within a given WhatsApp group.

This node is useful in scenarios where you want to programmatically assign admin privileges to members of a WhatsApp group, such as automating group management tasks or integrating group administration into broader workflows.

Example use case: Automatically promote certain users to admins when they join a group or based on external triggers like CRM events.

Properties

Name Meaning
👥 Group ID (JID) The unique identifier of the WhatsApp group where the promotion will occur. It must be in the format like 1234567890-123456@g.us.
📞 Phone Numbers One or more phone numbers to be promoted to admin status. Each number should include the full country code (e.g., +521234567890).
⚙️ Additional Options Optional settings to customize the request:
- 🔢 Priority Number: Select which sending number to use (0 = Default, 999 = Random, 1–5 = Specific slot).
- ⏱️ Delay Settings: Configure a random delay range (in milliseconds) before sending the promotion command, with start and end values.

Output

The node outputs a JSON array containing the response from the Wazzap API after attempting to promote the specified phone numbers to admins in the target group. The exact structure depends on the API response but typically includes success or error information per phone number.

No binary data output is involved.

Dependencies

  • Requires an active connection to the Wazzap API via an API key credential configured in n8n.
  • The node uses the base URL https://doc.wazzap.mx/api-reference for API requests.
  • Proper permissions on the Wazzap API to manage group admins are necessary.

Troubleshooting

  • Common issues:

    • Invalid or malformed Group ID (JID) can cause failures.
    • Phone numbers not registered or not part of the group may not be promotable.
    • Insufficient API permissions or invalid API key will result in authentication errors.
    • Delay settings misconfiguration might cause unexpected timing behavior.

  • Error messages:

    • "Unsupported operation." — indicates the selected operation is not implemented; verify that "Promote Admins" is correctly chosen.
    • API errors returned by Wazzap (e.g., unauthorized, not found) should be checked against the API documentation.

  • Resolutions:

    • Double-check the group JID format.
    • Ensure phone numbers are correct and belong to the group.
    • Verify API credentials and permissions.
    • Adjust delay settings if needed to avoid rate limits or timing conflicts.

Links and References

  • Wazzap API Documentation (official API reference)
  • WhatsApp group management best practices (external resources may apply)

Discussion