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 download reports related to queue calls. The "Download Queue An Un Calls Report" operation under the "Report Queue An Un Calls" resource allows users to retrieve detailed call queue analytics based on specified parameters such as date, queue identifier, and time zone.

Typical use cases include:

  • Generating daily or periodic call queue performance reports.
  • Monitoring call wait times and queue statistics for customer support centers.
  • Integrating 3CX call data into broader business intelligence workflows.

For example, a user might configure this node to download a report for a specific queue on a given date, filtered by certain criteria, to analyze call handling efficiency.

Properties

Name Meaning
Chart Date The date for which the report chart data is requested (format expected as string).
Chart By The dimension or metric by which the chart data should be grouped or categorized.
Queue Dn Str The identifier string of the queue for which the report is generated.
Client Time Zone The time zone context to apply when interpreting date/time values in the report.
Wait Interval The interval duration used to segment wait times in the report.
Options Additional query options to refine the report data:
- Top Limit the number of items returned to the first n entries.
- Skip Skip the first n items in the result set.
- Search Search phrase(s) to filter items by text matching.
- Filter OData-style filter expression to restrict results by property values (e.g., State eq 'Connected').
- Count Boolean flag to include the total count of items in the response.
- Select Comma-separated list of properties to return for each item.
- Orderby Property names and directions to order the results (e.g., Name desc).
- Expand Related entities to expand inline in the response.

Output

The node outputs JSON data representing the downloaded queue call report. This JSON typically contains structured information about call queues, including metrics segmented by the specified charting parameters, wait intervals, and filtered according to the provided options.

If binary data output is supported (not explicitly shown in the source), it would represent downloadable report files such as CSV or PDF exports. However, based on the static code and properties, the primary output is JSON-formatted report data.

Dependencies

  • Requires an API key credential for authenticating with the 3CX telephony system's API.
  • The node uses a base URL configured from credentials, pointing to the 3CX server endpoint.
  • No other external dependencies are indicated in the provided source.

Troubleshooting

  • Invalid or missing required parameters: Ensure all required fields like Chart Date, Chart By, Queue Dn Str, Client Time Zone, and Wait Interval are provided and correctly formatted.
  • Authentication errors: Verify that the API key or OAuth2 token credential is valid and has sufficient permissions.
  • API endpoint issues: Confirm the 3CX server URL is correct and accessible from the n8n environment.
  • Query option syntax errors: When using advanced options like $filter or $orderby, ensure expressions follow the expected OData syntax to avoid request failures.
  • Empty or unexpected responses: Check if the specified queue or date range actually contains data; adjust filters or parameters accordingly.

Links and References

Discussion