Actions7
Overview
This node integrates with the ClickSend API to send voice messages. It allows users to send a text message that will be converted into speech and delivered as a voice call to a specified phone number. This is useful for automated notifications, reminders, alerts, or any scenario where a spoken message is preferable over text.
For example, you could use this node to:
- Send appointment reminders via an automated voice call.
- Deliver urgent alerts or announcements to customers or employees.
- Provide voice-based customer support messages.
Properties
| Name | Meaning |
|---|---|
Recipient number / To field (to) |
The phone number to which the voice message will be sent. Can be local or international format. For international numbers, include the country code (e.g., +61411111111). |
Message body (body) |
The text content of the message that will be converted to speech and sent via voice call. |
Voice type (voice) |
The gender of the voice used to read the message. Options: Male, Female. |
Language (lang) |
The language code specifying the language in which the message should be read, ensuring correct pronunciation. |
Schedule (schedule) |
Optional date and time when the message should be sent. If not set, the message is sent immediately. |
Output
The node outputs a JSON array containing the response from the ClickSend API after attempting to send the voice message. The structure typically includes:
response_code: Status of the API request (e.g., "SUCCESS").data: Contains details such as the count of queued messages.messages: An array with individual message statuses.
If the message is successfully queued, the output confirms this. In case of errors like invalid recipient number or insufficient credit, the output contains an object with status and reason fields explaining the issue.
No binary data is output by this node.
Dependencies
- Requires an active ClickSend account with API access.
- Needs an API authentication token configured in n8n credentials to authorize requests to ClickSend.
- Internet connectivity to reach ClickSend's REST API endpoints.
Troubleshooting
- Invalid Recipient Number: If the output status is
"INVALID_RECIPIENT", verify that the phone number is correctly formatted, including the country code for international numbers. - Insufficient Credit: If the output status is
"INSUFFICIENT_CREDIT", ensure your ClickSend account has enough balance to send messages. - Scheduling Issues: When scheduling messages, ensure the date/time is valid and in the future; otherwise, the message may fail to send.
- API Authentication Errors: Confirm that the API key credential is correctly set up in n8n and has the necessary permissions.
- Network Errors: Check internet connectivity and firewall settings that might block access to ClickSend API endpoints.