Release Notes

Release Notes

 
Customer Science releases regular updates to our Genesys Adapter and associated CXiaaS offerings.

Please review to understand our current releases:
June 2025

June 2025

June 17, 2025 — Version 3.48.0

Improvements

  • Enhance Token Refresh Logic for Broader Rate Limits
    Enhanced token refresh logic to accommodate broader rate limiting scenarios.
    (Merged PR #403)

  • Optimise Diffing and Centralize Flow Processing
    Optimised diffing logic, centralized flow processing, and expanded logging coverage for improved maintainability.
    (Merged PR #403)

  • Simplify Flow Outcome Status Logging
    Simplified flow outcome status logging to reduce noise and improve clarity in logs.
    (Merged PR #403)

  • Replace Console Outputs with Structured Logging
    Replaced console outputs with structured logging for better observability and integration with log monitoring systems.
    (Merged PR #403)

Bug Fixes

  1. Refactor API Error Logging and Improve Contact List Logging
    Refactored API error logging and improved contact list logging for better traceability and debugging.
    (Merged PR #403)
  1. Remove Redundant UTC Conversions and Clean Up Date Handling
    Removed redundant UTC conversions and cleaned up inconsistent date handling throughout the codebase.
    (Merged PR #403)

June 13, 2025 — Version 3.47.3

Improvements

  • Improve Code Efficiencies for Contact List Processing
    Improved Contact List processing efficiency  by skipping download preparation of empty lists and removing the filtering on the modification date
    (Merged PR #400)

June 12, 2025 — Version 3.47.2

Improvements

  • ODContactLists Job Enhancement
    Improved stability and data coverage in the ODContactLists job by refining polling logic and extending timeout parameters.
    (Merged PR #386)

  • Fix Survey Empty Response Handling and Improve Rate Limiting
    Added defensive logic to handle empty responses from survey endpoints and strengthened rate limit retry behavior.
    (Merged PR #390)

  • Add Indexes to Enhance Query Performance
    Introduced indexes on several key columns across multiple tables to significantly improve query performance and reduce load on the database.
    (Merged PR #392)

June 4, 2025 — Version 3.47.1

Features

  1. Optimise Learning Module Assignment Retrieval
    Enhanced the retrieval logic for learning module assignments by implementing a comprehensive user-module mapping for efficiency.
    (Merged PR #371)

  1. Async Initialisation and Token Caching for Authentication
    Implemented asynchronous initialisation and token caching to prevent redundant concurrent requests and improve API performance.
    (Merged PR #360)
  2. Support Schedule Details Synchronisation
    Introduced support for synchronising schedule details data from the Genesys API.
    (Merged PR #373)

Improvements

  1. Comprehensive Enhancements to Error Handling, Logging, and API Job Management
    Refactored the GenesysJobManager to support adaptive polling, ISO-8601 granularity, and better retry logic. Added asynchronous job handling, structured logging, and robust HTTP error recovery.
    (Merged PR #369)
  2. Eliminate Data Skipping with Retry Logic
    Addressed issues with skipped data by implementing robust retry logic to enhance reliability.
    (Merged PR #370)
  3. Enhanced Rate Limit Handling and Logging for Async APIs
    Converted synchronous methods to async, improved timeout and logging mechanisms, and applied temporary fixes to avoid file locking issues.
    (Merged PR #370)
  4. Improve API Interaction and Logging Granularity
    Refined windowed data retrieval, added detailed user presence logging, and enforced strict ISO-8601 time granularity.
    (Merged PR #369)
  5. Optimize Voice Analysis and Queue Observation Handling
    Standardised participant metrics, avoided sync date updates on batch failure, and resolved DataTable mismatches. Enhanced user filtering and default search configurations.
    (Merged PR #360)

  1. Improve Survey Data Handling and Logging
    Improved logging and error handling mechanisms for survey data ingestion.
    (Merged PR #373)

  2. Enhance Logging and JSON Parsing for API Pagination
    Enhanced JSON parsing, pagination logic, and logging around API interactions.
    (Merged PR #373)

  3. Update Database Schemas and Add Column Checks
    Added column existence checks before updates.
    Expanded support for dynamic schema updates.
    (Merged PR #373)

  4. Improve JSON Status Code Handling
    Enhanced robustness of API responses by better parsing and handling of HTTP status codes.
    (Merged PR #387)

  5. Make Date Handling Culture-Invariant
    Ensured all date conversions use invariant culture to prevent region-based parsing errors.

    (Merged PR #387)

Bug Fixes

  1. Fix Voice Analysis Field Handling
    Resolved issues with column mismatch and sync date behavior in the voice analysis pipeline.
    (Merged PR #360)
  2. Prevent Duplicate Transcript Processing
    Ensured transcripts are not processed more than once and improved associated logging.
    (Merged PR #360)
  3. Fix for Empty Predicate API Errors
    Handled empty predicates gracefully to prevent API call failures.
    (Merged PR #360)

  1. Restore Backward Compatibility for SQL Data Access
    Fixed compatibility issues in GetSQLTableData to support legacy use cases.
    (Merged PR #360)
  2. Fix for Participants Collection Null References
    Added null checks for the participants collection to prevent unhandled exceptions during interaction processing.
    (Merged PR #373)

  3. Database Write Failure Logging
    Added robust logging for database write failures to support easier diagnosis of transient errors.
    (Merged PR #373)

  4. Improve API Error Handling and Rate Limit Management
    Improved management of API rate limits.
    Added fallback handling to reduce job disruption.
    (Merged PR #373)

  5. Improve WFM Audit Error handling and Parsing Data Structure
    Improved the error handling around the WFM Audit job.
    Aligned the data structure to match API responses for parsing outputs.
    (Merged PR #373)

  6. Resolve Date Incrementing Issue for UserInteractionData
    Fixed an issue where dates were incrementing incorrectly due to local culture settings.
    (Merged PR #387)

  7. Uplift Shrinkage Job Error Handling
    Improved error handling in the shrinkage processing job to better manage unexpected failures.
    (Merged PR #387)



May 2025

May 2025

May 21, 2025 — Version 3.46.1

Bugs

  • Learning Module Null Error Handling:
    Implemented null handling on nullable columns in the Learning Module, Assignments and Results.
    (Merged PR #358)

  • User Data Null Error Handling:
    Implemented null handling on nullable columns in the User Interaction and User Presence data.
    (Merged PR #358)

Improvements

  • Learning Module Logging:
    Improved logging on the learning module.
    (Merged PR #358)

May 1, 2025 — Version 3.46.0

Features

  • Realtime Observations Management:
    Implemented manager into Real Time Job for querying observations and handling limits more effectively.
    (Merged PR #346)

  • Update Permissions:
    Updated and streamlined permission logic to support recent platform changes.
    (Merged PR #327, #344)
  • Backfill uplift:
    Implemented backfill functionality across multiple jobs to enable separate jobs for re-syncing historical data.
    (Merged PR #342)
  • CSI Licensing Uplift:
    Implemented licensing module to control access to the Genesys Adapter.
    (Merged PR #326)

Bugs

  • Offered Forecast Timeout:
    Increased timeout on SQL queries whilst implementing additional logging and better error handling
    (Merged PR #339)

Improvements

  • CI Pipeline Uplift:
    Included end-to-end testing across all CI jobs to strengthen build integrity.
    (Merged PR #318)

  • Updated Azure Pipelines Configuration:
    Refined the azure-pipelines.yml file to enhance CI/CD performance.
    (Merged PR #318)

  • Deployment Trigger and Documentation Enhancements:
    Adjusted deployment triggers to respond to pull requests and improved related documentation.
    (Merged PR #322)

  • Reduced API Batch Size and Logging Enhancements:
    Lowered batch size for real-time modules and introduced more detailed logs.
    (Merged PRs #338)

  • Optimised Batch Processing in Real-Time Modules:
    Refactored batch handling to improve throughput and performance.
    (Merged PRs #336)

  • Dynamic API URL:
    Replaced static references to APIs for login and streaming URLs with dynamic derivation
    (Merged PRs #342)

  • Eval Details Column Descriptions:
    Improved the descriptions of the columns in the Eval Details table to avoid confusion with the evaluationid column.
    (Merged PRs #341)


February 2025

February 2025

February 25, 2025 — Version 3.43.0

Features

  • Logging and Error Handling Enhancement for AdminData: Improved logging and error handling in adminData with structured logging for better maintainability.
    (Merged PR #316)
  • Added vwuserqueuemappings: Introduced the vwuserqueuemappings feature to enhance data organization and access for MSSQL.
    (Merged PR #319)

Bug Fixes

  • Null Handling for Flow Outcomes End Timestamp: Added null handling for the flowoutcomes end timestamp to prevent errors.
    (Merged PR #314)
  • Query End Date Handling for Future Dates: Fixed issue by setting query end date to utcnow if it's in the future.
    (Merged PR #315)
  • No Processing of Future Data: Resolved issue where future data was not processed correctly.
    (Merged PR #320)

Improvements

  • CI Pipeline Uplift: Enhanced CI pipeline to include end-to-end testing for all jobs, improving testing coverage and overall QA process.
    (Merged PR #317, #318)

February 11, 2025 — Version 3.41.0

Features

  • Logging and Code Uplift for SQL Batches in Interaction Job: Improved logging and optimised SQL batch processing for the Interaction Job.
    (Merged PR #307)
  • Schema Uplift for Persona Dashboards: Updated schema definitions to enhance Persona Dashboard functionality.
    (Merged PR #309)
  • Survey Job Uplift: Enhanced survey job processing for better reliability and performance.
    (Merged PR #308)

Bug Fixes

  • Additional check for stuck Real Time Conversations: Added an additional validation step for conversations exceeding an hour in the Real Time Job.
    (Merged PR #312)
  • Fix Sync Type to Lowercase: Standardised sync type values to lowercase for consistency.
    (Merged PR #310)

Improvements

  • Version Increment: Internal versioning update for tracking release changes.
    (Merged PR #303)
January 2025

January 2025

January 30, 2025 — Version 3.40.1

Bug Fixes

  • Fix Output for Missing Permissions Message on Error: Ensured that missing permissions messages are properly displayed when errors occur.
    (Merged PR #301)
  • Remove Duplicate Schema Logic in DetailedInteractionData: Addressed an issue where duplicate entries were being stored in the DetailedInteractionData schema file.
    (Merged PR #301)
  • Fix Error Handling on Async Interaction Job: Improved error handling for asynchronous interaction jobs to prevent failures.
    (Merged PR #301)
  • Add Duplicate Constraint Checks for Flow Outcomes: Implemented additional checks to prevent duplicate flow outcome entries.
    (Merged PR #301)
  • Update Handling for csg_artefacts Schema: Adjusted logic in the csg_artefacts schema file to improve data consistency.
    (Merged PR #301)

January 28, 2024 — Version 3.40.0

Features

  • Implement Flow Outcomes: Introduced flow outcomes functionality for improved tracking and analysis.
    (Merged PR #294)
  • Forbidden Handling: Added forbidden handling logic for the API responses to enhance error management.
    (Merged PR #295)

Bug Fixes

  • EvalData Lookback Paging Uplift: Enhanced the paging mechanism for EvalData lookback functionality.
    (Merged PR #296)
  • Uplift MSSQL Schemas: Improved MSSQL schemas for better compatibility and performance.
    (Merged PR #297)
  • Uplift Realtime Schema: Updated and optimised the realtime schema to align with current standards.
    (Merged PR #298)

Improvements

  • Extract Missing Users from Group Membership: Enhanced group membership logic to identify and extract missing users.
    (Merged PR #299)
December 2024

December 2024

December 18, 2024 — Version 3.39.4

Features

  • Sanitising Participant Attributes:
    Improved extraction of participant attributes dynamically, ensuring columns names conform to database standards (e.g. whitespace)
    (Merged PR #292)

December 16, 2024 — Version 3.39.0

Features

  • Enhanced Asynchronous Processing for Interaction Jobs:
    Improved asynchronous processing for interaction jobs to ensure reliable and efficient performance.
    (Merged PR #284)
  • Enhanced Forecast Job Stability:
    Improved error handling in the Forecast Job to ensure reliable performance.
    (Merged PR #282)
  • Historical Data Synchronization:
    Enabled synchronization of historical schedules and offered forecasts for comprehensive data tracking.
    (Merged PR #269)

Improvements

  • Enhanced User Interaction Data Processing:
    Updated the process for retrieving user interaction data to improve efficiency and accuracy.
    (Merged PR #280)
  • Refined User Interaction Data Handling:
    Further improvements to the user interaction data retrieval process, ensuring better performance.
    (Merged PR #279)
  • Advanced Logging for SQL Table Data:
    Implemented enhanced logging for SQL table data operations to facilitate easier troubleshooting and monitoring.
    (Merged PR #273)
  • Increase Evaluation Sync Limits:
    Updated default settings for Evaluation Syncs to ensure conversations are not missed during regular synchronization.
    (Merged PR #276)
  • Extended Evaluation Lookback:
    Updated the evaluation lookback period for more accurate data analysis.
    (Merged PR #276)
  • Improved Table Definitions Management:
    Implemented logic to automatically check and remove incorrect table definition entries.
    (Merged PR #275)
  • Voice Overview Dependency Integration:
    Added dependencies to ensure voice interactions are synchronized with the last interaction sync.
    (Merged PR #274)
  • Automated Cleanup of Old Suboverview Data:
    Introduced a procedure to delete outdated suboverview rows, maintaining data integrity.
    (Merged PR #270)

Bug Fixes

  • Prevent Missed Abandoned Interactions:
    Addressed issues where abandoned interactions (less than one second) were being missed from data collection.
    (Merged PR #284)
  • Improved Data Validation for Real-time Interactions:
    Introduced enhanced validation mechanisms for real-time interactions to increase reliability and data integrity.
    Added additional checks to improve the accuracy and reliability of realtime conversations.
    (Merged PR #278 and #268)
  • Enhanced Error Logging in Data Sync Processes:
    Updated error logs for better debugging during data synchronization.
    (Merged PR #281)
  • Enhanced Forecast Job Error Handling:
    Fixed missing semicolons and corrected error handling to enhance overall code stability.
    (Merged PR #282)
  • Manual Check Date Handling:
    Resolved issues with null start dates in manual checks to prevent data inconsistencies.
    (Merged PR #281)
  • Code Formatting Enhancements:
    Corrected curly brace positioning and improved code escaping for better readability and maintenance.
    (Merged PR #279)
  • MSSQL Timespan Handling Fix:
    Adjusted MSSQL timespan processing to ensure accurate data conversions.
    (Merged PR #278)
  • Data Conversion Safety:
    Implemented safer data conversion methods to prevent errors during data processing.
    (Merged PR #272)
  • Duplicate Entry Prevention:
    Added primary key checks to avoid duplication of records, ensuring data integrity.
    (Merged PR #269)
  • Partition Management Improvements:
    Patched the partition management process to handle new partitions, redistribute data effectively, and enhance analysis functions.
    (Merged PR #271)

December 05, 2024 — Version 3.38.1

Bug Fixes

  • Real Time Null Start Date in Conversations:
    Fixed an issue with handling null start dates in manual checks.
    (Merged PR 281)
  • Offered Forecast Null Object Handling:
    Fixed an issue with handling null forecast data objects.
    (Merged PR 282)

December 04, 2024 — Version 3.38.0

Features

  • Historical Forecast Adjustments:
    Enabled adjustments to historical forecasts for more accurate reporting.
    (Merged PR 279)

Improvements

  • Improved Data Validation for Real-time Interactions:
    Introduced enhanced validation mechanisms for real-time interactions to increase reliability and data integrity.
    (Merged PR 278)
  • Enhanced Error Logging in Data Sync Processes:
    Updated error logs for better debugging during data synchronization.
    (Merged PR 281)
  • Default: Increase Evaluation Sync Limits
    Updated default for Evaluation Syncs to ensure conversations are not missed when syncing regularly.
    (Merged PR 276)

Bug Fixes

  • Fixed Incorrect Sync Timestamps for Historical Data:
    Addressed an issue where historical data sync timestamps were misaligned, ensuring accurate records.
    (Merged PR 282)
  • Resolved Null Value Errors in Forecast Analysis:
    Fixed a bug causing null value errors in forecast analysis calculations.
    (Merged PR 283)

November 2024

November 2024

November 21, 2024 — Version 3.37.0

Bug Fixes

  • Isolate OfferedForecast from Schedule:
    Isolated the OfferedForecast logic from the Schedule to improve clarity and structure.
    (Merged PR 264)
  • Rename Learning Tables in Table Definitions:
    Renamed learning tables in table definitions to avoid conflicts.
    (Merged PR 265)
  • Fix Incorrect Start Dates from DST Offsets:
    Fixed issues related to incorrect start dates caused by Daylight Saving Time offsets.
    (Merged PR 266)
  • Resolve Keyid Deletion Logic Removing Too Many Rows:
    Resolved an issue where the keyid deletion logic removed more rows than intended.
    (Merged PR 262)
  • Update Deletion Logic for Keyid:
    Updated the deletion logic to ensure the correct number of rows are deleted, merging fixes from PR 262.
    (Merged PR 263)

November 2, 2024 — Version 3.36.0

Bug Fixes

  • Handle Data Errors During DST Crossover:
    Resolved data handling errors occurring during Daylight Saving Time (DST) crossover. The adherence data aggregation now correctly adjusts for UTC-based start dates, stopping the job and initiating a new entry to accommodate DST transitions.
    (Merged PR 261)

November 1, 2024 — Version 3.35.1

Bug Fixes

  • Delete Team Member Data Before Write:
    Added functionality to delete existing team member data prior to new data write operations.
    (Merged PR 259)
  • Update Correct Date Syntax for MSSQL in userPresenceData:
    Adjusted date syntax in userPresenceData to comply with MSSQL formatting.
    (Merged PR 258)
  • Update LastSync Based on Request Date:
    Fixed the last sync timestamp to align with the provided request date.
    (Merged PR 258)
  • Fix ArchiveQueueInteractions Cron Job:
    Resolved issues with the ArchiveQueueInteractions cron job.
    (Merged PR 255)

October 2024

October 2024

October 28, 2024 — Version 3.35.0

Features

  • Track Missing Rows and Delete:
    Added functionality to track missing data rows and enable deletions where necessary.
    (Merged PR 251)

Improvements

  • Implement SLA Target Information in Queue Details:
    Enhanced queue details with SLA target metrics to improve tracking.
    (Merged PR 252)
  • Update Query in userPresenceData to Handle All DBTypes:
    Improved query compatibility across multiple database types.
    (Merged PR 253)

Bug Fixes

  • Subscription Duplicate Patch and Cleanup:
    Resolved duplicate entries in subscriptions, with cleanup enhancements.
    (Merged PR 247)
  • Remove Delay in Conversation Looping:
    Optimized looping process by eliminating unintended delays.
    (Merged PR 249)
  • Remove UTC Conversion on Request Dates:
    Adjusted date handling by removing unnecessary UTC conversions.
    (Merged PR 250)

October 16, 2024 — Version 3.34.3

Bug Fixes

  • Re-open database connection after deletion:
    Resolved an issue where the database connection wasn't re-opening after a deletion operation.
    (Merged PR 245)

  • Resolve column diff errors in Participant Attributes:
    Resolved an issue where column mismatch occurs in participant attributes, causing an unhandled exception.
    (Merged PR 246)

  • Subscription duplicate patch and cleanup:
    A patch was applied to remove duplicate subscriptions, along with a general cleanup of related code.
    (Merged PR 247)

October 15, 2024 — Version 3.34.2

Improvements

  • Aggregation User Interaction duplicate patch:
    A patch was applied to remove duplicate user interactions in the Aggregation job.
    (Merged PR 230)
  • Increment Merged Branch Version:
    Disabled the prevent-increment-of-merged-branch-version configuration for the main branch.
    (Merged PR 236)
  • Set Requested Date as Last Update:
    Fixed the last update timestamp to be set to the request date at the end of processing user presence data.
    (Merged PR 240)

October 14, 2024 — Version 3.34

Features

  • Align SQL Database Write Methods:
    Uplift admin jobs to use writesqldatabulk method.
    (Merged PR 203)
  • Clean up Adherence Subscription Channels:
    Remove subscriptions from adherence websocket.
    (Merged PR 215)

Improvements

  • Add Look Back Span in WFM Schedule Data Job:
    Added Look Back Span in WFM schedule data job.
    (Merged PR 188)
  • Adjust Lookback and Max Sync Span:
    Changed lookback and max sync span for adherence, resolving Snowflake errors.
    (Merged PR 199)
  • Enhance Performance for Voice Topic Detail Data:
    Improved performance for mvwconvvoicetopicdetaildata with indexing.
    (Merged PR 221)
  • Handle Multiple Executions in User Presence Data:
    Updated check_and_update_userpresencedetaileddata to support multiple executions.
    (Merged PR 213)
  • Implement Mixed Patches Across Various Components:
    Applied mixed patches for realtime, schedule, adherence, and vwqueuedetails.
    (Merged PR 218)
  • Update Fact Data Job:
    Modified fact data job.
    (Merged PR 206)
  • Resolve Adherence Syncing Issues:
    Addressed adherence syncing issues for actuals and exceptions.
    (Merged PR 196)
  • Fix Column Discrepancies:
    Handled discrepancies in column data.
    (Merged PR 197)
  • Improve Logging for Interaction:
    Updated logging for the interaction job.
    (Merged PR 221)
  • Update Job Minimum Definition for Snowflake:
    Updated job minimum definition schema and defaults for Snowflake.
    (Merged PR 221)
  • Add Index to Voice Topic Detail Data:
    Enhanced mvwconvvoicetopicdetaildata with an index.
    (Merged PR 221)
  • Clean Up User Queue Mapping:
    Removed outdated entries in user queue mapping.
    (Merged PR 201)

Bug Fixes

  • Fix UserActivity Not Updating Table:
    Resolved an issue where UserActivity job failed to update the table.
    (Merged PR 202)
  • Resolve Schema Errors:
    Fixed schema errors.
    (Merged PR 191)
  • Fix Intermittent Realtime Errors:
    Addressed intermittent errors in realtime processing.
    (Merged PR 189)
  • Remove Division Filtering from Presence Details Sync:
    Removed Division Filtering from presence details synchronization.
    (Merged PR 221)
  • Resolve Duplicates in Job Minimum Definition:
    Corrected duplicate entries in job minimum definition.
    (Merged PR 221)
  • Remove Truncate from User Presence Data:
    Removed unnecessary truncation in user presencedetailed data.
    (Merged PR 221)
  • Handle Unhandled Websockets:
    Resolved issues with unhandled websockets.
    (Merged PR 217)
  • Fix Removal of Schedule Data from vwadhday:
    Corrected removal of schedule data from vwadhday.
    (Merged PR 216)
47.2

    • Related Articles

    • May 2024 Release

      Features Implement automated data dictionary Say hello to streamlined data management with our automated data dictionary feature, making it easier than ever to organize and understand your data. Implement first iteration of Version control in Schema ...
    • June 2024 Release

      Features Implement automated data dictionary Say hello to streamlined data management with our automated data dictionary feature, making it easier than ever to organize and understand your data. Implement first iteration of Version control in Schema ...
    • July 2024 Release

      Features Changed Adherence Data Endpoint: Updated adherence endpoints, impacting all adherence tables. Disclaimer: This update requires a full resync of data, which will be updated automatically. Enhanced MVWCONVVOICE*DATA: Added division and phrase ...
    • August 2024 Release

      Features: Presence Definitions Sync Fix: Presence definitions now sync across all divisions, ensuring consistent updates to the userpresencedata table. New JobMinimumDefinition Table: Introduced to track look-back and look-forward spans, enhancing ...
    • 3.34

      Release Notes - Version 3.34.0 Features: Service Goal Details Job Addition: Added a new job that provides detailed insights into service goals, improving reporting and performance tracking for workforce management. Learning APIs Added: Integrated new ...