Telephone.org IVR Debugger

Conversation

Debug

DSL:

🔧 Kazoo Pivot Output

Start a simulation to see Kazoo Pivot JSON output here.

Each step will show the JSON that would be sent to Kazoo.

Select a flow to edit

Select a node to edit

✏️

Select a node from the left panel to edit its properties

📍 Node Location

📊 Available Variables

Select a node to see available variables

🔗 Connections

⚠️ Warnings

✓ No issues

🗺️ Mini Map

⚙️ Flow Settings (click to edit)

Start Node

Description

🚨 Failover Callflow ID

Transfer here on errors

🔍 Analyze Flow:

💾 Presets:

Traces all reachable flows from selected root

Loading analysis...

📊 Flow Statistics

Click a flow to see stats

🌳 Branch Visualizer

All types

🗺️ Flow Connection Map

🔌 Endpoint Dependency Map

Run analysis to see endpoint usage

💾 Saved Presets (click to expand)

🎯 Test Navigator & Node Tools (click to expand)

🎯 Test Navigator

Jump to any node with pre-filled session data

Preset:

📊 Coverage Progress

📝 Node Verification (click to expand)

Click: cycle status (❓→✅→🔧) | Right-click: notes | Double-click: test

❓ Not Tested | 👁️ Visited | ✅ Verified | 🔧 Needs Fix

🔧 DSL Builder & Validator

Convert Twilio Studio flows, scripts, or descriptions into our DSL format. All prompt sections below are editable - customize them for your specific needs.

📜 System Instructions Core rules for the LLM - edit to adjust strictness

🔀 Node Types Reference DSL node specifications - add/modify as needed

=== SUPPORTED NODE TYPES ===

1. SAY - Play TTS prompt
{ "type": "say", "prompt": "Text to speak", "next": "next_node_id" }

2. CHOICE - Menu with DTMF options
{ "type": "choice", "prompt": "Press 1 for X, press 2 for Y",
  "choices": {
    "option1": { "dtmf": ["1"], "next": "node_for_1", "label": "Option 1" },
    "option2": { "dtmf": ["2"], "next": "node_for_2", "label": "Option 2" }
  },
  "timeout": 10, "fallback": "timeout_node" }

3. BRANCH - Route based on variable value
{ "type": "branch", "input": "{{variable_name}}",
  "branches": { "value1": "node_for_value1", "value2": "node_for_value2", "_default": "fallback_node" } }

4. SET_VAR - Set session variables (MUST use "assignments" object)
{ "type": "set_var", "assignments": { "var_name": "value", "another_var": "{{existing_var}}" }, "next": "next_node" }

5. PROMPT_COLLECT - Collect user input (digits, speech)
{ "type": "prompt_collect", "prompt": "Please enter your order number",
  "input_type": "digits", "max_digits": 8, "store_as": "order_number",
  "next": "next_node", "fallback": "retry_node" }

6. HTTP_DECISION - Make API call and branch on result
{ "type": "http_decision", "endpoint": "endpointName",
  "params": { "order_number": "{{order_number}}" },
  "branches": { "success": "success_node", "not_found": "not_found_node", "_default": "error_node" } }

7. HTTP_ACTION - Make API call without branching
{ "type": "http_action", "endpoint": "endpointName",
  "params": { "data": "{{value}}" }, "next": "next_node", "on_error": "error_node" }

8. TRANSFER - Transfer call to queue/number
{ "type": "transfer", "transfer_type": "queue", "destination": "{{queue_name}}",
  "pre_transfer_prompt": "Please hold while we connect you", "next": "_end" }

9. GOTO - Jump to another flow (with optional return)
{ "type": "goto", "target_flow": "OTHER_FLOW", "target_node": "start", "return_to": "node_to_return_to" }

10. RETURN - Return from a goto
{ "type": "return" }

11. END - End the call
{ "type": "end" }

📋 JSON Structure Templates Expected output format for flows and endpoints

💡 Working Example (SURVEY_FLOW) Real example from our system - helps LLM understand patterns

=== WORKING EXAMPLE: SURVEY_FLOW ===
This flow was converted from an AGI PHP script. Key patterns:

1. ENTRY_PARAMS for required input:
"entry_params": { "survey_type": { "required": true, "description": "1=Sales, 2=CS, 3=Florist", "examples": ["1","2","3"] } }

2. BRANCH on entry param to route:
"survey_router": { "type": "branch", "input": "{{survey_type}}", 
  "branches": { "1": "sales_intro", "2": "cs_intro", "3": "florist_intro", "_default": "invalid_survey" } }

3. CHOICE for collecting 1-5 ratings:
"sales_q1": { "type": "choice", "prompt": "On a scale of 1-5, how satisfied were you?",
  "choices": {
    "1": { "dtmf": ["1"], "next": "set_sales_q1_1" },
    "2": { "dtmf": ["2"], "next": "set_sales_q1_2" },
    ...
  }, "timeout": 15, "max_attempts": 3, "fallback": "sales_q1" }

