Actions6
- SMS Actions
- WhatsApp Actions
- Call Actions
Overview
This node enables making outbound calls and sending voice broadcasts through the Nvoip telephony platform. Specifically, the Send Interactive Voice Broadcast operation allows you to send an automated voice message that plays an initial greeting followed by options for the recipient to respond using their phone keypad (DTMF input). This is useful for scenarios such as customer surveys, appointment confirmations, or interactive notifications where you want to collect simple responses from call recipients.
For example, you can use this node to:
- Call customers with a prerecorded message and ask them to press 1 to confirm or 2 to reschedule.
- Deliver automated alerts that require acknowledgment via keypad input.
- Conduct quick polls or feedback collection over the phone without human intervention.
Properties
| Name | Meaning |
|---|---|
| Origin Number (Caller ID) | The phone number that will make the call. It must be enabled in your Nvoip account panel. |
| Destination Number | The phone number that will receive the call (e.g., 5511999999999). |
| Audio 1 | Text to be read aloud or a URL to an MP3 file for the initial greeting message. |
| Audio 2 | Text or audio URL containing the options for the recipient (e.g., "Press 1 for yes, 2 for no"). |
Output
The node outputs JSON data representing the response from the Nvoip API after attempting to initiate the interactive voice broadcast call. This typically includes details about the call request status, identifiers, or error messages if the request failed.
No binary data output is produced by this operation.
Example output structure (simplified):
{
"callId": "string",
"status": "string",
"message": "string"
}
Dependencies
- Requires an active Nvoip account with API access.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- The caller ID number must be pre-approved/enabled in the Nvoip panel.
- Internet access to reach Nvoip's REST API endpoints.
Troubleshooting
Common issues:
- Invalid or disabled caller ID number: Ensure the origin number is registered and enabled in your Nvoip account.
- Incorrect destination number format: Use full international format without spaces or special characters.
- Missing or invalid audio URLs: If providing MP3 URLs, ensure they are publicly accessible.
- No DTMF input detected: Verify the audio2 property clearly instructs the user on which keys to press.
Error messages:
"Unsupported operation": Occurs if the resource or operation parameters are incorrect or not implemented.- API authentication errors: Check that the API key/token credential is valid and has necessary permissions.
- Validation errors for missing required fields: Make sure all required properties (callerId, destination, audio1, audio2) are provided.
Resolving these usually involves verifying configuration values, ensuring proper formatting, and confirming API credentials.