---
title: "Process a transcript and return feedback items"
method: POST
path: "/api/v1/feedback/process-transcript"
tags: ["feedback"]
---

# Process a transcript and return feedback items

`POST /api/v1/feedback/process-transcript`

## Request body

- FeedbackProcessTranscriptRequestDTO
  - `messages` object[], required — Array of transcript messages to be analyzed for feedback
    - `content` string, required
    - `id` string, required
    - `role` 'prospect' | 'sales-agent', required
    - `speakerUserId` string, nullable — The Jam user who spoke this turn; null/absent = not a resolved Jam user (prospect, persona, unlabeled speaker)
  - `playedLanguage` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'pl' | 'zh' | 'ja' | 'id' | 'tr' | 'pt' | 'el' | 'ko' | 'vi' | 'hi' | 'ms' | 'th' | 'hr' | 'ro' | 'bg' | 'sv' | 'no' | 'yue' — The language the conversation was played in. Defaults to the scorecard language when omitted.
  - `scorecard` object, required — The scorecard containing the evaluation criteria for analyzing the transcript
    - `createdAt` string, required
    - `id` string, required
    - `items` object[], required
      - `description` string, required
      - `desired_behaviours` object[], nullable
        - `behaviour` string, required
        - `examples` string, nullable
        - `id` string, required
      - `desired_outcome` string, nullable
      - `id` string, required
      - `item_title` string, required
    - `language` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'zh-Hans', required
    - `saga` object, required
      - `createdAt` string, required — Creation timestamp
      - `description` string, required — Description of the saga
      - `id` string, required — Unique identifier for the saga
      - `name` string, required — Name of the saga
      - `type` 'under_construction' | 'generic' | 'client_specific' — Type of the saga
      - `updatedAt` string, required — Last update timestamp
    - `tag` string, required
    - `title` string, required
    - `updatedAt` string, required

## Response `201`

- FeedbackProcessTranscriptResponseDTO
  - `items` object[], required — Array of analysis items
    - `behaviours` object[] — Array of behaviours assessed for this item
      - `evidence` string[], required — Evidence supporting the behaviour assessment
      - `score` number, required — The numerical score for this behaviour
      - `verdict` string, required — The verdict of the behaviour evaluation
    - `conversationItemReferenceId` string, nullable — Reference ID to the conversation item
    - `explanation` string, nullable — Explanation of the analysis result
    - `feedbackItemReferenceId` string, required — The ID of the feedback item
    - `name` string, nullable — The name of the analysis item
    - `score` number, required — The numerical score for this analysis item
    - `solved` 'undetected' | 'notSolved' | 'partlySolved' | 'solved' | 'null', nullable — The solving status of the item
    - `state` 'PROCESSING' | 'DONE' | 'ERROR', required — The current state of the analysis item
    - `suggestion` string, nullable — Suggestions for improvement

---

[API](https://skmtc.net/wejam/apis/jam.md) · [All operations](https://skmtc.net/wejam/apis/jam/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wejam/jam/revisions/bd5a5f406bca/schema)