4. SET_VAR to store responses:
"set_sales_q1_1": { "type": "set_var", "assignments": { "sales_q1": "1" }, "next": "sales_q2" }

5. HTTP_ACTION to submit results:
"submit_survey": { "type": "http_action", "endpoint": "saveSurvey",
  "params": { "lead_id": "{{lead_id}}", "q1": "{{sales_q1}}", "q2": "{{sales_q2}}", "q3": "{{sales_q3}}" },
  "next": "thank_you", "on_error": "thank_you" }

📄 YOUR SOURCE TO CONVERT Paste Twilio JSON, script code, or describe the flow you want

✨ Generated Combined Prompt

Click "Generate Combined Prompt" to assemble all sections above into a single prompt for the LLM.

📥 Import LLM Response

After running the prompt through an LLM (Claude, GPT, etc.), paste the response here. The system will extract FLOWS and ENDPOINTS JSON blocks, validate them, and prepare for import.

📁 Upload JSON File

🕐 Business Hours Manager

Manage named schedules that DSL check_schedule calls reference

📊 Schedule Status

Current status of all named schedules (as referenced by DSL)

📅 Weekly Hours

Select a schedule to edit its weekly hours

🚫 Recurring Holidays

These dates are closed every year (affects schedules with shared holidays enabled)

📆 Special Closures

One-time closures (e.g., Thanksgiving varies each year)

🧪 Test Schedule

Simulate a date/time to test if a schedule would be open

📞 Queue Manager

Map DSL queue destinations to Kazoo extensions and CRM callback IDs

📋 Queue Mappings

DSL Destination	Name	Ext	Callflow ID	Queue ID	CRM ID	Aliases
Loading...

🔍 Test Queue Lookup

Test resolving any identifier to its queue info

📊 Queue Usage in Flows

Shows which flows use each queue

Server Base URL

This URL is used by Kazoo to reach your IVR server. Set it in Settings → Server Settings.

📊 Today's Stats

Calls Today

Active Now

Peak Concurrent

Avg Steps

Avg Response: 0ms

Last Call: --

Errors: 0

🎯 Flow Hits Today

No data yet

🟢 Active Calls

No active calls

🚨 Error Log

No errors

Auto-refresh 📡 Realtime

0 entries

📡

Loading call logs...

🌐 API Endpoints

CRM API integration health and usage dashboard

Total Endpoints

Used in Flows

Orphaned

Local Handlers

📁 API Groups

⚠️ Orphaned Endpoints

🌐

Select an endpoint group or endpoint to view details

🌐 Server Settings

Configure the public URLs that Kazoo will use to reach this server and the TTS endpoint.

Base URL (Public IP/domain for Pivot)

TTS Base URL (Leave blank to use Base URL)

IVR Base URL (Leave blank to use Base URL)

Host

Port

🔊 TTS Provider

Select and configure the text-to-speech engine for IVR prompts.

Provider

Enable TTS Cache

Max Text Length

🗣️ Pronunciation Mappings

Map words to TTS-friendly pronunciations. Example: "avas" → "ayvas" so TTS says it correctly.

Original Word

→

Pronunciation

☁️ Google Cloud TTS Settings

Configure Google Cloud Text-to-Speech API credentials and voice settings.

Service Account JSON *Required

No file uploaded

Upload your Google Cloud service account JSON key file (e.g., my-project-123456.json)

Or Paste JSON Credentials

Voice

Language

Speaking Rate (0.25 - 4.0)

Pitch (-20 to +20)

Audio Encoding

Sample Rate

Effects Profile

🔊 TTS Testing

Test TTS synthesis directly and via the Kazoo-compatible endpoint.

Current Provider: -- (Change above and Save Settings to switch)

Test Text

📦 TTS Cache & Hash Registry

Monitor TTS caching and hash registry. Hash registry maps clean URLs to text.

🔗 Hash Registry

Registered Hashes

Max Capacity

🎵 Audio Cache

Hit Rate

Entries

Hits

Misses

Memory

Bytes Saved

Evictions

Recent Cache Entries:

                                Click "Refresh Stats" to load entries
                            

🔢 DTMF Settings

Configure timing for DTMF digit collection. Other settings (max digits, timeout) are defined per-node in the DSL.

Inter-digit Timeout (ms) Time between key presses before input is accepted. Increase if callers need more time to type order numbers or zip codes.

📥 Pivot Session Fields

Select which Kazoo Pivot request fields to store as session variables. These become available as {{variable}} in your DSL flows for branching, API calls, etc.
📖 Kazoo Pivot Docs

Standard Fields (every request)

Optional Fields (after certain actions)

Always included:

call_id - unique call identifier (used as session ID)
lead_id - alias for call_id (CRM convenience)
Custom-Application-Vars - unpacked as individual session vars

💡 Usage Example

// In your DSL flow, branch based on caller:
{
"type": "branch",
"input": "{{caller_id}}",
"branches": {
"+15551234567": "vip_greeting",
"_default": "standard_greeting"
}
}

