3CX icon

3CX

Interact with 3CX telephony system

Actions462

Overview

This node integrates with the 3CX telephony system, specifically providing functionality to retrieve parking information by a phone number. It is useful in scenarios where you need to query parking details associated with a specific international phone number, such as managing call parking or retrieving parked call data in a telephony environment.

A practical example would be an automated workflow that, upon receiving a phone number, fetches the corresponding parking slot or call parking details from the 3CX system to display or process further.

Properties

Name Meaning
Number Phone number in international format (e.g., +1234567890). This is the key identifier used to retrieve parking information associated with this number.

Output

The node outputs JSON data containing the parking information related to the provided phone number. The exact structure depends on the 3CX API response but typically includes details about the parking slot or call parked under that number.

If the node supports binary data output, it would generally relate to any media or recordings associated with the parked call, but this is not explicitly indicated in the provided code snippet.

Dependencies

  • Requires connection to a 3CX telephony system via its API.
  • Needs an API authentication token configured through OAuth2 credentials for secure access.
  • The base URL for the 3CX server must be set in the node's credentials configuration.
  • The node sends requests with Accept: application/json header and targets the /xapi/v1 endpoint of the 3CX API.

Troubleshooting

  • Common Issues:

    • Incorrect or missing phone number format can cause the API to return errors or no data.
    • Invalid or expired API authentication tokens will result in authorization errors.
    • Misconfigured server URL or network issues may prevent successful API calls.
  • Error Messages:

    • Authorization errors typically indicate problems with the OAuth2 credentials; re-authenticate or update credentials.
    • "Not Found" or empty responses suggest the phone number does not correspond to any parked call.
    • Network timeouts or connection errors require checking server availability and network settings.

Links and References

Discussion