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 operation allows forwarding an existing WhatsApp message from one chat to another using the Wassenger WhatsApp API. It is useful when you want to share or redirect a previously received or sent message to a different recipient without manually copying its content.
Common scenarios include:
- Customer support agents forwarding important messages to other team members or departments.
- Broadcasting a received message to multiple groups or channels.
- Archiving or referencing messages by forwarding them to a dedicated chat.
Example: Forward a customer inquiry message from a private chat to a group of supervisors for review.
Properties
| Name | Meaning |
|---|---|
| WhatsApp number | The target Wassenger Number ID used to send the forwarded message. This identifies the WhatsApp account/device sending the message. |
| Target | Type of target chat where the message will be forwarded. Options: Phone (individual), Group, Channel. |
| Phone Number | Target phone number in international E.164 format (e.g., +1234567890). Required if Target is "Phone". |
| Group ID | ID of the target group chat (e.g., 12345678902401234@g.us). Required if Target is "Group". |
| Channel ID | ID of the target channel (e.g., 12345678902402200@newsletter). Required if Target is "Channel". |
| Message ID to Forward | The unique ID of the message to forward (18-32 hexadecimal characters). |
| Source Chat ID | Optional source chat ID where the original message belongs (e.g., +1234567890 or 123456789012345@g.us). If not provided, the system attempts to discover it automatically. |
| Options | Collection of optional settings including: - Priority (Normal, High, Low) - Label (custom categorization label) - Reference ID (custom reference string) - Team Agent (send on behalf of an agent) - Live mode (real-time delivery without queue) - Delivery Queue Mode (default, always queue, never queue, opportunistic) - Maximum Retries (0-100) - Chat Actions (assign, resolve, label, metadata operations after delivery) |
| Message Expiration | Define time-to-live (TTL) for the forwarded message with options to expire after seconds, duration (e.g., 1h), or specific date/time. |
| Mark Chat as Read | Boolean to notify WhatsApp that previous unread messages in the chat are read after forwarding (blue double-check). Requires WhatsApp read confirmation enabled. |
| Typing simulation | Seconds (0-30) to simulate typing or recording status before forwarding the message. 0 disables this feature. |
| Quote Message | Message ID to quote when forwarding (must be in the same conversation). |
| Strict Message Order | Boolean to ensure strict order of messages sent to the target chat. Useful for chatbots and sequences. Not compatible with live mode or never queue delivery options. |
Output
The node outputs JSON data representing the result of the forward message operation. This typically includes details such as message IDs, status, timestamps, and any metadata returned by the Wassenger API confirming successful forwarding.
If binary data were involved (not applicable here), it would represent media files or attachments related to the message.
Dependencies
- Requires an active Wassenger WhatsApp API account with a valid API key credential configured in n8n.
- The node depends on the Wassenger API endpoints for sending and forwarding messages.
- Proper permissions and access to the specified WhatsApp number/device, groups, or channels.
- Optionally requires team agent IDs, labels, departments, and other entities pre-configured in Wassenger for advanced options.
Troubleshooting
- Invalid Message ID: Ensure the message ID to forward matches the required hexadecimal format and length (18-32 chars).
- Target Chat Not Found: Verify the phone number, group ID, or channel ID is correct and accessible by the selected WhatsApp number.
- Permission Denied: Check that the API key has rights to send messages on behalf of the chosen device and target.
- Delivery Failures: Adjust retry count and queue mode options; avoid real-time mode if sending many messages rapidly to prevent WhatsApp bans.
- Typing Simulation Issues: Use values between 2-30 seconds; 0 disables simulation.
- Read Acknowledgment Not Working: Confirm WhatsApp privacy settings allow read receipts.
- Strict Order Conflicts: Do not enable strict order with live mode or never queue options.