Evolution APIInstall

Overview

This node integrates with the Evolution API v2 to manage WhatsApp groups and other related resources. Specifically, for the Grupo resource and the Enviar Link de Convite do Grupo operation, it sends an invitation link to a specified WhatsApp group via a configured instance.

Use cases include automating group invitations in customer support workflows, marketing campaigns, or community management where you want to programmatically share group invite links with users.

Example scenario: You have a WhatsApp group for VIP customers and want to automatically send the invite link to new subscribers or contacts using this node.

Properties

Output

The node outputs a JSON object containing the response from the Evolution API after attempting to send the group invite link. The output includes:

• success: Boolean indicating if the operation was successful.
• timestamp: ISO string timestamp of when the operation completed.
• Additional fields depend on the API response but typically include confirmation details or error messages.

No binary data is output by this operation.

Dependencies

• Requires an API key credential for authenticating with the Evolution API v2.
• The node expects the Evolution API to be accessible and properly configured with the WhatsApp instance.
• Proper configuration of the WhatsApp instance (identified by "Instance Name") is necessary before sending group invites.

Troubleshooting

• Common issues:

  • Invalid or missing Instance Name or Group ID parameters.
  • Authentication failures due to incorrect or expired API credentials.
  • Network connectivity problems preventing access to the Evolution API.
  • The specified group may not exist or the instance may not have permission to send invites.

• Error messages:

  • Errors returned from the API are passed through in the output's error field if the node is set to continue on failure.
  • Typical errors include "Unauthorized", "Group not found", or "Invalid instance".

• Resolutions:

  • Verify that the Instance Name matches a valid and connected WhatsApp instance.
  • Confirm the Group ID is correct and the instance has rights to send invites.
  • Check API credentials and renew if expired.
  • Ensure network access to the Evolution API endpoint.

Links and References

• Evolution API Documentation (hypothetical link as no direct URL provided)
• WhatsApp Group Management Best Practices
• n8n Documentation on Custom Nodes and API Integration