Evolution APIInstall

Overview

This node interacts with the Evolution API v2 to manage WhatsApp-related resources such as instances, messages, groups, chats, events, and integrations. Specifically, for the "Grupo" (Group) resource and the "Atualizar Configurações do Grupo" (Update Group Settings) operation, it allows updating various group settings on a WhatsApp group managed through an Evolution API instance.

Common scenarios where this node is beneficial include automating group management tasks in WhatsApp business workflows, such as changing group configurations programmatically without manual intervention. For example, you might update group permissions or toggle ephemeral messages in a customer support group automatically based on certain triggers.

Properties

Note: Although your provided properties only list "Instance Name" and "Group ID", the node supports multiple operations under the "group" resource, each requiring different additional parameters. For the "Atualizar Configurações do Grupo" operation specifically, the code snippet does not show explicit parameters, but typically this would involve settings like enabling/disabling ephemeral messages, changing group permissions, etc., which would be passed in the request body.

Output

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

• The raw response from the Evolution API parsed as JSON.
• A success boolean flag indicating if the operation was successful.
• A timestamp field with the ISO string of when the operation completed.
• If the API returns an array, each element is parsed individually.
• In case of errors, an error message is included per item if "Continue On Fail" is enabled.

No binary data output is indicated by the source code.

Dependencies

• Requires an authenticated connection to the Evolution API v2 via an API key credential configured in n8n.
• The node uses HTTP requests to the Evolution API endpoints, so network connectivity to the API service is necessary.
• Proper configuration of the Evolution API credentials in n8n is mandatory.

Troubleshooting

• Common Issues:

  • Incorrect or missing "Instance Name" or "Group ID" can cause API errors.
  • Network issues or invalid API credentials will result in authentication failures.
  • Passing malformed JSON or incorrect parameters for group settings may cause the API to reject the request.

• Error Messages:

  • Authentication errors usually indicate invalid or missing API keys; verify credentials.
  • "Group not found" or similar errors suggest the provided Group ID is incorrect or the instance does not have access.
  • JSON parsing errors in the output usually mean the API returned unexpected data; check API status and inputs.

• Resolution Tips:

  • Double-check all required parameters are correctly set.
  • Ensure the Evolution API credentials are valid and have sufficient permissions.
  • Use the node's "Continue On Fail" option to handle partial failures gracefully.

Links and References

• Evolution API Documentation (Assumed URL, replace with actual if known)
• n8n Documentation on Creating Custom Nodes
• WhatsApp Business API official docs for understanding group management concepts: https://developers.facebook.com/docs/whatsapp/api/groups

If you need details on other operations or resources, feel free to ask!