Evolution API Direct icon

Evolution API Direct

Interact with Evolution API using direct URL and API Key

Overview

The node "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 Resource "Grupo" and Operation "Atualizar Imagem Do Grupo" (Update Group Picture), this node updates the profile picture of a specified group by providing the group's ID and a new image URL.

This node is beneficial in scenarios where automated management of group images is required, such as updating branding or event-specific images across multiple groups programmatically. For example, an organization could use this node to update the group picture for all their communication groups when launching a new campaign.

Properties

Name Meaning
Server URL The full URL of your Evolution API instance (e.g., https://api.exemplo.com).
API Key The API key credential used to authenticate requests to the Evolution API.
Nome Da Instância The name of the instance where the group image will be updated.
ID Do Grupo The unique identifier (JID) of the group whose image will be updated.
URL Da Imagem The URL of the image that will be set as the new group picture.

Output

The node outputs a JSON array containing the response from the Evolution API after attempting to update the group image. This typically includes confirmation details about the update operation, such as success status or error messages if the update failed.

No binary data output is expected from this operation.

Dependencies

  • Requires access to the Evolution API endpoint specified by the user.
  • Requires a valid API key credential for authentication.
  • Proper configuration of the server URL and instance name is necessary to target the correct environment.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API key can cause authentication failures.
    • Invalid group ID (groupJid) may result in errors indicating the group was not found.
    • Providing an invalid or inaccessible image URL might cause the update to fail.
    • Incorrect server URL or instance name can lead to connection errors or targeting the wrong environment.
  • Error Messages:

    • "Operação não suportada." indicates that the selected operation is not supported for the chosen resource; verify that "Atualizar Imagem Do Grupo" is correctly selected under "Grupo".
    • API errors returned from the Evolution API will be passed through; check the message for details such as authentication failure or invalid parameters.
  • Resolution Tips:

    • Double-check all input properties for correctness.
    • Ensure the API key has sufficient permissions.
    • Verify the image URL is publicly accessible and points to a valid image file.
    • Confirm the group ID corresponds to an existing group in the specified instance.

Links and References

  • Evolution API Documentation (as referenced in the code's baseURL)
  • Consult your Evolution API provider for specific details on API key generation and group management endpoints.

Discussion