Evolution APIInstall

Overview

The node "Evolution API" allows interaction with the Evolution API to perform various operations on different resources. Specifically, for the resource Grupo and operation Atualizar Membros, it updates group members by adding, removing, promoting, or demoting participants in a specified group. This is useful in scenarios where you need to manage group membership dynamically, such as automating member management in chat groups or collaboration platforms.

Practical examples include:

• Adding new users to a project discussion group automatically when they join a team.
• Removing inactive members from a group.
• Promoting trusted members to administrators to delegate moderation tasks.
• Demoting administrators back to regular members if needed.

Properties

Output

The node outputs a JSON array containing the result of the update operation performed on the group members. Each item in the output corresponds to the response from the Evolution API after executing the requested action (add, remove, promote, demote) on the specified participants.

If the API supports binary data responses, this node does not explicitly handle or output binary data based on the provided code and properties.

Dependencies

• Requires an API key credential for authenticating with the Evolution API.
• The node expects the Evolution API endpoint to be accessible and properly configured.
• No additional environment variables are explicitly required beyond the API authentication setup.

Troubleshooting

• Common issues:

  • Invalid or missing group ID (ID Do Grupo) can cause the API call to fail.
  • Incorrect formatting of the Membros list (e.g., missing commas or invalid phone numbers) may lead to errors.
  • Insufficient permissions or invalid API credentials will prevent successful updates.
  • Unsupported actions or typos in the Ação property could trigger unsupported operation errors.

• Error messages:

  • "Operação não suportada." indicates that the selected operation is not implemented for the chosen resource. Verify that the resource and operation names are correct.
  • API errors related to authentication or authorization should be resolved by checking the API key credential.
  • Validation errors from the API about participant numbers or group IDs require ensuring the input values conform to expected formats.

Links and References

• Evolution API official documentation (not provided here; consult your API provider)
• n8n documentation on creating and using custom nodes: https://docs.n8n.io/integrations/creating-nodes/
• General best practices for managing group memberships in APIs