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 Coverage Tester

Include API branches

🗺️ 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

☁️ 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 Pronunciation Mapping

Map words to TTS-friendly pronunciations. Example: "Avas" → "Ayvas" so TTS pronounces it correctly.

Original Word

Pronunciation

Test Text

Current Mappings:

Click "Refresh" to load mappings

📦 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 SMS for sending text messages from IVR flows. Used for order confirmations, delivery updates, and customer support links.

Checking SMS status...

Account SID Your Twilio Account SID from the console

Auth Token Keep this secret - used for API authentication

Messaging Service SID Messaging Service for automatic number selection

📋 Current Configuration

Live Preview

Showing: Last saved configuration

👤 Profile Manager 🚀 Open Unified Chat 🔍 Debug UI

🤖

AI Website Chatbot

This is an AI-powered chatbot that automatically learns from your website. It crawls your pages, understands the content, and answers customer questions naturally.

🛒 Sales Assistant

Helps customers browse products, get recommendations, and learn about your offerings.

📋 Policy Assistant

Answers questions about shipping, returns, FAQs, and company policies.

📖 How does it work?

                                            CrawlAndExtract → AgentDecision → DraftAnswer

                                                   ↑                  │

                                                   └──── explore ─────┘

Crawl: Fetches and extracts text from your website pages
Decide: AI determines if it has enough info or needs to explore more
Answer: Generates a helpful response based on what it learned

⚙️ Global AI Settings

These settings apply to all AI Chat profiles. Per-profile settings are in Profile Manager.

Enable AI Chatbot

🌟 Gemini (Google)

Gemini Model

Gemini API Key

🤖 OpenAI

OpenAI Model

OpenAI API Key

💡 Tip: Each profile can choose which LLM provider to use (Gemini or OpenAI). Configure both here, then select per-profile in Profile Manager.

RAG Mode: For large sites, enable RAG mode in Profile Manager. It chunks content into a vector database for better retrieval.

🔑 API Key Validation

Test your API keys to make sure they're working correctly.

Click a test button to validate your API key...

Gemini: Loading...
OpenAI: Loading...

🧹 Content Processing Rulesets

Configurable Rules System

Rulesets define what patterns to match/remove. Domain assignments define which domains get which rulesets. This allows full customization without code changes.

📋 Available Rulesets

Loading rulesets...

🔗 Domain Assignments

Loading domain assignments...

➕ Add Domain Assignment

Regex tips: Use \\. for dots, (a|b) for alternatives. Example: shop\\.(com|net)

📦 Page Cache

Enabled

Cache crawled pages to avoid re-fetching. Dramatically improves response time for repeat questions.

Cache TTL (hours)

Pages re-crawled after this time

Max Cached Pages

Oldest removed when exceeded

⚠️ If prices seem wrong: Clear ALL to remove old cached content that was crawled before sanitization rules were added.

Click "Refresh Stats" to see cache status...

🗂️ Vector Store

Enabled

Persistent vector database for Indexed mode. Stores embeddings of crawled content for semantic search. Grows over time as you use the chatbot.

Storage Path

Relative to project root. Keep outside zip for persistence.

Embedding Model

Sentence transformer model

Click "Refresh Stats" to see vector store status...

💡 How it works: When a profile uses Indexed mode, crawled pages are chunked and stored as vector embeddings. When you ask a question, only the most relevant chunks are retrieved and sent to the LLM. The index persists between sessions and improves over time.

📁 Profile Configuration

Open Profile Manager →

Configure individual chatbot profiles (URLs, instructions, crawl settings) in the Profile Manager. Each profile can be either a AI Chat (AI website crawler) or DSL (voice/chat flow) type.

AI Chat Profiles

AI crawls your website to answer questions. Configure start URLs, instructions, and crawl limits.

DSL Profiles

Structured flows for voice/SMS/chat. Uses your existing JSON flow files and interpreter.

💡 Tip: Global settings here (API key, model, cache) apply to all AI Chat profiles. Per-profile settings (URLs, instructions) are in Profile Manager.

🧪 Quick Test

📁 Profiles 🚀 Open Chat

Test your profiles in the Company Chat interface. Configure profiles in Profile Manager.

💐 Sales 📦 Support ❓ FAQ 🔍 Debug

📋 Current AI Configuration

📊

Server Analytics

Mission-Critical Service Monitoring

Auto (30s)

🟢 Health Status

All systems operational

💾 Memory

RSS Memory

--%

Of System

Memory Usage 0%

Trend: --

⚡ CPU

--%

CPU Usage

Cores

CPU Usage 0%

Trend: --

🧵 Threads & Connections

Threads

Connections

File Desc.

Trend: --

🖥️ Server Info

Uptime

Workers

🖥️ System Resources

Total RAM

Available RAM

--%

RAM Used

Disk Free

--%

Disk Used

Load (1m)

🔧 Admin Actions

🐍 Python Runtime

GC Gen0

GC Gen1

GC Gen2

Py Threads

Object Counts (Top 20)

💬

Chat Analytics

Real-time session tracking, crawler management, and geographic insights

📊 Today's Summary

Active Sessions

Sessions Today

Avg Steps/Session

Avg API Calls

Messages Today

Unique IPs

🕷️ Web Crawler Management
Max Concurrent:

Active Crawlers

Available Slots

Crawls Today

Failed

Avg Wait (s)

Active Crawlers Detail

No active crawlers

🗺️ Geographic Distribution

0 active sessions with location

Top Countries

Top Cities

📋 Active Sessions

Session	Tenant	Profile	Duration	Steps	API	Location	Current Node
No active sessions

📁 Session Logs

Select a date and click Load to view session logs

Last updated: --

🔧 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

☁️ Google Cloud TTS Settings

🎤 Kokoro TTS Settings

🔗 External TTS Settings

🔊 TTS Testing

🗣️ TTS Pronunciation Mapping

📦 TTS Cache & Hash Registry

🔢 DTMF Settings

📥 Pivot Session Fields

🔀 Relay Proxy

🎤 OSTI Speech Intent Router

📡 Real-time WebSocket

📱 Twilio SMS

📋 Current Configuration

AI Website Chatbot

⚙️ Global AI Settings

🌟 Gemini (Google)

🤖 OpenAI

🔑 API Key Validation

🧹 Content Processing Rulesets

📋 Available Rulesets

🔗 Domain Assignments

➕ Add Domain Assignment

📦 Page Cache

🗂️ Vector Store

📁 Profile Configuration

🧪 Quick Test

📋 Current AI Configuration

🟢 Health Status

⚠️ Recommendations

💾 Memory

⚡ CPU

🧵 Threads & Connections

🖥️ Server Info

🖥️ System Resources

🔧 Admin Actions

🐍 Python Runtime

📖 Best Practices Reference ✕ Close

⚙️ Health Check Thresholds ✕ Close

Chat Analytics

📊 Today's Summary

🕷️ Web Crawler Management Max Concurrent: Apply

🗺️ Geographic Distribution

Top Countries

Top Cities

📋 Active Sessions All Tenants

📁 Session Logs Load

Node

📖 Best Practices Reference

⚙️ Health Check Thresholds

🕷️ Web Crawler Management
Max Concurrent:

📋 Active Sessions

📁 Session Logs