n8n-nodes-genesys-cloud-mcp-plus

An n8n community node that provides Genesys Cloud MCP Plus functionality for contact center analytics and automation workflows.

🚀 Features

This n8n node wraps the comprehensive Genesys Cloud MCP Plus toolkit, providing 15 powerful operations:

📊 Analytics Operations

• Search Queues - Find routing queues by name
• Query Queue Volumes - Get conversation volumes by queue
• Wrap-Up Code Analytics - Analyze interaction types and volumes
• Conversation Sentiment - Sentiment analysis for conversations
• Conversation Topics - Topic detection for conversations
• Conversation Transcript - Full conversation transcripts

⚡ Real-Time Operations

• Real-Time Queue Status - Live queue monitoring
• Real-Time Agent Presence - Agent availability tracking
• Live Conversation Monitoring - Active conversation tracking
• Agent Status Monitoring - Agent directory and status

🔍 Search Operations

• Enhanced Conversation Search - Multi-media conversation search
• Search Voice Conversations - Voice-specific conversation search
• Sample Conversations by Queue - Representative conversation samples

📈 Performance Operations

• Agent Media Type Performance - Agent performance by media type
• Voice Call Quality - Voice call quality metrics (MOS scores)

🛠️ Installation

For Self-Hosted n8n

1. Install the community node:

npm install n8n-nodes-genesys-cloud-mcp-plus

2. Restart your n8n instance

3. The "Genesys Cloud MCP Plus" node will be available in your node palette

⚙️ Configuration

1. Create Genesys Cloud Credentials

In n8n, create new credentials for "Genesys Cloud MCP Plus API":

• Region: Select your Genesys Cloud region
• OAuth Client ID: Your Genesys Cloud OAuth client ID
• OAuth Client Secret: Your Genesys Cloud OAuth client secret

2. Required OAuth Permissions

Your OAuth client needs these permissions:

• analytics:conversationAggregate:view
• analytics:conversationDetail:view
• routing:queue:view
• users:basic:view
• presence:read
• conversations:read

3. Supported Regions

• Americas (mypurecloud.com)
• EMEA (mypurecloud.de)
• Ireland (mypurecloud.ie)
• APAC (mypurecloud.com.au)
• Japan (mypurecloud.jp)
• EU Central (eu-central-1)

📋 Usage Examples

Example 1: Search for Queues

// Node Configuration
Operation: "Search Queues"
Queue Name: "Support*"
Page Size: 50

// Output
{
  "success": true,
  "data": [
    {
      "id": "queue-uuid-1",
      "name": "Support - English",
      "description": "English support queue",
      "memberCount": 5
    }
  ]
}

Example 2: Wrap-Up Code Analytics

// Node Configuration
Operation: "Wrap-Up Code Analytics"
Start Date: "2024-07-01T00:00:00Z"
End Date: "2024-07-13T23:59:59Z"

// Output
{
  "success": true,
  "data": [
    {
      "wrapUpCode": "resolved",
      "count": 145
    },
    {
      "wrapUpCode": "escalated",
      "count": 23
    }
  ]
}

Example 3: Real-Time Queue Status

// Node Configuration
Operation: "Real-Time Queue Status"
Queue IDs: "queue-uuid-1,queue-uuid-2"

// Output
{
  "success": true,
  "data": [
    {
      "queueId": "queue-uuid-1",
      "agentsOnQueue": 5,
      "agentsAvailable": 3,
      "interactionsWaiting": 2
    }
  ]
}

🔗 Workflow Integration

Common Workflow Patterns

1. Daily Analytics Report

   • Trigger: Schedule (daily)
   • Search Queues → Query Queue Volumes → Send Email

2. Real-Time Monitoring

   • Trigger: Schedule (every 5 minutes)
   • Real-Time Queue Status → IF (waiting > threshold) → Send Alert

3. Conversation Analysis

   • Trigger: Webhook
   • Enhanced Conversation Search → Conversation Sentiment → Store Results

📚 Documentation

• Original MCP Server: Genesys Cloud MCP Plus
• NPM Package: genesys-cloud-mcp-plus
• n8n Community Nodes: Official Documentation

👥 Contributors

• Original MCP Server: Lucas Woodward (MakingChatbots.com)
• n8n Community Node: Amr Khalil
• Enhancement: Transformed from 8 to 15 comprehensive tools

🤝 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• n8n Community: n8n Community Forum

📄 License

ISC License - see LICENSE for details.

🔗 Related Projects

• Original MCP Server: genesys-cloud-mcp-plus
• GitHub Repository: genesys-cloud-mcp-plus
• Cursor MCP Integration: Use with AI assistants for contact center analysis

Transform your contact center analytics with n8n automation! 🚀