Evolution API icon

Evolution API

Interact with Evolution API

Overview

This node interacts with the Evolution API to send group invitation links via WhatsApp. Specifically, for the "Grupo" resource and the "Enviar Link De Convite" operation, it sends an invite link message to specified recipients for a given group. This is useful in scenarios where you want to automate inviting multiple users to join a WhatsApp group by sending them a direct invite link along with a custom message.

Practical examples include:

  • Automatically inviting new customers or community members to a WhatsApp support or interest group.
  • Sending batch invitations to event participants or team members to join a group chat.
  • Managing group membership invitations programmatically without manual message sending.

Properties

Name Meaning
Nome Da Instância The name of the 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 invite link when sent to recipients.
Destinatários Comma-separated list of recipient phone numbers (e.g., 5511999999999,5511888888888) to receive the invite.

Output

The node outputs a JSON array containing the response from the Evolution API after attempting to send the invite links. The exact structure depends on the API response but typically includes status information about the sent messages.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API.
  • The node expects proper configuration of this API authentication within n8n credentials.
  • Internet connectivity to reach the Evolution API endpoints.

Troubleshooting

  • Common issues:
    • Invalid or missing API credentials can cause authentication failures.
    • Incorrect group ID or instance name may result in errors or no invites being sent.
    • Improperly formatted recipient numbers (not comma-separated or invalid phone formats) can cause message delivery failures.
  • Error messages:
    • "Operação não suportada." indicates the requested operation is not implemented or recognized; ensure correct resource and operation names.
    • API errors related to authorization or invalid parameters should be resolved by verifying credentials and input values.

Links and References

  • Evolution API official documentation (refer to your API provider's docs for detailed usage).
  • WhatsApp Group Invitation guidelines (for understanding invite link behavior).

Discussion