Actions37
- Message Actions
- Media Actions
- Contact Actions
- Group Actions
- Instance Actions
- Webhook Actions
Overview
This node integrates with the Uazapi WhatsApp API to send interactive list messages via WhatsApp. The "Send List" operation under the "Message" resource allows users to send a message containing a header text and a selectable list of items to a specified WhatsApp number. This is useful for scenarios where you want to present multiple options or menu-like choices to recipients, such as product catalogs, service menus, or quick navigation lists.
Practical examples:
- A restaurant sending a menu list to customers for easy ordering.
- A support bot providing a list of troubleshooting topics.
- An event organizer sharing a list of sessions or speakers for attendees to choose from.
Properties
| Name | Meaning |
|---|---|
| Phone Number | WhatsApp number of the recipient including country code (e.g., 5511999999999). |
| Message Text | The header text displayed at the top of the interactive list message. |
| List Items | Collection of list entries, each with: |
| - Title: The main title of the item. | |
| - Description: Additional details about the item. | |
| - ID: Unique identifier for the item (used internally to track selection). | |
| Additional Fields | Optional extra settings: |
| - Reply to Message ID: ID of a message to reply to (for threaded conversations). | |
| - Delay (seconds): Time delay before sending the message. | |
| - Disable Link Preview: Option to disable link previews in the message. | |
| - Mention Users: Comma-separated phone numbers to mention/tag in the message. |
Output
The node outputs a JSON object representing the response from the Uazapi WhatsApp API after attempting to send the list message. This typically includes status information, message IDs, or error details if the request failed.
If the operation succeeds, the output JSON confirms the message was sent and may include metadata about the sent message.
No binary data output is produced by this operation.
Dependencies
Requires an active Uazapi WhatsApp API account with valid credentials:
- API key credential
- API token
- Instance ID
- API base URL
The node uses these credentials to authenticate and send requests to the Uazapi API endpoints.
Proper configuration of these credentials within n8n is necessary for successful operation.
Troubleshooting
Common issues:
- Invalid or missing phone number format (must include country code).
- Empty or improperly formatted list items (each item must have a title and unique ID).
- Authentication errors due to incorrect API keys or tokens.
- Network connectivity issues preventing access to the Uazapi API endpoint.
Error messages:
- Errors returned from the API will be included in the output JSON under an
errorfield if the node is set to continue on fail. - Common API errors include unauthorized access, invalid parameters, or rate limiting.
- Errors returned from the API will be included in the output JSON under an
Resolutions:
- Verify phone numbers are correctly formatted.
- Ensure all required fields are filled.
- Check that API credentials are correct and have not expired.
- Confirm network access to the API endpoint.
- Use the "Reply to Message ID" only when replying to existing messages to avoid errors.
Links and References
- Uazapi Official Documentation (for detailed API usage and message formats)
- WhatsApp Interactive Messages Guide (general WhatsApp interactive message concepts)
This summary covers the static analysis of the "Send List" operation of the "Message" resource in the provided custom n8n node source code.