3CX icon

3CX

Interact with 3CX telephony system

Actions462

Overview

This node integrates with the 3CX telephony system, specifically providing an operation to reset queue statistics. It is useful in scenarios where call center or telephony queue metrics need to be cleared or restarted, such as after a shift change or when troubleshooting queue performance issues. For example, a user might reset queue statistics at the start of a new business day to monitor fresh data.

Properties

Name Meaning
Id The unique identifier of the queue entity whose statistics are to be reset. This is a required numeric input and can be dynamically set using expressions like {{$json.Id}}.

Output

The node outputs JSON data representing the result of the reset operation on the specified queue. The exact structure depends on the 3CX API response but typically includes confirmation of the reset action or updated queue statistics. There is no indication that binary data is output by this node.

Dependencies

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

Troubleshooting

  • Common Issues:

    • Invalid or missing queue Id will cause the reset operation to fail.
    • Incorrect or expired API credentials will prevent successful authentication.
    • Network connectivity issues to the 3CX server can cause request failures.
  • Error Messages:

    • Authentication errors indicate problems with the provided API key or OAuth token; verify and update credentials.
    • "Entity not found" or similar errors suggest the provided queue Id does not exist; confirm the Id value.
    • Timeout or connection errors imply network issues; check server availability and firewall settings.

Links and References

Discussion