Actions7
Overview
The node provides integration with the WOZTELL platform, specifically enabling sending responses through the Bot API. It allows users to send messages or structured responses to recipients on various messaging channels supported by WOZTELL, such as WhatsApp or Facebook Messenger.
Typical use cases include:
- Automating customer support replies by sending predefined or dynamic message content.
- Broadcasting notifications or alerts to specific users identified by their phone number or platform-specific ID.
- Integrating chatbot workflows where responses are constructed programmatically and sent via WOZTELL channels.
For example, a user can configure this node to send a JSON-formatted message response to a WhatsApp user by specifying the recipient's phone number and the channel through which the message should be delivered.
Properties
| Name | Meaning |
|---|---|
| Channel | The communication channel in WOZTELL through which the message will be sent. Can be selected from a searchable list of available channels or specified directly by ID. |
| Recipient ID (WhatsApp Phone Number or PSID) | The unique identifier of the message recipient within the integration. This could be a phone number (including country code) for WhatsApp or a Page Scoped ID (PSID) for Facebook Messenger. The input is sanitized to remove special characters and spaces before sending. |
| Responses | One or more response objects to send. Each response must be provided as a JSON object representing the message content or structure according to WOZTELL's Bot builder or integration documentation. Multiple responses can be sent in one execution. |
Output
The node outputs data in the json field containing the response from the WOZTELL API after attempting to send the message(s). This typically includes status information about the delivery or any errors returned by the API.
If binary data were involved (e.g., media files), it would be summarized here, but based on the provided code and properties, the node focuses on JSON message payloads only.
Dependencies
- Requires an API key credential for authenticating requests to the WOZTELL API.
- Needs access to WOZTELL channels configured in the user's WOZTELL account.
- The node uses the WOZTELL base URL and expects JSON content-type headers.
- No additional external dependencies beyond the WOZTELL API and its authentication.
Troubleshooting
- Invalid Recipient ID: If the recipient ID is malformed or missing country code (for phone numbers), messages may fail to send. Ensure the recipient ID is correctly formatted and sanitized.
- Channel Not Found: Selecting a non-existent or unauthorized channel will cause errors. Verify that the channel exists and the API credentials have permission to use it.
- Malformed Response JSON: The "Responses" property requires valid JSON. Invalid JSON syntax will cause request failures. Use proper JSON formatting and validate before sending.
- API Authentication Errors: Missing or incorrect API credentials will result in authentication failures. Confirm that the API key/token is correctly configured in n8n credentials.
- Rate Limits or Quotas: Sending too many messages in a short time might trigger rate limits. Check WOZTELL API documentation for limits and adjust usage accordingly.