Actions7
Overview
The Woztell node provides integration with the Woztell API, enabling communication and interaction through messaging channels such as WhatsApp or Facebook Messenger. Specifically, the Send Responses operation under the Bot API resource allows users to send structured response messages to recipients identified by their platform-specific IDs (e.g., WhatsApp phone numbers or Facebook PSIDs).
This node is beneficial in scenarios where automated or programmatic messaging is required, such as:
- Sending notifications or alerts to customers via WhatsApp.
- Responding to user queries automatically in a chatbot environment.
- Delivering personalized messages based on workflow logic.
For example, a business could use this node to send order status updates directly to a customer's WhatsApp number or reply to Facebook Messenger users with dynamic content generated from other systems.
Properties
| Name | Meaning |
|---|---|
| Channel | The messaging channel in Woztell through which the message will be sent. Can be selected from a list of available channels or specified by ID. |
| Recipient ID (WhatsApp Phone Number or PSID) | The unique identifier of the message recipient within the integration platform. For WhatsApp, this is the phone number including country code; for Facebook, it is the PSID. Formatting removes special characters and spaces automatically. |
| Responses | One or more response objects to send. Each response must be provided as a JSON object representing the message content and structure according to the 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 sending the messages. This typically includes confirmation details such as message IDs, status, timestamps, or error information if the request failed.
If binary data were involved (e.g., media files), it would be summarized here, but this operation focuses on JSON-based message payloads only.
Dependencies
- Requires an active Woztell API credential configured in n8n, which includes necessary authentication tokens or API keys.
- The node depends on the Woztell API endpoint at the base URL defined internally.
- The "Channel" property relies on the ability to search or specify valid channels within the Woztell system.
- Proper formatting of recipient IDs is essential, especially phone numbers requiring country codes without special characters.
Troubleshooting
- Invalid Recipient ID: If the recipient ID is malformed or missing country code, messages may fail to send. Ensure phone numbers are entered correctly and PSIDs are valid.
- Channel Not Found: Selecting a non-existent or unauthorized channel will cause errors. Use the channel search feature or verify channel IDs beforehand.
- Malformed Response JSON: The "Responses" property requires valid JSON objects. Syntax errors or invalid structures will result in API rejections.
- Authentication Errors: Missing or incorrect API credentials will prevent successful requests. Verify that the Woztell API credential is properly set up in n8n.
- API Rate Limits or Quotas: Excessive messaging might trigger rate limits. Monitor usage and handle errors accordingly.
Links and References
- Woztell Official Documentation — For detailed API references and message format specifications.
- WhatsApp Business API Guidelines — For understanding recipient ID formats and messaging rules.
- Facebook Messenger Platform — For PSID and message structure details.