Voicenter icon

Voicenter

Consume Voicenter API (v.0.1.7)

Actions10

Overview

The node integrates with the Voicenter API to manage bulk call scheduling in a dialer system. Specifically, the addCallsBulk operation under the Dialer resource allows users to add multiple calls at once, each with detailed metadata and optional custom fields. This is useful for automating outbound call campaigns, such as telemarketing, customer support callbacks, or appointment reminders.

Practical examples include:

  • Scheduling a batch of calls for a marketing campaign identified by a unique campaign ID.
  • Setting priority levels to control the order in which calls are dialed.
  • Specifying caller ID numbers to display different phone numbers per call.
  • Adding custom data fields for use in call pop-ups or logs.
  • Scheduling calls to be dialed at a future time, respecting local or GMT time zones.
  • Overriding Do-Not-Call restrictions when necessary.

Properties

Name Meaning
Calls A collection of one or more call entries to add in bulk. Each entry includes:
  Campaign Unique identifier of the campaign (string), obtained from a campaign list method.
  Target Destination phone number to call, must include international prefix except for Israel destinations where it is optional.
  Additional Fields Optional extra fields for each call:
    Customer Name Name of the call target destination (string).
    Caller ID Phone number displayed to the call recipient; must be a number registered in your Voicenter account.
    Priority Numeric priority value; higher values cause the call to be dialed before lower ones.
    Custom Data User-defined key-value pairs associated with the call, usable for pop-up screens and call logs. Multiple custom properties can be added.
    Originate Time Epoch timestamp specifying when the call should be dialed in the future. If omitted, the call dials as soon as possible. Must be used together with "Is Date Local".
    Is Date Local Boolean indicating if the originate time is in local time (true) or GMT (false). Recommended to set true. Must be used together with "Originate Time".
    Ignore Dnc Status Boolean flag to override the Voicenter Do-Not-Call service restrictions, allowing calls to restricted Israeli destinations.

Output

The node outputs JSON data representing the result of the bulk call addition request. This typically includes information about the success or failure of adding each call, any assigned identifiers, and error messages if applicable.

If binary data were involved (not indicated here), it would represent files or media related to calls, but this operation focuses on JSON metadata only.

Dependencies

  • Requires an active Voicenter API credential with appropriate permissions to add calls.
  • The node uses the Voicenter API client internally to communicate with the service.
  • No additional external dependencies beyond the Voicenter API and its authentication.

Troubleshooting

  • Invalid Campaign ID: Ensure the campaign identifier matches one retrieved from the campaign list method; otherwise, calls may not be scheduled.
  • Incorrect Phone Number Format: Target numbers must include international prefixes unless calling Israeli numbers; invalid formats will cause errors.
  • Caller ID Not Registered: Caller ID numbers must exist in your Voicenter account; unregistered numbers will be rejected.
  • Originate Time Without Is Date Local: Both fields must be provided together; missing one causes scheduling failures.
  • Do-Not-Call Restrictions: If calls to certain destinations fail due to DNC rules, consider setting the Ignore Dnc Status flag if legally permissible.
  • API Credential Issues: Authentication failures indicate misconfigured or expired credentials; verify and update them accordingly.

Common error messages will relate to validation failures on these fields or authentication errors. Reviewing the API response details helps pinpoint issues.

Links and References

Discussion