Overview
This node enables sending voice messages through a Chat API by specifying a phone number, a URL to the voice message, and whether the message is a push-to-talk (PTT) type. It is useful in scenarios where automated voice notifications or audio messages need to be sent programmatically, such as customer support callbacks, appointment reminders, or alert systems.
For example, you can use this node to send a voice message containing an audio file hosted online to a user's phone number, optionally marking it as a PTT message for instant playback.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The recipient's phone number to which the voice message will be sent via the Chat API. |
| Voice URL | The URL pointing to the audio file that contains the voice message to be delivered. |
| PTT | A boolean flag indicating if the voice message should be treated as a push-to-talk (PTT) message. |
Output
The node outputs JSON data representing the response from the Chat API after attempting to send the voice message. This typically includes details about the message status, identifiers, or any error information returned by the API.
No binary data output is produced by this node.
Dependencies
- Requires an external Chat API service accessible via HTTP.
- Needs an API key credential for authentication with the Chat API.
- The node uses the Axios HTTP client library internally to make POST requests to the Chat API endpoint.
Troubleshooting
Common issues:
- Invalid or missing phone number format may cause the API to reject the request.
- Incorrect or inaccessible voice URL can result in failure to send the audio message.
- Missing or invalid API key will lead to authentication errors.
- Network connectivity problems can prevent successful API calls.
Error messages:
- Authentication failures usually indicate issues with the provided API key; verify the key and permissions.
- API response errors might include details about invalid parameters; check the phone number and voice URL values.
- If the node throws an error with item index information, it indicates which input item caused the failure, helping isolate problematic data.
To resolve errors, ensure all required properties are correctly set, the API key is valid, and the voice URL points to a reachable audio file.
Links and References
- Axios HTTP Client
- Documentation of the specific Chat API used (not provided here; refer to your Chat API provider’s official docs).