3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node interacts with the 3CX telephony system, specifically allowing users to download a greeting file associated with a particular user. It is useful in scenarios where automated voice greetings or voicemail messages need to be retrieved programmatically from the 3CX system for backup, processing, or redistribution.

For example, a call center manager might use this node to automatically download and archive personalized greeting messages for each agent, or a developer could integrate it into a workflow that processes these audio files for transcription or analysis.

Properties

Name Meaning
User Id The unique identifier of the user whose greeting file you want to download. Usage format: userId={userId}. Must be a number.
File Name The name of the greeting file to download. Usage format: fileName={fileName}. Must be a string.

Output

The node outputs the downloaded greeting file data. This output typically includes:

  • A JSON structure containing metadata about the downloaded file.
  • Binary data representing the actual greeting audio file.

The binary data can be used downstream in workflows for saving to disk, sending via email, or further processing such as transcription.

Dependencies

  • Requires an API authentication token credential to connect securely to the 3CX system.
  • Needs the base URL of the 3CX server configured in the credentials.
  • The node sends requests to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Invalid User Id or File Name: If the specified user ID or file name does not exist, the node may return an error indicating the resource was not found. Verify the correctness of these inputs.
  • Authentication Errors: Failure to authenticate with the 3CX API will result in authorization errors. Ensure the API key or OAuth2 token is valid and has sufficient permissions.
  • Network Issues: Connectivity problems to the 3CX server can cause request failures. Check network access and server availability.
  • File Download Failures: If the file cannot be downloaded due to size limits or server restrictions, consider verifying server settings or splitting large files.

Links and References

Discussion