Evolution API Direct icon

Evolution API Direct

Interact with Evolution API using direct URL and API Key

Actions64

Overview

This node, named "Evolution API Direct," allows users to interact directly with the Evolution API by specifying a resource and operation along with necessary parameters such as server URL and API key. Specifically, for the "Grupo" resource and the "Atualizar Nome Do Grupo" (Update Group Name) operation, it updates the name of an existing group in the specified instance.

Common scenarios include:

  • Renaming a group within an Evolution API-managed environment.
  • Automating group management tasks where group names need to be updated dynamically based on external triggers or workflows.

Practical example:

  • A workflow that listens for a trigger event (e.g., a form submission) and updates the corresponding group's name in the Evolution system to reflect new information.

Properties

Name Meaning
Server URL The full URL of your Evolution API server endpoint (e.g., https://api.exemplo.com).
API Key The API key credential required to authenticate requests against the Evolution API.
Nome Da Instância The name of the instance where the group name will be updated.
ID Do Grupo The unique identifier (JID) of the group whose name is to be updated.
Novo Nome Do Grupo The new name that will be assigned to the group.

Output

The node outputs a JSON array containing the response from the Evolution API after attempting to update the group name. This typically includes confirmation details about the update operation, such as success status or updated group information.

If the API returns binary data (not indicated here), it would represent raw response content, but this node primarily deals with JSON responses.

Dependencies

  • Requires access to the Evolution API endpoint specified by the user.
  • Needs a valid API key credential for authentication.
  • Proper configuration of the server URL and instance name is essential.
  • No additional external libraries beyond those bundled with n8n are required.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API key leading to authentication failures.
    • Invalid server URL causing connection errors.
    • Providing an incorrect group ID resulting in "group not found" errors.
    • Insufficient permissions for the API key to perform update operations.

  • Error Messages:

    • "Operação não suportada." — Indicates the selected operation is not supported; verify the resource and operation names.
    • API authentication errors — Check that the API key is correct and has the necessary permissions.
    • Network or timeout errors — Ensure the server URL is reachable and the network connection is stable.

Resolving these usually involves verifying credentials, URLs, and input parameters.

Links and References

Discussion