Evolution API icon

Evolution API

Interact with Evolution API

Overview

The node "Evolution API" allows interaction with the Evolution API service. Specifically, for the Resource "Chat" and Operation "Enviar Presença" (Send Presence), it sends a presence status to a specified contact in a chat context. This presence can indicate that the user is either typing ("Escrevendo...") or recording audio ("Gravando..."). The presence status remains active for a configurable delay time.

This node is useful in scenarios where you want to simulate or notify chat participants about your current activity status, such as showing typing indicators in messaging applications integrated via the Evolution API.

Practical examples:

  • Indicating to a chat contact that you are typing a message before sending it.
  • Showing that you are recording a voice note to prepare the recipient.

Properties

Name Meaning
Nome Da Instância The name of the instance to identify which Evolution API instance to use.
Contato The contact number (remote JID) to whom the presence status will be sent.
Presença The type of presence to send; options are: "Escrevendo..." (composing) or "Gravando..." (recording).
Delay Duration in milliseconds for how long the presence status should remain active.

Output

The node outputs a JSON array containing the response from the Evolution API after sending the presence status. The exact structure depends on the API response but generally includes confirmation of the presence sent or any relevant metadata.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API.
  • The base URL for requests is https://doc.evolution-api.com/api-reference.
  • Proper configuration of the Evolution API credentials within n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect contact number format may result in errors or failure to send presence.
    • Unsupported operation or resource selection will throw an error indicating the operation is not supported.
  • Error messages:

    • "Operação não suportada." means the selected operation is not implemented for the chosen resource. Verify that "Chat" and "Enviar Presença" are correctly selected.
    • Network or API errors may occur if the Evolution API service is unreachable or misconfigured.
  • Resolutions:

    • Ensure API credentials are valid and have required permissions.
    • Validate input fields, especially the contact number format.
    • Confirm that the node version supports the desired operation.

Links and References

Discussion