Voicenter icon

Voicenter

Consume Voicenter API (v.0.1.7)

Actions10

Overview

This node integrates with the Voicenter API to initiate a "click-to-call" operation, which allows users to programmatically set up a call between two phone endpoints. The node dials a first destination ("phone") and then connects it to a second destination ("target"). This is useful in scenarios such as automated outbound calls, connecting customers to agents, or bridging calls between different phone systems or extensions.

Practical examples include:

  • Automatically calling a customer and then connecting them to a support agent.
  • Dialing internal extensions or external phone numbers based on business logic.
  • Setting up calls with custom caller IDs or recording options for compliance or quality assurance.

Properties

Name Meaning
Phone First destination to dial. Can be a phone number or an extension. Phone numbers should be in E164 format without the leading plus (+). Israeli numbers can also use 0********* format. Special values like "SIPTRUNK" or login code references are supported. Required.
Target Second destination to dial. Similar format rules as Phone. Required.
Additional Fields A collection of optional parameters to customize the call:
- Record: Whether to record the call (boolean).
- Phone Caller Id / Name: Caller ID and name for the first destination.
- Target Caller Id / Name: Caller ID and name for the second destination.
- Phone Max Dialtime: Max seconds to dial the first destination (default 60).
- Target Max Dialtime: Max seconds to dial the second destination (default 60).
- Max Duration: Maximum call duration in seconds (default 7200).
- Phone Auto Answer / Target Auto Answer: Auto answer flags for extensions.
- Check Phone/Target Device State: Block call if extension offline.
- Language: Language for system prompts (options: he, en, ru).
- Vm_id: Voicemail code for extensions.
Merge JSON parameters Boolean flag to enable merging additional JSON parameters into the request using lodash merge functionality.
JSON Raw JSON input to append or override parameters when "Merge JSON parameters" is enabled.

Output

The node outputs JSON data representing the result of the click-to-call operation. This typically includes details about the initiated call session, status, and any identifiers returned by the Voicenter API. The exact structure depends on the API response but generally contains information confirming the call setup success or failure.

No binary data output is indicated.

Dependencies

  • Requires an active connection to the Voicenter API via an API key credential configured in n8n.
  • Uses the Voicenter API client internally to perform operations.
  • No other external dependencies are required beyond the configured API access.

Troubleshooting

  • Invalid phone number format: Ensure phone and target numbers follow the expected E164 format without the plus sign, or valid extension codes as described.
  • Call blocked due to device state: If "Check Phone Device State" or "Check Target Device State" is enabled, calls may fail if the extension is offline.
  • Unsupported caller ID/name: Some providers may not support setting custom caller IDs or names; these fields might be ignored or cause errors.
  • API authentication errors: Verify that the API key credential is correctly configured and has necessary permissions.
  • Timeouts or max duration exceeded: Calls will terminate if they exceed specified max dial times or max duration; adjust these settings as needed.
  • Malformed JSON input: When using the JSON parameter merge option, ensure the JSON is valid to avoid parsing errors.

Links and References

Discussion