We are excited to announce the release of Vygo API v5.0, introducing enhanced flexibility for session feedback with support for custom feedback questions. This update enables organisations to capture more meaningful, context-specific feedback through configurable question sets while maintaining backward compatibility with existing integrations.

What's new

Sessions

Session Feedback - Custom Questions Support

The /sessions/feedback endpoint has been enhanced to support custom feedback questions. Organisations can now retrieve detailed feedback responses with full question and answer context, moving beyond the standard knowledge, communication, and confidence ratings.

New Response Format:

When custom feedback questions are enabled for an organization, the API returns a customAnswers array containing:

Question details: Full question text, question type (single-select, multi-select, short-text), and unique identifiers
Answer details: Complete answer text with IDs for select-type questions
Flexible structure: Support for multiple answer types including single-select, multi-select, and free-form text responses

Example Response:

{
  "results": [
    {
      "session_id": "abc123",
      "customAnswers": [
        {
          "questionId": "q1",
          "questionText": "How well did your supporter understand the topic?",
          "answerType": "single-select",
          "answers": [
            {
              "answerText": "Amazing",
              "answerId": "a3"
            }
          ]
        }
      ],
      "rating": 5,
      "comment": "Great session!"
    }
  ]
}

Backward Compatibility: Existing integrations continue to work seamlessly. The endpoint automatically returns the appropriate format based on your organization's configuration:

Organizations with custom feedback questions enabled receive the new customAnswers format
Organizations using standard feedback receive the legacy knowledge, communication, and confidence numeric fields
Only one format is returned per response - when customAnswers is available, legacy fields are omitted

This enhancement provides richer insights into session effectiveness while ensuring zero disruption to existing API consumers.