Skip to content
HALOWERK

Tonwerk

effort index

Counts disclosed German/English cue patterns per category (transfer 15 points each, hold 6, clarification 4, repeat-contact mention 20 once, identity data asked again 10 from the second request) and customer repetitions (two customer turns sharing ≥ 3 stemmed content words with Jaccard ≥ 0.5, 8 points each). The index is the capped sum (0–100) with bands low < 20, medium < 50, high. It is a transparent proxy computed from the call, not a survey-based Customer Effort Score. Without.

POST https://ton.halowerk.com/v1/effort-index

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
transcriptstring, object, arrayNoTranscript as WebVTT or SRT text (speakers from <v Name> voice tags or "Name:" prefixes), or JSON (text or object) with a list of segments, utterances, turns, cues or words carrying start, end, speaker and text – e.g. the output of medienwerk /v1/stt or /v1/diarize, Whisper, AssemblyAI or Deepgram.
segmentsarrayNoAlternative to transcript: segments with start/end in seconds, speaker and text.
time_unitstringNoUnit of start/end in JSON transcripts; auto treats integer values with a median segment length above 60 as milliseconds.
agent_speakersarrayNoSpeaker labels of the company side (agent, IVR). Rules that concern what the company says are then checked only in these speakers' segments.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "transcript": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "minLength": 1,
      "maxLength": 3000000,
      "description": "Transcript as WebVTT or SRT text (speakers from <v Name> voice tags or \"Name:\" prefixes), or JSON (text or object) with a list of segments, utterances, turns, cues or words carrying start, end, speaker and text – e.g. the output of medienwerk /v1/stt or /v1/diarize, Whisper, AssemblyAI or Deepgram."
    },
    "segments": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5000,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "start",
          "end",
          "text"
        ],
        "properties": {
          "start": {
            "type": "number",
            "minimum": 0,
            "maximum": 86400,
            "description": "Start time in seconds."
          },
          "end": {
            "type": "number",
            "minimum": 0,
            "maximum": 86400,
            "description": "End time in seconds."
          },
          "speaker": {
            "type": "string",
            "maxLength": 100,
            "description": "Speaker label as delivered by diarisation, e.g. \"A\", \"SPEAKER_00\" or \"Agent\"."
          },
          "text": {
            "type": "string",
            "maxLength": 5000,
            "description": "Text of the segment."
          }
        }
      },
      "description": "Alternative to transcript: segments with start/end in seconds, speaker and text."
    },
    "time_unit": {
      "type": "string",
      "enum": [
        "auto",
        "s",
        "ms"
      ],
      "default": "auto",
      "description": "Unit of start/end in JSON transcripts; auto treats integer values with a median segment length above 60 as milliseconds."
    },
    "agent_speakers": {
      "type": "array",
      "maxItems": 20,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "description": "Speaker labels of the company side (agent, IVR). Rules that concern what the company says are then checked only in these speakers' segments."
    }
  }
}

Open original schema

Published input example

{
  "transcript": "Customer: Hi, I already called yesterday about my broken router.\nAgent: Can I have your account number?\nCustomer: It is in my email, my router is broken since Monday.\nAgent: I will transfer you to the technical team.\nAgent2: Hello, can I have your account number please?\nCustomer: Again? My router is broken since Monday!",
  "agent_speakers": [
    "Agent",
    "Agent2"
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →