Evolution APIInstall

Overview

This node interacts with the Evolution API v2 to manage WhatsApp groups and other related resources. Specifically, the "Revogar Link de convite do Grupo" (Revoke Group Invite Link) operation allows users to revoke an existing invitation link for a WhatsApp group, effectively disabling that invite link so it can no longer be used to join the group.

This functionality is useful in scenarios where group administrators want to control access to their groups by invalidating previously shared invite links, for example:

• After sharing a temporary invite link publicly or with a limited audience.
• To prevent further joining after a certain event or deadline.
• To enhance group security by rotating invite links regularly.

Practical example: A community manager creates a WhatsApp group for an event and shares an invite link. Once the event starts, they use this node to revoke the invite link, ensuring no new participants can join using the old link.

Properties

Output

The node outputs a JSON object representing the result of the revoke invite link operation. The output includes:

• success: A boolean indicating if the operation was successful.
• message: A string message confirming the operation status (e.g., "Operation completed successfully").
• timestamp: The ISO timestamp when the operation was performed.
• Additional fields returned by the Evolution API response may also be included.

No binary data output is produced by this operation.

Dependencies

• Requires an active Evolution API v2 credential configured in n8n for authentication.
• The node depends on the Evolution API service being accessible and the specified instance being connected.
• Proper permissions on the Evolution API side to manage group invite links are necessary.

Troubleshooting

• Common issues:

  • Invalid or missing Instance Name or Group ID parameters will cause the operation to fail.
  • Network connectivity problems or incorrect API credentials will prevent successful API calls.
  • Attempting to revoke an invite link for a non-existent or inaccessible group will result in errors.

• Error messages and resolutions:

  • "401 Unauthorized": Check that the API key or authentication token is valid and has not expired.
  • "404 Not Found": Verify that the provided Group ID exists and belongs to the specified instance.
  • "400 Bad Request": Ensure all required parameters are correctly set and formatted.
  • Timeout or network errors: Confirm network connectivity and API endpoint availability.

Links and References

• Evolution API Documentation (hypothetical link)
• WhatsApp Group Management Best Practices
• n8n Documentation on Custom Nodes and API Integration