Actions38
- Chatbot Actions
- Contact Actions
- Message Actions
- Panel Actions
- Sequence Actions
- Session Actions
Overview
The node integrates with the WTS Chat API to send text messages through various channels. Specifically, the Message - Send Text operation allows users to send plain text messages to a specified recipient number via a chosen communication channel. This is useful for automating outbound messaging workflows such as customer notifications, alerts, or chatbot interactions.
Typical use cases include:
- Sending personalized SMS or chat messages to customers.
- Triggering chatbot conversations by sending initial text messages.
- Integrating with CRM or support systems to notify users or contacts automatically.
For example, you could configure this node to send a welcome message to a new user signing up on your platform or to alert a sales team member about a new lead.
Properties
| Name | Meaning |
|---|---|
| Text | The actual text content of the message to be sent. |
| Bots Name or ID | Select a bot from the list or specify its ID to associate the message with a particular chatbot (optional). |
| Departments Name or ID | Choose a department from the list or specify its ID to route the message within an organizational unit (optional). |
| User Name or ID | Select a user within the chosen department to assign or associate the message with (optional; updates dynamically based on selected department). |
| From Name or ID | The channel (e.g., phone number, social media account) from which the message will be sent. |
| To | The recipient's phone number or username where the message will be delivered. |
| Send Synchronous Message | Boolean flag indicating whether the message should be sent synchronously (wait for confirmation before proceeding). |
| Enable Bot | Boolean flag to activate the chatbot upon receiving a response from the contact. |
| Hidden Session | Boolean flag to mark the session as hidden (affects visibility in the system). |
| Force Start Session | Boolean flag to force the start of a new session when sending the message. |
Output
The node outputs JSON data representing the result of the send message operation. This typically includes details such as message ID, status, timestamps, and any metadata returned by the WTS Chat API confirming the message was sent or queued.
If the operation succeeds, the output JSON contains the message object returned by the API. If there is an error, the node throws an error with descriptive information.
The node does not output binary data for this operation.
Dependencies
- Requires an API key credential for authenticating with the WTS Chat API.
- The node depends on the WTS Chat service endpoints accessible at
https://api.wts.chat. - Proper configuration of channels, bots, departments, and users in the WTS Chat system is necessary to use related properties effectively.
Troubleshooting
- Missing Required Fields: Errors occur if mandatory fields like "From" (channel), "To" (recipient number), or "Text" are empty or invalid. Ensure these are correctly filled.
- Invalid Channel or Bot IDs: Selecting undefined or invalid IDs for channels or bots will cause errors. Use the provided dropdowns or valid expressions.
- No Input Data for File Sending: Although not applicable for Send Text, other operations require input binary data for files. Make sure input data exists when sending files.
- API Key Issues: Authentication failures may happen if the API key credential is missing or incorrect.
- Empty or Whitespace Text: Sending empty or whitespace-only text messages is blocked with an error.
- Department/User Mismatch: When specifying a user by department, ensure the department is selected first to load the correct users.
Common error messages provide clear guidance, e.g., "Choose channel", "Set an Instagram number or username for sending", or "Write a text to send".