Actions22
- Chat Actions
- Channel Actions
- Message Actions
- Contact Actions
- OTP Code Actions
- OTP Link Actions
Overview
This node allows sending a poll message to a WhatsApp contact via the CrunchzApp API. It is useful for scenarios where you want to gather feedback, conduct surveys, or engage users interactively by letting them vote on multiple-choice questions directly within WhatsApp conversations.
Practical examples include:
- Customer satisfaction surveys after support interactions.
- Quick opinion polls in marketing campaigns.
- Event planning with options for attendees to select preferences.
Properties
| Name | Meaning |
|---|---|
| Contact Id | The WhatsApp ID of the contact to whom the poll will be sent. |
| Title | The question or title of the poll that will be presented to the contact. |
| Options | A JSON array representing the list of possible answers/options for the poll. |
| Is Multiple Answer | Boolean flag indicating whether the poll allows selecting multiple answers (true/false). |
Output
The node outputs JSON data representing the response from the CrunchzApp API after sending the poll. This typically includes confirmation details such as message status, poll ID, or any metadata returned by the API about the sent poll.
No binary data output is involved.
Dependencies
- Requires an active CrunchzApp API key credential configured in n8n.
- Depends on the CrunchzApp API endpoint at
https://api.crunchz.app/api. - The node uses standard HTTP headers for JSON communication (
Accept: application/json,Content-Type: application/json).
Troubleshooting
- Invalid Contact Id: If the contact ID is incorrect or not registered on WhatsApp, the API may return an error. Verify the contact's WhatsApp ID format and existence.
- Malformed Options JSON: The "Options" property must be valid JSON. Errors parsing this field will cause failures. Ensure the JSON array is correctly formatted.
- API Authentication Errors: Missing or invalid API credentials will prevent sending messages. Confirm the CrunchzApp API key is properly set up in n8n credentials.
- Network Issues: Connectivity problems to the CrunchzApp API endpoint can cause timeouts or errors. Check network access and API availability.
- Multiple Answers Flag: Setting "Is Multiple Answer" incorrectly might affect poll behavior. Use
trueto allow multiple selections,falsefor single choice only.
Links and References
- CrunchzApp API Documentation (for detailed API usage and poll message formats)
- WhatsApp Business API Guide (general reference on WhatsApp messaging concepts)