Evolution API icon

Evolution API

Interact with Evolution API

Overview

This node, part of the "Evolution API" integration, allows users to send a poll message through a messaging platform. Specifically, the "Send Poll" operation under the "Message" resource enables creating and dispatching a poll with multiple options to a specified recipient. This is useful for gathering quick feedback or opinions from contacts directly via messages.

Practical examples include:

  • Sending customer satisfaction surveys.
  • Conducting quick votes within a team chat.
  • Collecting preferences or choices in group conversations.

Properties

Name Meaning
Name Da Instância The name of the instance that will send the poll message.
Número Do Destinatário The recipient's number or identifier where the poll will be sent.
Titulo Da Enquete The title or caption of the poll message.
Opções Da Enquete The poll options to present (minimum 2, maximum 12). Each option must be unique.

Note: There is also a notice reminding that the poll must have at least 2 and at most 12 unique options.

Output

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

No binary data output is indicated.

Dependencies

  • Requires an API key credential for the Evolution API to authenticate requests.
  • The node uses the base URL https://doc.evolution-api.com/api-reference for API calls.
  • Proper configuration of the API credential in n8n is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Missing or incorrect instance name or recipient number can cause failures.
    • Providing fewer than 2 or more than 12 poll options, or duplicate options, may result in validation errors.
    • Network or authentication errors if the API key is invalid or missing.
  • Error messages:

    • "Operação não suportada." indicates the requested operation is not supported; ensure "Send Poll" is selected under the correct resource.
    • API errors related to invalid parameters usually stem from input property misconfiguration; verify all required fields are correctly filled.

To resolve errors, double-check all required inputs, ensure the API credential is valid, and confirm network connectivity.

Links and References

Discussion