3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node interacts with the 3CX telephony system, specifically providing functionality to purge call records based on a specified period. It is useful for administrators or users who want to clean up or manage call data within their 3CX system by removing calls older than a certain timeframe or matching specific criteria.

A practical example would be automating the cleanup of call logs older than 30 days to maintain system performance and storage efficiency.

Properties

Name Meaning
Period A JSON object defining the time period or criteria for purging calls. The user inputs this as a JSON string, which is parsed and sent in the request body.

Output

The node outputs JSON data representing the result of the purge operation. This typically includes confirmation of the purge action, such as the number of calls deleted or status messages from the 3CX API. There is no indication that binary data is output.

Dependencies

  • Requires an API key credential for authenticating with 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 JSON in Period property: Since the Period input expects a JSON string that is parsed, invalid JSON will cause errors. Ensure the JSON syntax is correct.
  • Authentication errors: If the API key or server URL is incorrect or missing, the node will fail to authenticate. Verify credentials are properly set.
  • API endpoint issues: If the 3CX server URL is incorrect or unreachable, requests will fail. Confirm network connectivity and server address.
  • Empty or incorrect Period criteria: Providing an empty or improperly structured period object may result in no calls being purged or unexpected behavior. Validate the period structure according to 3CX API documentation.

Links and References

Discussion