BulkVS

Interact with BulkVS API for bulk calling and SMS
Join our community

Actions5

Overview

This node integrates with the BulkVS API to perform bulk calling operations. Specifically, the 'Make Bulk Call' operation allows users to initiate automated calls to multiple phone numbers simultaneously. Users can choose to play an audio file from a URL or convert a text message to speech during the call. The node supports setting caller ID, call timeout, and retry attempts for failed calls. This is useful for scenarios like automated notifications, reminders, or marketing campaigns where reaching many recipients via phone calls is required.

Use Case Examples

  1. Calling a list of customers with a prerecorded message hosted at a URL.
  2. Sending an automated voice message converted from text to multiple phone numbers with retry attempts for failed calls.

Properties

Name Meaning
Phone Numbers Comma-separated list of phone numbers to call, including country code, required for bulk calling.
Audio Source Selects the audio source for the call, either an audio file URL or text to speech.
Audio File URL URL to the audio file (MP3, WAV supported) to be played during the call, required if Audio Source is URL.
Text Message Text to be converted to speech for the call, required if Audio Source is Text to Speech.
Caller ID Phone number to display as the caller ID during the call.
Call Timeout (seconds) Maximum duration of the call in seconds.
Retry Attempts Number of retry attempts for calls that fail.

Output

JSON

  • results - Array of call results, each containing the phone number, status (success or error), call ID if successful, and response or error message.
  • summary
    • total - Total number of phone numbers called.
    • successful - Number of successful calls.

Dependencies

  • Requires BulkVS API credentials for authentication to make API requests.

Troubleshooting

  • Common issues include invalid phone numbers, incorrect audio URL or unsupported audio format, and API authentication failures.
  • Error messages from the API are returned in the output with the error field for each failed call.
  • Ensure phone numbers include country codes and are correctly formatted.
  • Verify the audio file URL is accessible and in a supported format (MP3 or WAV).
  • Check that the BulkVS API credentials are correctly configured and valid.

Links

  • BulkVS API Documentation - Official API documentation for BulkVS, useful for understanding API endpoints and parameters.

Discussion