🔀 Relay Proxy

Configure relay proxy for CRM API calls through a remote server.

Enable Relay Proxy

Relay Target URL

Forward requests to IVR after relay

🎤 OSTI Speech Intent Router

Configure the openSpeechToIntent server for voice-based menu navigation. When enabled on a choice node, calls will be redirected to OSTI for speech recognition racing against DTMF.

Enable OSTI Integration (Global)

OSTI Pivot URL (Speech intent server) The OSTI server receives Kazoo pivot redirects, streams audio, races DTMF vs speech, and returns results.

Return URL Template (How OSTI calls back) Template URL OSTI uses to return results. Use {session_id} placeholder.

Default Threshold Confidence score (0-1) required to accept speech intent

Speech Timeout (ms) How long OSTI listens for speech

OSTI WebSocket URL (Audio stream endpoint) WebSocket URL for Kazoo to stream call audio to OSTI

📋 OSTI Redirect Parameters

Parameters sent TO OSTI:
session_id
 - Current call session ID
return_url
 - URL to redirect back with results
prompt_url
 - TTS audio URL for speech prompt
dtmf_prompt_url
 - TTS audio URL for DTMF prompt
intents
 - JSON: {key: {dtmf:["1"], phrases:[...]}}
threshold
 - Confidence threshold
timeout
 - Speech timeout in ms
session_vars
 - Base64 encoded session variables
flow_id
 - Current flow ID
node_id
 - Current node ID
Parameters returned FROM OSTI:
Digits
 - Matched DTMF digit (for DSL compatibility)
source
 - "osti" or "dtmf"
intent
 - Intent key if from speech
confidence
 - Match confidence (0-1)
transcript
 - What caller said
session_id
 - Session ID (echoed back)
                            

📡 Real-time WebSocket

Enable WebSocket event broadcasting for real-time dashboards. When disabled, there is zero performance overhead on the IVR engine.

Enable Real-time Broadcasting

When enabled:

• WebSocket endpoint: ws://host/ws/realtime?channels=stats,calls,all

• REST API: GET /api/realtime/summary

• Events published for: call start/end, flow changes, node execution

Use for external dashboards that need real-time call counts.

Status: Checking...

📱 Twilio SMS

Configure Twilio for sending SMS messages from IVR flows (missing item links, PAN notices, order modification links).

Account SID

Auth Token Keep this secret - stored in settings.json

Messaging Service SID Uses messaging service for automatic number selection

📋 SMS Nodes in Flows

DELIVERY_FLOW / missing_item_message

Sends CS URL for missing item requests

SOP_FLOW / pan_url_text

Sends Product Availability Notice URL + PIN

ORDER_MOD_FLOW / ordermod_send_sms

Sends order modification URL

🔐 Security Settings

Basic login protection for the admin console.

Admin Password

Leave blank to keep current password. Default: avas2026

📋 Current Configuration

Live Preview

Showing: Last saved configuration

🔧 DSL Builder & Validator

📥 Import LLM Response

📦 Extracted Items

✅ Validation & Import

🕐 Business Hours Manager

📊 Schedule Status

📅 Weekly Hours

🚫 Recurring Holidays

📆 Special Closures

🧪 Test Schedule

📞 Queue Manager

➕ Add New Queue

📋 Queue Mappings

🔍 Test Queue Lookup

📊 Queue Usage in Flows

Server Base URL

🌐 API Endpoints

🌐 Server Settings

🔊 TTS Provider

🗣️ Pronunciation Mappings

☁️ Google Cloud TTS Settings

🎤 Kokoro TTS Settings

🔗 External TTS Settings

🔊 TTS Testing

📦 TTS Cache & Hash Registry

🔢 DTMF Settings

📥 Pivot Session Fields

🔀 Relay Proxy

🎤 OSTI Speech Intent Router

📡 Real-time WebSocket

📱 Twilio SMS

🔐 Security Settings

📋 Current Configuration

📞 Telephone.org

🔧 DSL Builder & Validator

📥 Import LLM Response

📦 Extracted Items

✅ Validation & Import

🕐 Business Hours Manager

📊 Schedule Status

📅 Weekly Hours

🚫 Recurring Holidays

📆 Special Closures

🧪 Test Schedule

📞 Queue Manager

➕ Add New Queue

📋 Queue Mappings

🔍 Test Queue Lookup

📊 Queue Usage in Flows

Server Base URL

🌐 API Endpoints

🌐 Server Settings

🔊 TTS Provider

🗣️ Pronunciation Mappings

☁️ Google Cloud TTS Settings

🎤 Kokoro TTS Settings

🔗 External TTS Settings

🔊 TTS Testing

📦 TTS Cache & Hash Registry

🔢 DTMF Settings

📥 Pivot Session Fields

🔀 Relay Proxy

🎤 OSTI Speech Intent Router

📡 Real-time WebSocket

📱 Twilio SMS

🔐 Security Settings

📋 Current Configuration

Node