Evolution API

Interact with Evolution API

Actions64

Overview

The "Enviar Documento" operation of the "Mensagem" (Message) resource in this custom n8n node allows you to send a document (such as a PDF or other file) to a specified recipient via the Evolution API. This is particularly useful for automating workflows where documents need to be distributed through messaging platforms, such as sending invoices, reports, or any other files directly to users or groups.

Practical examples:

Automatically sending a contract PDF to a client after form submission.
Distributing event tickets or receipts to participants via WhatsApp or similar services.
Sending policy documents to employees in bulk.

Properties

Below are the supported input properties for this operation:

Display Name	Type	Description
Nome Da Instância	String	Digite o nome da instância que vai enviar o documento (Enter the name of the instance that will send the document). Required
Número Do Destinatário	String	Número do destinatário (Recipient's number). Required
Documento	String	URL ou base64 do documento (URL or base64 of the document). Required
Mensagem	String	Texto a ser enviado junto ao documento (Text message to send along with the document).
Nome Do Arquivo	String	Nome do arquivo do documento (File name for the document). Default: `document.pdf`
Opções	Collection	Additional options:
- Delay	Number	Milisegundos de delay antes de enviar (Delay in milliseconds before sending the message). Default: 1200
- Responder Mensagem	FixedCollection	Permite responder uma mensagem específica (Allows replying to a specific message by ID).
- ID Da Mensagem	String	ID da mensagem que será respondida (ID of the message being replied to).
- Menções	FixedCollection	Configurações para mencionar usuários (Mention settings):
- Mencionar Todos	Boolean	Whether to mention all participants in the group.
- Números Para Mencionar	String	Lista de números separados por vírgula para mencionar (Comma-separated list of numbers to mention).

Output

The output of this node is a JSON object containing the response from the Evolution API after attempting to send the document. The exact structure depends on the API's response, but typically includes fields such as:

{
  "status": "success",
  "messageId": "abc123",
  "timestamp": 1712345678,
  "details": { ... }
}

status: Indicates if the operation was successful.
messageId: The unique identifier of the sent message.
timestamp: When the message was sent.
details: Any additional information returned by the API.

If the API returns binary data (e.g., for file downloads), the node can output binary data, but for this operation ("Enviar Documento"), the output is expected to be JSON metadata about the sent message.

Dependencies

External Service: Requires access to the Evolution API.
API Key/Credentials: You must configure the evolutionApi credentials in n8n.
Environment: Ensure your n8n instance can reach the Evolution API endpoint (https://doc.evolution-api.com/api-reference).

Troubleshooting

Common Issues:

Missing Required Fields: If required fields like "Nome Da Instância", "Número Do Destinatário", or "Documento" are not provided, the node will throw an error.
Invalid Document Format: If the "Documento" property is not a valid URL or base64 string, the API may reject the request.
Unsupported Operation: If the operation or resource is not recognized, you may see an error like:
```
Operação não suportada.
A função "send-document" para o recurso "messages-api" não é suportada!
```
Resolution: Double-check that you have selected the correct resource and operation.
Authentication Errors: If credentials are missing or incorrect, the API will return an authentication error.