Evolution API Direct icon

Evolution API Direct

Interact with Evolution API using direct URL and API Key

Actions64

Overview

This node interacts with the Evolution API to send invitation links to WhatsApp groups. Specifically, for the "Grupo" resource and the "Enviar Link De Convite" operation, it sends a group invite link along with a custom message to specified recipient phone numbers. This is useful for automating group invitations in bulk or integrating group management into workflows.

Practical examples:

  • Automatically inviting new customers or users to a WhatsApp support group.
  • Sending event or community group invites to a list of contacts.
  • Managing group membership invitations programmatically without manual intervention.

Properties

Name Meaning
Server URL The full URL of your Evolution API server endpoint (e.g., https://api.exemplo.com).
API Key The API key credential used to authenticate requests to the Evolution API instance or global scope.
Nome Da Instância The name of the Evolution API instance that will send the invitation.
ID Do Grupo The unique identifier of the WhatsApp group to which the invite link will be sent.
Mensagem Do Convite The message text that accompanies the invitation link when sent to recipients.
Destinatários Comma-separated list of recipient phone numbers in international format (e.g., 5511999999999,5511888888888).

Output

The node outputs a JSON array where each item corresponds to the result of sending the invite link to the specified recipients. The exact structure depends on the Evolution API response but generally includes confirmation of successful sends or error details per recipient.

No binary data output is involved.

Dependencies

  • Requires access to an Evolution API server reachable via the provided Server URL.
  • Needs a valid API key credential for authentication.
  • Proper configuration of the instance name within the Evolution API environment.
  • Network connectivity from n8n to the Evolution API endpoint.

Troubleshooting

  • Common issues:
    • Invalid or missing API key causing authentication failures.
    • Incorrect Server URL leading to connection errors.
    • Malformed recipient phone numbers causing message delivery failures.
    • Using an incorrect group ID that does not exist or is inaccessible.
  • Error messages:
    • "Operação não suportada." indicates the requested operation is not implemented or recognized; verify Resource and Operation parameters.
    • Authentication errors typically suggest invalid API keys or insufficient permissions.
    • Network timeouts or unreachable host errors indicate connectivity problems.
  • Resolutions:
    • Double-check API key validity and permissions.
    • Confirm the Server URL is correct and accessible.
    • Validate phone number formats and group IDs before execution.
    • Review Evolution API documentation for any changes in endpoints or required parameters.

Links and References

Discussion