Nvoip icon

Nvoip

Node for sending SMS via Nvoip

Actions6

Overview

The node enables making outbound calls and sending automated voice broadcasts using a telephony service. It supports three main call-related operations:

  • Make Call: Initiate a standard outbound phone call from a specified origin number to a destination number, optionally with call transfer.
  • Send Voice Broadcast: Send an automated voice message either as text-to-speech or by playing a public MP3 audio file to a destination number.
  • Send Interactive Voice Broadcast: Similar to voice broadcast but allows the recipient to respond via DTMF (keypad) input during the call.

This node is useful for automating voice communications such as appointment reminders, alerts, surveys, or marketing campaigns where you want to reach many recipients with pre-recorded or dynamically generated messages.

Practical Examples

  • A healthcare provider automatically calls patients to remind them of upcoming appointments using a voice broadcast.
  • A company runs an interactive survey by calling customers and letting them respond by pressing keys on their phone.
  • A business initiates a direct call to a customer service line with caller ID set to a verified number.

Properties

Name Meaning
Origin Number (Caller ID) The phone number that will make the call; must be enabled in the telephony service panel.
Destination Number The phone number to receive the call (e.g., 5511999999999).
Audio Content (Text or Public MP3 URL) Text to be spoken via TTS or a URL pointing to a publicly accessible MP3 audio file.

Output

The node outputs JSON data representing the response from the telephony API for each call or voice broadcast request. This typically includes details about the call or broadcast status, identifiers, and any error messages if applicable.

No binary data output is produced by this node.

Example output structure (simplified):

{
  "callId": "string",
  "status": "string",
  "message": "string"
}

Dependencies

  • Requires an API authentication token configured in n8n credentials to access the telephony service's REST API.
  • The telephony service must have the origin number (caller ID) enabled and authorized for use.
  • Internet access to send HTTP requests to the telephony service endpoints.

Troubleshooting

  • Common Issues:

    • Using an origin number not enabled in the telephony service panel will cause call failures.
    • Providing invalid or incorrectly formatted destination numbers may result in errors or failed calls.
    • If sending a voice broadcast with an audio URL, ensure the URL is publicly accessible without authentication.
    • For interactive voice broadcasts, incorrect DTMF configuration or timing may cause the interaction to fail.

  • Error Messages:

    • "Unsupported operation": Indicates the selected resource-operation combination is not implemented.
    • "Attempt to send an SMS/WhatsApp template ... but no variable was provided": Occurs when required template variables are missing (not relevant for this call operation).
    • API errors returned from the telephony service will be passed through; check the service documentation for specific error codes and resolutions.

Links and References

Discussion