Actions7
Overview
The Woztell node provides integration with the Woztell API, enabling users to send templated messages through various messaging channels such as WhatsApp or Facebook Messenger. Specifically, the Send Message Template operation under the Bot API resource allows sending pre-approved message templates to recipients identified by their phone numbers or platform-specific IDs.
This node is beneficial in scenarios where businesses want to automate customer communication using standardized message templates that comply with platform policies (e.g., WhatsApp Business API templates). Practical examples include sending appointment reminders, order confirmations, shipping updates, or promotional messages using predefined templates with dynamic content.
Properties
| Name | Meaning |
|---|---|
| Channel | The messaging channel in Woztell through which the message will be sent. Can be selected from a searchable list of available channels or specified by ID. |
| Recipient ID | The recipient's identifier in the integration, such as a WhatsApp phone number (including country code) or Facebook PSID. This identifies who will receive the message. |
| WABA Name or ID | The WhatsApp Business Account (WABA) name or ID associated with the message template. Selectable from a list depending on the chosen channel. |
| Template | The message template to send. Selectable from a searchable list of templates available for the chosen channel and WABA. |
| Language Name or ID | The language code for the template message. Selectable from a list of supported languages based on the chosen template. |
| Headers | Mapped header fields required by the template. These are additional structured data elements defined by the template, such as images or documents, mapped dynamically based on the selected template and language. |
| Variables | Mapped body variables for the template message. These represent dynamic text placeholders within the template that get replaced with actual values when sending the message. |
| Buttons | Mapped interactive buttons included in the template message. These can be call-to-action buttons or quick replies, configured according to the template's requirements. |
| Carousel | Mapped carousel cards for templates supporting carousel layouts. Each card can contain images, titles, subtitles, and buttons, allowing rich interactive messages. |
Output
The node outputs JSON data representing the response from the Woztell API after attempting to send the message template. This typically includes status information about the message delivery request, such as success confirmation, message IDs, or error details if the request failed.
If the node supports binary data output (not explicitly indicated here), it would generally relate to media attachments or message receipts, but this operation primarily deals with JSON responses confirming message dispatch.
Dependencies
- Requires an API key credential for authenticating requests to the Woztell API.
- Needs proper configuration of the base URL and authentication headers as per Woztell API specifications.
- Dependent on dynamic loading methods to fetch options for channels, templates, languages, and WABA info.
- Utilizes resource mappers to dynamically map headers, variables, buttons, and carousel cards based on the selected template and language.
Troubleshooting
Common Issues:
- Invalid or missing recipient ID format (e.g., phone number without country code) may cause message sending failures.
- Selecting a template incompatible with the chosen WABA or language can result in errors.
- Missing required header, variable, button, or carousel mappings may lead to incomplete or rejected messages.
- Network or authentication issues with the Woztell API can prevent message dispatch.
Error Messages:
- "Invalid recipient ID" — Ensure the recipient ID is correctly formatted and includes necessary country codes.
- "Template not found or unsupported language" — Verify that the selected template and language combination exists and is valid for the WABA.
- "Authentication failed" — Check that the API key credential is correctly configured and has sufficient permissions.
- "Missing required template parameters" — Confirm all required headers, variables, buttons, and carousel fields are properly mapped.
Resolving these usually involves verifying input property values, ensuring correct credentials, and consulting Woztell API documentation for template requirements.
Links and References
- Woztell API Documentation (general reference for API capabilities)
- n8n Expressions Documentation (for using expressions in property values)
- WhatsApp Business API Templates Guide (background on message templates)
Note: This summary is based solely on static analysis of the provided source code and property definitions without runtime execution or access to internal credential names.