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 text message
AI-generatedOverview
This node enables sending text messages via the WaliChat WhatsApp API. It supports sending messages to individual phone numbers, groups, or channels associated with a selected WaliChat number (device). The node is useful for automating WhatsApp communications such as customer support replies, marketing broadcasts, notifications, or chatbot interactions.
Practical examples include:
- Sending appointment reminders to customers by phone number.
- Broadcasting announcements to a WhatsApp group or channel.
- Automating chat responses with typing simulation and message quoting.
- Managing message delivery priority and retries for reliable communication.
Properties
| Name | Meaning |
|---|---|
| WhatsApp number | The target WaliChat Number ID used to send the message. This identifies the WhatsApp account/device from which the message will be sent. |
| Target | Type of target chat: Phone (individual number), Group, or Channel. Determines where the message will be delivered. |
| Phone Number | Target phone number in international E.164 format (e.g., +1234567890). Required if Target is Phone. |
| Group ID | ID of the target WhatsApp group chat (e.g., 12345678902401234@g.us). Required if Target is Group. |
| Channel ID | ID of the target WhatsApp channel (e.g., 12345678902402200@newsletter). Required if Target is Channel. |
| Message | Text content of the message to be sent (up to 6000 characters). |
| Options | Collection of optional settings including: - Priority: Normal, High, Low - Label: Custom label to categorize the message - Reference ID: Custom reference string - Team Agent: Send on behalf of an agent - Live mode: Real-time sending without queue - Delivery Queue Mode: Default, Always Queue, Never Queue, Opportunistic - Maximum Retries: Number of retry attempts - Chat Actions: Post-delivery actions like assign chat, resolve, add/remove labels, set metadata, etc. |
| Message Expiration | Defines time-to-live (TTL) for the message using seconds, duration (e.g., "1h"), or specific date/time. |
| Mark Chat as Read | Boolean to notify WhatsApp that previous unread messages are read after this message is delivered (blue double-check). |
| Typing simulation | Seconds to simulate typing or recording status before sending (0 disables). Useful for more natural interaction. |
| Quote Message | Message ID to quote when sending this message (must be in the same conversation). |
| Strict Message Order | Boolean to enforce strict order of messages sent to the target chat. Not compatible with live mode or never queue options. Useful for chatbots or sequences. |
Output
The node outputs JSON data representing the result of the message sending operation. This typically includes details about the sent message such as message ID, status, timestamps, and any relevant metadata returned by the WaliChat API.
If binary data were involved (not applicable here), it would represent media files or attachments, but this operation focuses on text messages only.
Dependencies
- Requires a valid API key credential for authenticating with the WaliChat WhatsApp API.
- The node depends on WaliChat services for device management, group/channel info, team agents, labels, departments, and message delivery.
- Proper configuration of the WaliChat account and permissions is necessary to send messages and perform post-delivery chat actions.
Troubleshooting
- Invalid phone number format: Ensure phone numbers follow the E.164 format (e.g., +1234567890). The node validates this and will error if incorrect.
- Missing required fields: Depending on the target type, ensure the correct ID or phone number is provided.
- Delivery failures: If messages fail to send, check the delivery queue mode and retry settings. Avoid using real-time mode for high-volume sends to reduce risk of WhatsApp bans.
- Agent or department IDs invalid: When assigning chats or performing actions, ensure agent and department IDs are valid 24-character hexadecimal strings.
- Message quoting errors: Quoted message IDs must be valid and belong to the same conversation.
- Strict order conflicts: Using strict message order with live mode or never queue options is incompatible and may cause errors.
- API authentication issues: Verify the API key credential is correctly configured and has sufficient permissions.