Actions64
- Instancia Actions
- Mensagem Actions
- Grupo Actions
- Chat Actions
- Perfil Actions
- Evento Actions
- Integração Actions
Overview
This node allows users to interact with the Evolution API specifically for managing proxy settings on an instance. It supports two main operations under the "Instancia" resource: setting (defining) a proxy and checking (finding) the current proxy configuration.
Typical use cases include:
- Enabling or disabling a proxy for an instance that sends messages through the Evolution API.
- Configuring proxy details such as protocol, host, port, username, and password.
- Verifying the current proxy status of an instance without making changes.
For example, a user might want to route their API requests through a corporate proxy by defining proxy settings, or they may want to check if a proxy is currently active on a given instance.
Properties
| Name | Meaning |
|---|---|
| Server URL | The full URL of the Evolution API endpoint to connect to. |
| API Key | The API key credential used to authenticate requests to the Evolution API. |
| Nome Da Instancia | The name of the instance that will send the message or have its proxy configured. |
| O Que Deseja Fazer | Choose between "Definir Proxy" (set/enable proxy) or "Verificar Proxy" (check proxy status). |
| Ativar Proxy | Boolean flag to enable or disable proxy integration (only shown when setting proxy). |
| Protocolo Do Proxy | Protocol type for the proxy connection; options are HTTP or HTTPS (only when setting proxy). |
| Host Do Proxy | The hostname or IP address of the proxy server (required when setting proxy). |
| Porta Do Proxy | The port number on which the proxy server listens (required when setting proxy). |
| Usuário Do Proxy | Username for authenticating with the proxy server (required when setting proxy). |
| Senha Do Proxy | Password for authenticating with the proxy server (required when setting proxy). |
Output
The node outputs a JSON array containing the result of the proxy operation performed:
- For setting the proxy, the output typically includes confirmation of the proxy being enabled or disabled along with the proxy details.
- For checking the proxy, the output returns the current proxy configuration status of the specified instance.
No binary data output is involved in this node.
Dependencies
- Requires access to the Evolution API via a valid server URL and API key.
- The API key must have sufficient permissions to manage proxy settings on instances.
- No additional external services or environment variables are explicitly required beyond the API credentials.
Troubleshooting
Common issues:
- Incorrect or missing API key leading to authentication failures.
- Invalid server URL causing connection errors.
- Missing required proxy fields when enabling proxy (host, port, username, password).
- Selecting an unsupported operation or resource combination.
Error messages:
"Operação não suportada."indicates the chosen operation-resource pair is not implemented. Verify you selected a valid operation ("Definir Proxy" or "Verificar Proxy") under the correct resource ("Instancia").- Authentication errors usually stem from invalid or expired API keys.
- Validation errors occur if required proxy parameters are omitted when enabling proxy.
To resolve these, ensure all required fields are correctly filled, the API key is valid, and the server URL is reachable.
Links and References
- Evolution API Documentation: https://doc.evolution-api.com/api-reference
- n8n Documentation on Custom Nodes: https://docs.n8n.io/integrations/creating-nodes/
- Proxy Configuration Best Practices: (Refer to your organization's proxy setup guidelines)