Evolution API Direct icon

Evolution API Direct

Interact with Evolution API using direct URL and API Key

Actions64

Overview

The node "Evolution API Direct" allows users to interact with the Evolution API by sending requests directly using a specified server URL and an API key. Specifically, for the resource Mensagem and operation Enviar Enquete, this node sends a poll (enquete) message to a recipient via the Evolution API.

This is useful in scenarios where you want to automate sending interactive polls to contacts or groups through the Evolution messaging platform. For example, a marketing team could use this node to send customer feedback polls, or an event organizer could gather quick votes from participants.

Properties

Name Meaning
Server URL The full URL of your Evolution API server endpoint (e.g., https://api.exemplo.com).
API Key The API key credential required to authenticate requests to the Evolution API instance.
Nome Da Instância The name of the Evolution API instance that will send the poll.
Número Do Destinatário The recipient's number or identifier to whom the poll will be sent.
Titulo Da Enquete The title or caption of the poll being sent.
Opções Da Enquete The options for the poll; must be between 2 and 12 unique choices.

Details on "Opções Da Enquete"

  • This property is a collection allowing multiple values.
  • Each option is a string representing one choice in the poll.
  • Minimum 2 options and maximum 12 options are allowed.
  • Each option must be unique.

Output

The node outputs a JSON array containing the response from the Evolution API after attempting to send the poll. The exact structure depends on the API response but typically includes confirmation details such as message ID, status, or error information if the request failed.

No binary data output is indicated for this operation.

Dependencies

  • Requires access to an Evolution API server reachable at the provided Server URL.
  • Requires a valid API key credential for authentication.
  • The node expects the Evolution API instance name and recipient number to be correctly specified.
  • No additional external dependencies beyond the Evolution API service itself.

Troubleshooting

  • Common issues:

    • Invalid or missing API key leading to authentication errors.
    • Incorrect Server URL causing connection failures.
    • Providing fewer than 2 or more than 12 poll options, or duplicate options, which may cause validation errors.
    • Incorrect recipient number format resulting in delivery failure.

  • Error messages:

    • "Operação não suportada." indicates the requested operation is not implemented or recognized by the node.
    • API errors returned from the Evolution API will be passed through; check the API documentation for specific error codes and messages.

  • Resolutions:

    • Verify API key validity and permissions.
    • Confirm the Server URL is correct and accessible.
    • Ensure poll options meet the uniqueness and count requirements.
    • Validate recipient number formatting according to Evolution API specifications.

Links and References

Discussion