Actions148
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Files Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
Send messages → Send catalog product
AI-generatedOverview
This node enables sending WhatsApp messages through the WaliChat API, specifically supporting the operation to send a catalog product message. It is useful for businesses that want to share product information directly within WhatsApp chats, leveraging the WhatsApp Business catalog feature. Typical scenarios include e-commerce shops sending product details to customers, customer support sharing product options, or marketing teams promoting items via WhatsApp.
For example, a business can use this node to send a product from their WhatsApp catalog to a customer's phone number or group chat, optionally setting message priority, adding labels, or performing post-delivery chat actions like assigning the chat to an agent.
Properties
| Name | Meaning |
|---|---|
| WhatsApp number | The target WaliChat Number ID used to send the message. This identifies which WhatsApp number/account will deliver the message. |
| Target | Type of target chat: Phone (individual), Group, or Channel. |
| Phone Number | The recipient's phone number in international E.164 format (e.g., +1234567890). Required if Target is Phone. |
| Group ID | The ID of the target WhatsApp group chat (e.g., 12345678902401234@g.us). Required if Target is Group. |
| Channel ID | The ID of the target WhatsApp channel (e.g., 12345678902402200@newsletter). Required if Target is Channel. |
| Product ID | The ID of the product from the WhatsApp Business catalog to send. Must be 16-18 numeric characters. |
| Options | Collection of optional settings including: - Priority: Normal, High, Low - Label: Custom label to categorize the message - Reference ID: Custom reference for tracking - Team Agent: Send on behalf of an agent - Live mode: Real-time sending without queue - Delivery Queue Mode: How to enqueue/deliver the message - Maximum Retries: Number of delivery retries - Chat Actions: Post-delivery actions such as assign chat, resolve chat, add/remove/set labels, set/add/remove metadata |
| Message Expiration | Defines time-to-live (TTL) for the message with options: - Expire after seconds - Expire after duration (e.g., 1h) - Expire at specific date/time |
| Mark Chat as Read | Boolean to notify WhatsApp that previous unread messages are read after delivery (blue double-check). Requires WhatsApp read confirmation enabled. |
| Typing simulation | Seconds to simulate typing or recording status before sending (2-30 seconds). Set 0 to disable. |
| Quote Message | Message ID to quote when sending this message (must be in same conversation). |
| Strict Message Order | Boolean to ensure messages are sent in strict order. Useful for chatbots and sequences. Not compatible with live mode or never queue delivery. |
Output
The node outputs JSON data representing the result of the send product message operation. This typically includes message IDs, status, timestamps, and any relevant metadata returned by the WaliChat API confirming the message was sent or queued.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the WaliChat WhatsApp API.
- The node depends on WaliChat services for WhatsApp messaging, including access to WhatsApp Business catalogs.
- Some properties load dynamic options (e.g., devices, groups, channels, labels, team agents) via internal methods, requiring proper API permissions.
- Proper configuration of the WaliChat API key credential in n8n is necessary.
Troubleshooting
- Invalid phone number format: The phone number must be in E.164 format (e.g., +1234567890). Errors occur if the regex validation fails.
- Missing required fields: Ensure that depending on the target type, the corresponding field (phone, groupId, or channel) is provided.
- Product ID validation: Product ID must be numeric and between 16 and 18 characters; otherwise, the node will reject it.
- Live mode risks: Using real-time delivery mode ("live") for high-volume messaging may lead to WhatsApp bans due to rate limits.
- Strict order incompatibility: Enabling strict message order cannot be combined with live mode or "never queue" delivery options.
- Post-delivery actions require valid IDs: Assigning chats or departments requires valid 24-character hexadecimal IDs; invalid inputs cause errors.
- Read acknowledgment: Marking chat as read only works if WhatsApp privacy settings allow read receipts.
- Quoting messages: Quoted message IDs must be valid and belong to the same conversation; otherwise, quoting fails.