Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

This n8n node allows you to send text messages via the Evolution API, specifically using the "Enviar Texto" (Send Text) operation under the "Mensagem" (Message) resource. It is designed for scenarios where automated or programmatic sending of WhatsApp (or similar platform) messages is required, such as notifications, alerts, or customer engagement workflows.

Practical examples:

  • Sending appointment reminders to clients.
  • Notifying users about order status updates.
  • Broadcasting announcements to group chats with optional mentions and link previews.

Properties

Below are the supported input properties for this operation:

Display Name Type Meaning
Nome Da Instancia string The name of the instance that will send the message.
Numero Do Destinatario string The recipient's remoteJid (unique identifier for the destination contact or group).
Mensagem string The text message content to be sent.
Opções collection Additional options for message sending (see below).

Opções (Options) sub-properties:

  • Delay (number): Number of milliseconds to wait before sending the message.
  • Responder Mensagem (fixedCollection):
    • ID Da Mensagem (string): ID of the message being replied to.
  • Menções (fixedCollection):
    • Mencionar Todos (boolean): Whether to mention all participants in a group.
    • Números Para Mencionar (string): List of numbers to mention (comma-separated), used if not mentioning everyone.
  • Preview De Link (boolean): Enable or disable link preview in the message.

Output

The output will be a JSON object (or array of objects) representing the result of the message-sending operation. The structure typically includes:

{
  "status": "success",
  "messageId": "string",
  "timestamp": "number",
  // ...other fields as returned by the Evolution API
}
  • status: Indicates whether the message was sent successfully.
  • messageId: Unique identifier of the sent message.
  • timestamp: Time when the message was sent.

Note: The exact output fields depend 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 credential type evolutionApi.
  • n8n Configuration: No additional configuration beyond credentials is required.

Troubleshooting

Common Issues:

  • Missing or invalid credentials: Ensure your Evolution API credentials are correctly set up in n8n.
  • Unsupported operation/resource: If you select an unsupported combination, you may see:
    • "Operação não suportada."
      Translation: Operation not supported.
    • "A função \"send-text\" para o recurso \"messages-api\" não é suportada!"
      Translation: The function "send-text" for the resource "messages-api" is not supported!
  • Invalid recipient JID: Make sure the recipient's number is formatted correctly according to Evolution API requirements.
  • API errors: Any error from the Evolution API will be passed through; check the error message for details.

How to resolve:

  • Double-check property values, especially required fields.
  • Verify your API credentials and permissions.
  • Consult the Evolution API documentation for correct parameter formats.

Links and References

Discussion