3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node operation updates the Call Parking Settings in a 3CX telephony system. Call parking is a feature that allows users to put a call on hold at one phone and continue the conversation from any other phone within the system. This operation lets you configure how parked calls behave, including automatic pickup options, forwarding rules, timeouts, maximum number of parked calls, and music played while calls are on hold.

Practical scenarios include:

  • Automatically picking up parked calls after a timeout.
  • Forwarding parked calls to specific destinations such as another extension, voicemail, or an external number.
  • Limiting the number of calls that can be parked simultaneously.
  • Customizing the music played to callers waiting on hold.

This operation is useful for administrators managing call flow and ensuring efficient handling of parked calls in a business phone system.

Properties

Name Meaning
Auto Pickup Enabled Enables or disables automatic pickup of parked calls (true/false).
Auto Pickup Forward DN The destination number (DN) to forward the call to if auto pickup forwarding type is DN.
Auto Pickup Forward External Number The external phone number to forward the call to if auto pickup forwarding type is External Number.
Auto Pickup Forward Type The method used to forward the call when auto pickup is triggered. Options: Transfer Back, DN, Extension Voice Mail, External Number, Route Point.
Auto Pickup Timeout Time in seconds before the system automatically picks up a parked call.
Maximum Parked Calls The maximum number of calls that can be parked simultaneously.
Music On Hold Identifier or name of the music on hold to play to parked calls.

Output

The node outputs JSON data reflecting the updated call parking settings as returned by the 3CX API. This typically includes confirmation of the new configuration values set for the call parking feature.

No binary data output is involved in this operation.

Dependencies

  • Requires connection to a 3CX telephony system with appropriate API access.
  • Needs an API authentication token or OAuth2 credential configured in n8n to authorize requests.
  • The base URL for the 3CX server must be provided in the credentials.
  • The node sends HTTP requests to the 3CX API endpoint /xapi/v1 to update settings.

Troubleshooting

  • Invalid Credentials or Unauthorized Access: Ensure the API key or OAuth2 token is valid and has permissions to modify call parking settings.
  • Incorrect Property Values: Verify that numeric fields like timeouts and maximum parked calls are non-negative integers.
  • Forwarding Destination Errors: If forwarding type is set to DN or External Number, ensure the corresponding forwarding number is correctly specified.
  • Server URL Issues: Confirm the 3CX server URL is correct and reachable from the n8n instance.
  • API Endpoint Changes: If the 3CX API version changes, verify compatibility with the node's request structure.

Links and References

Discussion