Actions64
- Instancia Actions
- Mensagem Actions
- Grupo Actions
- Chat Actions
- Perfil Actions
- Evento Actions
- Integração Actions
Overview
This node allows you to send a poll (enquete) message via the Evolution API. It is designed for scenarios where you want to interact with users by sending them a question with multiple selectable options through WhatsApp or another supported messaging platform. Typical use cases include customer feedback, quick surveys, or gathering group opinions in an automated workflow.
Example:
You could use this node to ask your customers which product feature they value most, or to quickly collect votes on a team decision.
Properties
Display Name | Type | Meaning |
---|---|---|
Nome Da Instância | string | The name of the instance that will send the poll. |
Número Do Destinatário | string | The recipient's phone number (JID format) who will receive the poll. |
Titulo Da Enquete | string | The title/question of your poll. |
Mínimo 2 opções, Máximo 12. Cada opção deve ser única. | notice | Informational notice: You must provide between 2 and 12 unique options for the poll. |
Opções Da Enquete | fixedCollection | The list of poll options. Each option must be unique; minimum 2, maximum 12. |
Opção | string | The text for each individual poll option. |
Output
The output will be a JSON object (or array of objects) representing the result of the poll-sending operation. While the exact structure depends on the Evolution API response, it typically includes:
- status: Indicates if the poll was sent successfully.
- messageId: Unique identifier for the sent poll message.
- to: The recipient's number.
- pollDetails: Information about the poll (title, options, etc.).
{
"status": "success",
"messageId": "abc123xyz",
"to": "5511999999999@s.whatsapp.net",
"pollDetails": {
"caption": "Qual seu produto favorito?",
"options": ["Produto A", "Produto B", "Produto C"]
}
}
Note: The actual fields may vary depending on the API's response.
If binary data is returned (unlikely for this operation), it would represent file attachments or media related to the poll.
Dependencies
- External Service: Requires access to the Evolution API.
- API Key/Credentials: You must configure valid Evolution API credentials in n8n under the name
evolutionApi
. - n8n Configuration: No special environment variables are required beyond standard credential setup.
Troubleshooting
Common Issues:
- Missing or Invalid Credentials: Ensure your Evolution API credentials are correctly set up in n8n.
- Insufficient Poll Options: If you provide fewer than 2 or more than 12 options, or duplicate options, the node may fail.
- Invalid Recipient Number: Make sure the recipient's number is in the correct JID format.
Error Messages:
"Operação não suportada."
This means the selected operation is not implemented for the chosen resource. Double-check that you have selected "Enviar Enquete" for the "Mensagem" resource.- API Errors:
Any errors from the Evolution API (such as invalid parameters or network issues) will be passed through and shown in the node's error output.
Links and References
Tip: Always test your poll with a small group before sending it to a larger audience to ensure everything works as expected!