Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

The node provides an interface to send a poll message via the Evolution API messaging service. It allows users to create interactive polls by specifying a title and multiple unique options, which are then sent to a specified recipient number from a chosen instance.

This node is useful in scenarios such as:

  • Conducting quick surveys or votes within chat groups.
  • Gathering feedback or preferences from participants in a conversation.
  • Engaging users interactively by sending polls directly through messaging platforms.

For example, a marketing team could use this node to send a poll asking customers to choose their favorite product feature, or a community manager might gather opinions on event dates.

Properties

Name Meaning
Instance Name The name of the instance that will send the poll message.
Recipient Number The phone number or identifier of the message recipient (e.g., group or individual chat ID).
Poll Title The title or question of the poll being sent.
Poll Options A collection of unique options for the poll; minimum 2 and maximum 12 options can be provided.
Delay Optional delay in milliseconds before sending the poll message.
Reply to Message Optionally specify a message ID to which this poll message should reply.
Mentions Settings to mention participants: either mention everyone or specify a comma-separated list of numbers.

Output

The node outputs a JSON array containing the response from the Evolution API after sending the poll. This typically includes confirmation details about the sent poll message, such as message IDs or status indicators.

If binary data were involved (not indicated here), it would represent media attachments or similar content related to the poll message.

Dependencies

  • Requires an active Evolution API credential configured in n8n to authenticate requests.
  • Depends on the Evolution API service endpoint at https://doc.evolution-api.com/api-reference.
  • The node uses standard HTTP headers for JSON communication (Accept and Content-Type set to application/json).

Troubleshooting

  • Unsupported operation error: If the node throws an error indicating the operation is unsupported, verify that the resource is set to "messages-api" and the operation to "send-poll".
  • Missing required fields: Ensure all required properties like Instance Name, Recipient Number, Poll Title, and at least two unique Poll Options are provided.
  • API authentication errors: Confirm that the API key or authentication token is correctly configured in the node credentials.
  • Invalid recipient number: Check the format of the recipient number to match the expected format by the Evolution API.
  • Duplicate poll options: The poll options must be unique; duplicates may cause the API to reject the request.

Links and References

Discussion