Evolution API Direct icon

Evolution API Direct

Interact with Evolution API using direct URL and API Key

Overview

This node interacts with the Evolution API to manage group settings, specifically focusing on toggling ephemeral (temporary) messages within a group. It allows users to enable or disable message expiration in a specified group by setting an expiration time for messages. This is useful in scenarios where temporary communication is desired, such as announcements that should disappear after a certain period or maintaining privacy by automatically deleting messages.

Practical examples include:

  • Setting group messages to expire after 24 hours to keep conversations fresh.
  • Disabling message expiration to retain all group history.
  • Configuring message expiration for 7 days or 90 days depending on organizational policies.

Properties

Name Meaning
Server URL The full URL of your Evolution API server endpoint.
API Key The API key credential used to authenticate requests to the Evolution API instance.
Nome Da Instância The name of the Evolution API instance you want to interact with.
ID Do Grupo The identifier of the group where you want to configure ephemeral (temporary) messages.
Expiração The expiration time for messages in the group. Options: Disabled, 24 Hours, 7 Days, 90 Days.

Output

The node outputs a JSON array containing the response from the Evolution API after attempting to toggle the ephemeral message setting. The exact structure depends on the API response but typically includes confirmation of the updated group settings or error details if the operation failed.

No binary data output is indicated.

Dependencies

  • Requires access to the Evolution API via a valid server URL and API key.
  • Proper configuration of the API key credential in n8n is necessary.
  • The node expects the user to provide the instance name and group ID relevant to the target group.

Troubleshooting

  • Common issues:

    • Incorrect or missing API key leading to authentication failures.
    • Invalid group ID causing the API to reject the request.
    • Network connectivity problems preventing access to the Evolution API server.
    • Unsupported operations or resource names resulting in errors.
  • Error messages:

    • "Operação não suportada." indicates the selected operation is not supported for the chosen resource. Verify that "Grupo" resource and "Mensagens Temporárias" operation are correctly selected.
    • Authentication errors suggest checking the API key and server URL.
    • Validation errors may occur if required properties like group ID or instance name are missing or malformed.

Links and References

Discussion