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
Enhanced Conversation Search
AI-generatedOverview
The "Enhanced Conversation Search" operation in this node enables users to perform multi-media conversation searches within a specified date range. It allows filtering conversations by optional phone number and media types such as voice, chat, email, SMS, messaging, callback, social, and video. This operation is useful for contact center analytics where agents or supervisors want to retrieve and analyze conversations across different communication channels over a specific period.
Practical examples include:
- Searching all conversations involving a particular customer phone number during the last month.
- Filtering conversations that involved only chat and email media types between two dates.
- Conducting quality assurance reviews by retrieving multimedia interactions within a defined timeframe.
Properties
| Name | Meaning |
|---|---|
| Start Date | The start date and time for the query period (required). |
| End Date | The end date and time for the query period (required). |
| Phone Number | Optional phone number to filter conversations by a specific participant's number. |
| Media Types | Optional list of media types to filter conversations by. Possible values: Voice, Chat, Email, SMS, Messaging, Callback, Social, Video. |
Output
The output is a JSON object containing the results of the enhanced conversation search query. It includes details about conversations matching the specified filters such as date range, phone number, and media types. The exact structure depends on the external service response but typically includes conversation metadata and content summaries.
This node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Genesys Cloud MCP Plus service.
- The node depends on the
GenesysCloudMcpPlusServiceclass which handles communication with the external Genesys Cloud MCP Plus API. - Proper configuration of the API credentials in n8n is necessary for successful execution.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrect date formats or missing required date parameters may result in errors.
- Providing unsupported media types or malformed phone numbers could lead to empty or error responses.
- Network connectivity issues can prevent access to the external API.
Error messages:
"Operation enhancedConversationSearch not supported"indicates a misconfiguration or typo in the operation parameter.- Authentication errors usually mention invalid credentials or unauthorized access; verify API keys.
- Validation errors related to dates or parameters suggest checking input formats and required fields.
To resolve these issues, ensure all required properties are correctly set, credentials are valid, and network access to the API endpoint is available.