Skip to content
HALOWERK

Tonwerk

ivr menu map

Splits each announcement into clauses and parses German and English menu phrasing with disclosed patterns ("für Rechnungen drücken Sie die 1", "die 2 für ", "press 3 for billing", "to speak to an agent press 0", "sagen Sie "), including spoken digits, star and hash, labels before or after the key and labels in a neighbouring clause. prompts give each announcement with its key path ("" = main menu, "1", "12" ); the tree links options to the prompts reached through them. Reports duplicate.

POST https://ton.halowerk.com/v1/ivr-menu-map

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.
promptsarrayNoAnnouncements with their key path. Alternative to transcript (which is treated as the main menu).
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."
    },
    "prompts": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "text"
        ],
        "properties": {
          "path": {
            "type": "string",
            "pattern": "^[0-9*#]{0,10}$",
            "default": "",
            "description": "Keys pressed to reach this announcement, e.g. \"\" (main menu), \"2\", \"21\"."
          },
          "text": {
            "type": "string",
            "minLength": 3,
            "maxLength": 5000,
            "description": "Transcribed announcement text."
          }
        }
      },
      "description": "Announcements with their key path. Alternative to transcript (which is treated as the main menu)."
    }
  }
}

Open original schema

Published input example

{
  "prompts": [
    {
      "path": "",
      "text": "Welcome to Warehouse credit cooperative. For card services press 1. For loans press 2. To speak to an agent, press 0."
    },
    {
      "path": "1",
      "text": "To block a card press 1, for a new PIN press 2, to return to the main menu press star."
    }
  ]
}

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 →