Actions7
Overview
The "Send Message Template" operation in the Bot API resource of this WOZTELL node allows users to send pre-defined message templates through various messaging channels (e.g., WhatsApp, Facebook Messenger). This is particularly useful for automating customer communication with consistent, approved message formats such as notifications, alerts, or marketing messages.
Typical use cases include:
- Sending appointment reminders via WhatsApp using a template.
- Delivering order status updates on Facebook Messenger with buttons and interactive elements.
- Broadcasting promotional messages with localized language support and dynamic content variables.
This operation supports rich message templates including headers, body variables, buttons, and carousel cards, enabling highly customizable and interactive messaging experiences.
Properties
| Name | Meaning |
|---|---|
| Channel | The messaging channel in WOZTELL where the message will be sent. Options include selecting from a searchable list of available channels or specifying a channel ID directly. |
| 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 used to send the template message. It can be selected from a list or specified via an expression. |
| Template | The message template to send. Selected from a searchable list of available templates configured in WOZTELL. |
| Language Name or ID | The language code for the template message, chosen from a list dependent on the selected template. This ensures the message is sent in the correct language variant. |
| Headers | Mapped header fields for the template message. These are additional structured data fields defined by the template that can be dynamically set per message. |
| Variables | Mapped body variables for the template message. These replace placeholders in the template body with dynamic content specific to each message instance. |
| Buttons | Mapped button elements for the template message. These allow adding interactive buttons as defined by the template, such as quick replies or URL buttons. |
| Carousel | Mapped carousel cards for the template message. This enables sending multiple card-like items within a single message, each potentially containing images, titles, and buttons, as supported by the template. |
Output
The node outputs JSON data representing the response from the WOZTELL API after attempting to send the message template. This typically includes confirmation details such as message IDs, status, timestamps, or error information if the send failed.
If the message involves media or attachments, binary data output is not indicated here, so the output focuses on JSON metadata about the message transaction.
Dependencies
- Requires an API key credential for authenticating with the WOZTELL API.
- Needs proper configuration of WOZTELL channels, WhatsApp Business Accounts, and message templates in the WOZTELL platform.
- The node uses internal methods to load options dynamically (channels, templates, languages, WABA info) which depend on the WOZTELL backend services.
- Network access to the WOZTELL API endpoint is necessary.
Troubleshooting
- Invalid Recipient ID: Ensure the recipient ID is correctly formatted without special characters and includes country codes for phone numbers.
- Missing Required Fields: All required properties like Channel, Recipient ID, WABA ID, Template, and Language must be provided; otherwise, the API call will fail.
- Template Not Found or Unsupported Language: If the selected template or language is invalid or not available for the WABA, the message will not send.
- API Authentication Errors: Verify that the API key credential is valid and has sufficient permissions.
- Dynamic Mapping Issues: Incorrectly mapped headers, variables, buttons, or carousel fields may cause the API to reject the message. Double-check mappings against the template definition.
- Network or API Downtime: Temporary connectivity issues with WOZTELL API can cause failures; retry later or check WOZTELL service status.