Evolution API

Interact with Evolution API

Actions64

Overview

This node allows you to send a WhatsApp group invitation link to specified recipients using the Evolution API. It is particularly useful for automating the process of inviting users to WhatsApp groups, such as onboarding new members, sending event invitations, or managing community access.

Practical examples:

Automatically invite new customers to a support group after purchase.
Send event participants a group link with a personalized message.
Onboard employees into internal communication groups.

Properties

Display Name	Type	Description
Nome Da Instância	String	Digite o nome da instância que vai enviar o convite (Name of the instance that sends the invite)
ID Do Grupo	String	ID do grupo para enviar o convite (Group ID to send the invite to)
Mensagem Do Convite	String	Mensagem que será enviada junto com o link do convite (Message sent with the invite link)
Destinatários	String	Digite os números dos destinatários separados por vírgula (Enter recipient numbers, comma-separated, e.g., 5511999999999,5511888888888)

All properties are required.

Output

The output will be a JSON array containing the result(s) of the invitation operation. The structure typically includes:

Status of the invitation sending process
Details about each recipient (such as number and delivery status)
Any error messages if the operation failed

Example output:

[
  {
    "number": "5511999999999",
    "status": "sent",
    "message": "Invitation link sent successfully"
  },
  {
    "number": "5511888888888",
    "status": "failed",
    "error": "Number not registered on WhatsApp"
  }
]

Note: The exact fields may vary depending on the Evolution API response.

Dependencies

External Service: Requires access to the Evolution API.
API Key/Credentials: You must configure valid Evolution API credentials in n8n under the name evolutionApi.
n8n Configuration: No additional configuration beyond credentials is required.

Troubleshooting

Common issues:

Invalid Group ID: If the group ID is incorrect, the API may return an error indicating the group was not found.
Invalid Recipient Numbers: If any recipient number is not registered on WhatsApp, the output will include an error for that number.
Missing Credentials: If credentials are not set up correctly, the node will fail to authenticate with the Evolution API.
Unsupported Operation: If the resource or operation is not supported, you may see an error like:
```
Operação não suportada.
A função "send-invite-link" para o recurso "groups-api" não é suportada!
```
Ensure you have selected the correct resource and operation.

How to resolve:

Double-check all input values, especially group ID and recipient numbers.
Ensure your Evolution API credentials are active and correctly configured in n8n.
Verify that the selected resource and operation are available in your version of the node.