Actions15
- Search Queues
- Query Queue Volumes
- Sample Conversations by Queue
- Voice Call Quality
- Conversation Sentiment
- Conversation Topics
- Conversation Transcript
- Enhanced Conversation Search
- Agent Media Type Performance
- Real Time Queue Status
- Real Time Agent Presence
- Live Conversation Monitoring
- Wrap Up Code Analytics
- Agent Status Monitoring
- Search Voice Conversations
Query Queue Volumes
AI-generatedOverview
This node integrates with Genesys Cloud MCP Plus, a comprehensive analytics platform for contact centers. It provides multiple operations to query and analyze various aspects of contact center data such as queue volumes, conversation samples, call quality, sentiment, agent performance, real-time statuses, and more.
The Query Queue Volumes operation specifically allows users to compare conversation volumes across multiple routing queues over a specified time period. This is useful for understanding workload distribution, identifying peak times, and optimizing resource allocation in contact centers.
Practical examples:
- A contact center manager wants to see how many conversations each queue handled last week to balance staffing.
- An analyst compares volume trends across support and sales queues to identify seasonal patterns.
- Operations teams monitor queue volumes during marketing campaigns to ensure adequate coverage.
Properties
| Name | Meaning |
|---|---|
| Queue IDs | Comma-separated list of queue IDs (maximum 300) to include in the volume comparison. |
| Start Date | The start date/time for the query period to analyze queue volumes from. |
| End Date | The end date/time for the query period to analyze queue volumes up to. |
Output
The output JSON contains the response from the Genesys Cloud MCP Plus service for the queue volume query. It typically includes aggregated conversation volume metrics per queue within the specified date range.
The exact structure depends on the external API but generally includes:
- Queue identifiers
- Volume counts or metrics for each queue
- Time-based breakdowns if supported by the API
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Genesys Cloud MCP Plus service.
- The node depends on the bundled
GenesysCloudMcpPlusServiceclass which handles communication with the external Genesys Cloud MCP Plus API. - Proper configuration of the API credentials in n8n is necessary before using this node.
Troubleshooting
- Invalid or missing queue IDs: Ensure that the "Queue IDs" property is provided as a comma-separated string with valid queue identifiers. The maximum allowed is 300.
- Date range errors: The "Start Date" must be earlier than the "End Date". Invalid or missing dates will cause the API call to fail.
- API authentication failures: Verify that the API key credential is correctly configured and has sufficient permissions.
- Network or service errors: Temporary connectivity issues or service outages may cause errors. Retrying after some time often resolves these.
- Error messages: If the node throws an error like
Operation queryQueueVolumes not supported, verify that the operation name is correct and supported by the node version.