3CX icon

3CX

Interact with 3CX telephony system

Actions462

Overview

This node integrates with the 3CX telephony system, specifically allowing users to create a new parking lot (a call parking space) within 3CX. Call parking is a telephony feature that lets users put calls on hold in a "parking spot" and retrieve them from another phone. This node's "Create Parking" operation enables automation of adding such parking spots programmatically.

Common scenarios include:

  • Automatically provisioning parking lots when setting up new departments or teams.
  • Managing call parking spaces dynamically based on business needs.
  • Integrating with other systems to synchronize telephony resources.

Example: A company wants to create a new parking lot with specific permissions and transcription settings whenever a new office location is added.

Properties

Name Meaning
Groups JSON array defining groups with their rights and tags associated with the parking lot.
Id Numeric identifier for the parking lot.
Number String representing the parking lot number or extension.
Transcription Mode Option to set transcription behavior: Nothing, Voicemail, Recordings, Both, or Inherit.

Output

The node outputs JSON data representing the created parking lot resource as returned by the 3CX API. This typically includes details such as the parking lot ID, number, group permissions, and transcription mode settings.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the 3CX telephony system.
  • The node expects the base URL of the 3CX server to be configured in credentials.
  • The node sends requests to the 3CX REST API endpoint /xapi/v1.

Troubleshooting

  • Authentication errors: Ensure the API key or OAuth2 token is valid and has sufficient permissions.
  • Invalid JSON in Groups property: The Groups input must be valid JSON; malformed JSON will cause request failures.
  • Duplicate or invalid parking lot Id or Number: The API may reject creation if the Id or Number already exists or is invalid.
  • Transcription Mode value issues: Use only the provided options; invalid values may cause errors.

Links and References

Discussion