Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

The Evolution API node for n8n allows you to interact with the Evolution API, specifically targeting chat functionalities. The "Enviar Presença" (Send Presence) operation under the "Chat" resource enables you to programmatically send presence updates—such as "typing..." or "recording..."—to a specified contact in a WhatsApp-like environment. This is useful for automating user experience flows where simulating activity (e.g., showing that a bot is typing) enhances engagement or realism.

Practical examples:

  • Simulate a bot typing before sending an automated message.
  • Indicate to users that a voice note is being recorded by the system.
  • Integrate with customer support workflows to mimic human-like response delays.

Properties

Below are the input properties supported by this operation:

Display Name Type Description
Nome Da Instância String Digite o nome da instância (Enter the instance name). Required.
Contato String Número do contato (Contact number). Required.
Presença Options Tipo de presença a ser enviada (Type of presence to send). Options:
- Escrevendo... ("composing")
- Gravando... ("recording"). Required.
Delay Number Tempo em milissegundos que a presença ficará ativa (Time in milliseconds the presence will remain active). Required. Default: 1200

Output

The output is a JSON array containing the result of the presence update operation. The structure typically includes information about the success or failure of the request and may echo back details such as the contact, presence type, and duration. The exact fields depend on the Evolution API's response but generally follow this pattern:

[
  {
    "success": true,
    "contact": "5511999999999",
    "presence": "composing",
    "duration": 1200,
    // ...other API-specific fields
  }
]

Note: The actual output fields may vary based on the Evolution API's implementation.

Dependencies

  • External Service: Requires access to the Evolution API endpoint.
  • API Key/Credentials: You must configure valid credentials for the "evolutionApi" in your n8n instance.
  • n8n Configuration: Ensure the node is properly authenticated using the required credentials.

Troubleshooting

Common Issues:

  • Missing or Invalid Credentials: If credentials are not set up correctly, the node will fail to authenticate with the Evolution API.

  • Unsupported Operation Error: If the selected resource or operation is not implemented, you may see an error like:

    Operação não suportada.
A função "send-presence" para o recurso "chat-api" não é suportada!

    Resolution: Double-check that you have selected the correct resource and operation, and that your node version supports it.

  • Invalid Input Data: Providing an incorrect contact number or invalid presence type may result in API errors.

  • Network/Connectivity Issues: Ensure your n8n instance can reach the Evolution API endpoint.

Links and References

If you need more details about the output structure, refer to the official Evolution API documentation or inspect the node's output in n8n's execution logs.

Discussion