Evolution API icon

Evolution API

Interact with Evolution API

Overview

The node "Evolution API" allows interaction with the Evolution API service. Specifically, for the Resource "Instancia" and Operation "Definir Comportamento" (Define Behavior), it configures instance-level settings such as call rejection, message reading behavior, group message ignoring, and synchronization preferences. This node is useful in scenarios where you want to automate or customize how an instance behaves in terms of handling calls, messages, and status updates.

Practical examples include:

  • Automatically rejecting incoming calls with a custom message.
  • Ignoring messages from group chats.
  • Marking messages as read automatically.
  • Keeping the instance always online.
  • Synchronizing full chat history for backup or analysis purposes.

Properties

Name Meaning
Nombre De La Instancia The name assigned to the instance being configured.
Rechazar Llamadas Whether to reject incoming calls (true/false).
Mensaje De Llamadas The message sent when calls are rejected.
Ignorar Grupos Whether to ignore messages coming from groups (true/false).
Siempre En Línea Whether the instance should remain always online (true/false).
Leer Mensajes Whether messages should be marked as read automatically (true/false).
Sincronizar Historial Completo Whether to synchronize the entire message history (true/false).
Leer Estados Whether to read the status of contacts (true/false).

Output

The node outputs a JSON array containing the result of applying the defined behavior settings to the specified instance. The exact structure depends on the Evolution API response but generally includes confirmation of the updated settings or any relevant status information.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API.
  • The base URL for requests is https://doc.evolution-api.com/api-reference.
  • Proper configuration of the API credential within n8n is necessary.

Troubleshooting

  • Unsupported Operation Error: If the operation or resource is not supported, the node throws an error indicating the unsupported function. Ensure that the resource is "instances-api" and operation is "instance-settings" (or the correct corresponding values).
  • Authentication Failures: Missing or invalid API credentials will cause authentication errors. Verify that the API key is correctly set up in n8n credentials.
  • Invalid Property Values: Required properties like "Nombre De La Instancia" must be provided; otherwise, the node may fail or behave unexpectedly.
  • Network Issues: Connectivity problems to the Evolution API endpoint can cause request failures. Check network access and API availability.

Links and References

Discussion