Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

The node "Evolution API" allows interaction with the Evolution API service. Specifically, for the Resource "Message" and Operation "Send Poll," it enables sending a poll message to a specified recipient via an instance of the Evolution API. This is useful in scenarios where you want to gather feedback or opinions from users through polls sent as messages.

Practical examples include:

  • Sending customer satisfaction polls after a support interaction.
  • Conducting quick surveys within a chat environment.
  • Collecting votes on event planning options.

Properties

Name Meaning
Instance Name The name of the Evolution API instance that will send the poll message.
Recipient Number The phone number or identifier of the recipient who will receive the poll.
Poll Title The title or question of the poll being sent.
Poll Options A collection of unique options (minimum 2, maximum 12) that recipients can choose from.

Note: The property "Poll Options" requires each option to be unique and supports multiple values between 2 and 12.

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 operation failed.

No binary data output is indicated.

Dependencies

  • Requires an active Evolution API credential configured in n8n to authenticate requests.
  • The node sends HTTP requests to the Evolution API endpoint at https://doc.evolution-api.com/api-reference.
  • Proper configuration of the instance name and recipient number is necessary for successful poll delivery.

Troubleshooting

  • Operation not supported error: If the node throws an error stating the operation is not supported, verify that the resource is set to "messages-api" and the operation to "send-poll".
  • Invalid or missing parameters: Ensure all required properties (instance name, recipient number, poll title, and at least two unique poll options) are provided.
  • API authentication errors: Confirm that the Evolution API credentials are correctly set up and valid.
  • Poll options constraints: Make sure there are between 2 and 12 unique options; duplicates or out-of-range counts may cause errors.
  • Network or API errors: Check network connectivity and Evolution API service status if requests fail unexpectedly.

Links and References

Discussion