Evolution APIInstall

Overview

This node integrates with the Evolution API v2 to manage WhatsApp-related functionalities, specifically for groups, instances, messages, chats, events, and integrations. The "Grupo" resource with the "Atualizar Membros" (Update Members) operation allows users to update the members of a WhatsApp group.

In practical terms, this node is useful for automating group management tasks such as adding or removing participants in WhatsApp groups programmatically. For example, a business could automatically update group membership based on customer status changes or synchronize group members with an external CRM system.

Properties

Note: Although your provided properties JSON only includes instanceName and groupId, the source code does not explicitly show the implementation details for "Atualizar Membros" (updateGroupMembers) operation. However, based on naming conventions and other operations, these two inputs are essential to specify the target instance and group.

Output

The node outputs a JSON array where each item corresponds to the result of processing one input item. The output structure generally includes:

• success: A boolean indicating if the operation was successful.
• message: A string message describing the outcome (present when no detailed response is returned).
• timestamp: ISO string timestamp of when the operation completed.
• Additional fields depending on the API response, typically reflecting the updated group member information or confirmation.

If the API returns an array of results, each element is parsed and included in the output items.

The node does not explicitly handle binary data output.

Dependencies

• Requires an API key credential for authenticating requests to the Evolution API v2.
• Needs proper configuration of the Evolution API credentials within n8n.
• The node uses HTTP requests to the Evolution API endpoints corresponding to the selected resource and operation.

Troubleshooting

• Common Issues:

  • Invalid or missing instance name or group ID can cause request failures.
  • Authentication errors if the API key credential is not set up correctly.
  • Network issues or incorrect API endpoint URLs may lead to request timeouts or failures.

• Error Messages:

  • Errors thrown by the API are caught and returned as error messages in the output if "Continue On Fail" is enabled.
  • Typical error messages include authentication failures, invalid parameters, or resource not found.

• Resolution Tips:

  • Verify that the instance name matches an active WhatsApp instance configured in the Evolution API.
  • Ensure the group ID is correct and the instance has access to that group.
  • Check API credentials and network connectivity.
  • Enable "Continue On Fail" during testing to capture error details without stopping workflow execution.

Links and References

• Evolution API Documentation (Assumed URL; replace with actual if available)
• n8n Documentation on Creating Custom Nodes
• WhatsApp Business API documentation for understanding group management concepts.

Note: The source code provided does not explicitly show the internal request body or parameters for the "Atualizar Membros" operation, but it follows the pattern of calling the Evolution API with the instance name and group ID. For full usage, consult the official Evolution API documentation.