Evolution API Direct icon

Evolution API Direct

Interact with Evolution API using direct URL and API Key

Overview

This node integrates with the Evolution API to manage Chatwoot settings and data. It allows users to enable or disable Chatwoot integration, verify Chatwoot status, and configure various Chatwoot-related options such as importing contacts and messages, managing inboxes, and setting conversation states.

Common scenarios include:

  • Automating the activation or deactivation of Chatwoot integration for a given instance.
  • Importing historical contacts and messages into Chatwoot from another system.
  • Managing Chatwoot inboxes and conversation statuses programmatically.
  • Verifying the current Chatwoot configuration status.

Practical examples:

  • Automatically enabling Chatwoot integration when a new customer support instance is created.
  • Importing last 30 days of chat messages into Chatwoot for unified customer communication history.
  • Setting conversations to pending state on Chatwoot upon creation to prioritize follow-up.

Properties

Name Meaning
Server URL Full URL of the Evolution API server to connect to (e.g., https://api.exemplo.com).
API Key API key credential for authenticating requests to the Evolution API instance or global scope.
Nome Da Instancia Name of the instance that will send the message or perform the operation.
O Que Deseja Fazer Choose between "Definir Chatwoot" (set Chatwoot) to activate/deactivate or configure Chatwoot, or "Verificar Chatwoot" (find Chatwoot) to check Chatwoot status.
Ativar Chatwoot Boolean to enable or disable the Chatwoot integration (only for "setChatwoot" operation).
Link Do Chatwoot URL link to the Chatwoot instance (required for "setChatwoot").
ID Da Conta Do Chatwoot Account ID in Chatwoot to target (required for "setChatwoot").
Token De Admin Do Chatwoot Admin token for Chatwoot authentication (required for "setChatwoot").
Assinatura Do Agente Do Chatwoot Boolean to enable or disable agent signature in Chatwoot messages.
Reabrir Mensagens No Chatwoot Boolean to enable or disable reopening conversations/messages in Chatwoot.
Iniciar Conversas Como Pendentes No Chatwoot Boolean to start conversations as pending in Chatwoot.
Importar Contatos Para O Chatwoot Boolean to import contacts into Chatwoot.
Nome Da Inbox Do Chatwoot Optional name of the Chatwoot inbox to use or create.
Mesclar Contatos Brasileiros No Chatwoot Boolean to merge Brazilian contacts in Chatwoot.
Importar Mensagens Para O Chatwoot Boolean to import messages into Chatwoot.
Importar Mensagens De Quantos Dias Para O Chatwoot Optional number of days to limit message import to recent days only.
Criar Caixa De Entrada Boolean to automatically create an inbox if it does not exist.
Nome Do Contato De QRCode No Chatwoot Optional name for the QR code contact in Chatwoot.
Url Do Logo Para O Contato No Chatwoot Optional URL for the logo image used for the contact in Chatwoot.

Output

The node outputs a JSON array containing the result of the requested Chatwoot operation. The structure depends on the operation performed:

  • For "setChatwoot": Confirmation of the configuration update, including status flags and any created or updated resource identifiers.
  • For "findChatwoot": Details about the current Chatwoot integration status, such as whether it is enabled and relevant configuration details.

No binary data output is indicated.

Dependencies

  • Requires access to the Evolution API endpoint specified by the Server URL.
  • Requires a valid API key credential for authentication with the Evolution API.
  • For Chatwoot operations, requires Chatwoot admin token and account information.
  • Network connectivity to both Evolution API and Chatwoot services.
  • Proper configuration of instance name and other parameters as per user environment.

Troubleshooting

  • Common issues:

    • Invalid or missing API key or Chatwoot admin token causing authentication failures.
    • Incorrect Server URL or Chatwoot URLs leading to connection errors.
    • Missing required parameters like account ID or instance name.
    • Permissions issues on Chatwoot side preventing updates or imports.
    • Exceeding rate limits or API quotas on Evolution API or Chatwoot.
  • Error messages:

    • "Operação não suportada." — This indicates the selected operation is not supported for the chosen resource; ensure correct Resource and Operation are selected.
    • Authentication errors — Verify API keys and tokens are correct and have necessary permissions.
    • Validation errors — Check that all required fields are filled and correctly formatted.
  • Resolutions:

    • Double-check all input parameters for correctness.
    • Ensure API credentials are valid and active.
    • Confirm network connectivity and endpoint accessibility.
    • Review Chatwoot account permissions and roles.
    • Consult API documentation for rate limits and usage policies.

Links and References

Discussion