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
Overview
This node enables sending WhatsApp messages through the Wassenger API, specifically supporting the operation to send a product from a WhatsApp Business catalog. It is useful for businesses that want to automate sharing product information directly within WhatsApp chats, groups, or channels. For example, an e-commerce company can use this node to send detailed product cards to customers or sales groups, facilitating quick and interactive product promotion.
Properties
| Name | Meaning |
|---|---|
| WhatsApp number | The target Wassenger Number ID used to send the message. This identifies the WhatsApp account/device from which the message will be sent. |
| Target | Type of chat where the message will be sent. Options: Phone (individual chat), 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 group chat (e.g., 12345678902401234@g.us). Required if Target is "Group". |
| Channel ID | The ID of the target 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 a numeric string between 16 and 18 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: Send immediately without queue (riskier) - Delivery Queue Mode: Controls queuing behavior (default, always queue, never queue, opportunistic) - Maximum Retries: Number of delivery retries - Chat Actions: Post-delivery actions like assigning chat, resolving, labeling, metadata management |
| Message Expiration | Defines time-to-live (TTL) for the message with options to expire after seconds, duration (e.g., 1h), or at a specific date/time. |
| Mark Chat as Read | Boolean to notify WhatsApp that previous unread messages are read after delivery (blue double-check). Requires WhatsApp privacy settings to allow read receipts. |
| Typing simulation | Number of seconds (0-30) to simulate typing or recording status before sending the message. Useful for more natural interaction. |
| Quote Message | Message ID to quote when sending the product message, allowing referencing a previous message in the same conversation. |
| Strict Message Order | Boolean to ensure messages are sent in strict order. Useful for chatbots or sequences but incompatible with live mode or never queue delivery. |
Output
The node outputs JSON data representing the response from the Wassenger API after attempting to send the product message. This typically includes message identifiers, status, and any metadata returned by the API confirming the message was accepted or detailing errors.
No binary data output is expected from this operation.
Dependencies
- Requires an API key credential for authenticating with the Wassenger WhatsApp API.
- The node depends on the Wassenger service being accessible and properly configured.
- Some properties dynamically load options (e.g., devices, groups, channels, labels, team agents) via internal methods, implying network calls to Wassenger endpoints.
- Proper configuration of WhatsApp Business catalog and products is necessary to use the product sending feature.
Troubleshooting
- Invalid phone number format: Ensure phone numbers follow the E.164 format (e.g., +1234567890). The node validates this and will error if invalid.
- Product ID validation: Product IDs must be numeric strings between 16 and 18 characters. Errors occur if the format is incorrect.
- Delivery failures: Using real-time delivery mode ("live" or "never queue") for high-volume messaging may increase the risk of WhatsApp bans. Use queue modes appropriately.
- Missing required fields: Depending on the target type, ensure the correct ID (phone, group, or channel) is provided.
- Agent or department assignment errors: When using chat actions to assign chats, valid agent or department IDs must be supplied.
- Message quoting restrictions: Quoting only works for messages within the same conversation; otherwise, errors may occur.
- Read receipt limitations: Marking chat as read requires WhatsApp privacy settings to allow read confirmations.
- Strict order incompatibility: Enabling strict message order cannot be combined with live mode or never queue options.