Configuration

Settings

Tune the demo without changing code. Quick settings cover the common path; the JSON editor remains available for full schema-level control.

Current scope: session

Saved to this anonymous browser session. Keep outbound, recording, and connector credentials consistent with your demo responsibilities.

Advanced JSON Editor

Full schema (SettingsData). Invalid JSON will be rejected by the server.

Settings JSON

{
  "runtime_settings_policy_version": 1,
  "app_mode": "dispatch",
  "tenant_display_name": "Demo Tenant",
  "language": "en",
  "openai": {
    "model": "gpt-realtime-2.1",
    "voice": "coral",
    "output_modalities": [
      "audio"
    ],
    "audio_input_type": "audio/pcmu",
    "audio_input_rate": 8000,
    "audio_output_type": "audio/pcmu",
    "transcription_model": "gpt-realtime-whisper",
    "transcription_fallback_model": null,
    "transcription_prompt": "Telephone speech in Italian. Expect Italian city names, personal names, phone numbers, email-like spellings, and 6-digit pairing codes.",
    "input_noise_reduction": "near_field",
    "reasoning_effort": "low",
    "temperature": 0.7,
    "max_output_tokens": "inf",
    "system_prompt": "You are a professional voice assistant. This system is a multi-scenario demo platform (bus, restaurant, helpdesk, hotel, e-commerce). Collect the necessary information, confirm details, and stay concise.",
    "greeting_enabled": true,
    "greeting_prompt": "Hello! Do you have a 6-digit pairing code? You can say it aloud or type it on your phone keypad. If you don't have a code, we can continue without the live dashboard.",
    "turn_detection": {
      "type": "semantic_vad",
      "threshold": 0.5,
      "prefix_padding_ms": 300,
      "silence_duration_ms": 500,
      "interrupt_response": true,
      "create_response": true,
      "idle_timeout_ms": null
    },
    "truncate_safety_ms": 150,
    "conversation_style": null
  },
  "telephony": {
    "outbound_from_number": "",
    "fallback_to_caller_number": true,
    "use_phonenumbers": true,
    "require_outbound_confirmation": true,
    "outbound_max_calls_per_session": 3,
    "outbound_cooldown_seconds": 30,
    "block_emergency_numbers": true,
    "allowlist_countries": [
      "IT",
      "US",
      "AL"
    ],
    "denylist_numbers": [
      "112",
      "113",
      "115",
      "117",
      "118",
      "1515",
      "911",
      "988",
      "127",
      "128",
      "129",
      "1129"
    ],
    "denylist_prefixes": [
      "899",
      "892",
      "894",
      "895",
      "900",
      "976"
    ],
    "outbound_unlimited_numbers": [
      "3277795029"
    ],
    "outbound_daily_max_per_caller": 5,
    "max_call_duration_seconds": 180
  },
  "routes": {
    "provider": "none"
  },
  "features": {
    "enable_contact_lookup": true,
    "enable_outbound_call": true,
    "enable_route_estimate": false,
    "enable_booking_capture": true,
    "enable_server_recording": false,
    "enable_pairing": false,
    "enable_kb_search": false,
    "enable_web_search": false,
    "enable_restaurant_tools": false,
    "enable_helpdesk_tools": false,
    "enable_hotel_tools": false,
    "enable_ecommerce_tools": false,
    "enable_dispatch_tools": false,
    "enable_send_email": false,
    "enable_notify_sms": false,
    "enable_notify_whatsapp": false,
    "enable_post_call_processing": false,
    "enable_vision_analysis": false
  },
  "web_search": {
    "provider": "duckduckgo_html",
    "cache_ttl_seconds": 300
  },
  "compliance": {
    "recording_notice_enabled": true,
    "recording_notice_text": "Nota: la chiamata potrebbe essere registrata per finalità operative/diagnostiche e cancellata entro 24 ore.",
    "outbound_responsibility_notice_enabled": true,
    "outbound_responsibility_notice_text": "Uso responsabile: prima di chiedere una chiamata outbound devi avere titolo a contattare quel numero e rispettare privacy e normative. L'utente che richiede la chiamata si assume la responsabilità dell'uso."
  },
  "attachments": {
    "storage_dir": "attachments",
    "max_bytes": 10000000,
    "allowed_mime_types": [
      "image/jpeg",
      "image/png",
      "application/pdf",
      "text/plain",
      "text/markdown"
    ]
  },
  "notifications": {
    "email_provider": "smtp",
    "sms_provider": "twilio",
    "whatsapp_provider": "twilio",
    "smtp_host": "",
    "smtp_port": 587,
    "smtp_timeout_seconds": 15,
    "smtp_username": "",
    "smtp_password": "",
    "smtp_use_tls": true,
    "smtp_from_email": "",
    "sms_from_number": "",
    "whatsapp_from_number": "",
    "twilio_messaging_service_sid": "",
    "max_attempts": 3,
    "retry_delay_seconds": 30
  },
  "llm_costs": {
    "daily_estimated_budget": 0.0,
    "currency": "USD",
    "gpt_realtime_whisper_audio_minute_price": 0.017,
    "pricing_overrides": []
  },
  "restaurant_connector": {
    "provider": "multi_agent",
    "webhook_url": "",
    "auth_token": "",
    "timeout_seconds": 8.0
  },
  "helpdesk_connector": {
    "provider": "multi_agent",
    "webhook_url": "",
    "auth_token": "",
    "timeout_seconds": 8.0
  },
  "hotel_connector": {
    "provider": "multi_agent",
    "webhook_url": "",
    "auth_token": "",
    "timeout_seconds": 8.0
  },
  "ecommerce_connector": {
    "provider": "multi_agent",
    "webhook_url": "",
    "auth_token": "",
    "timeout_seconds": 8.0
  },
  "dispatch_connector": {
    "provider": "multi_agent",
    "webhook_url": "",
    "auth_token": "",
    "timeout_seconds": 8.0
  },
  "custom_tools": [
    {
      "name": "custom_echo",
      "description": "Custom echo tool (stub).",
      "enabled": false,
      "provider": "stub",
      "webhook_url": null,
      "auth_token": null,
      "timeout_seconds": 1.0,
      "stub_delay_seconds": 0.0,
      "parameters": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          }
        },
        "required": [
          "message"
        ]
      },
      "response_schema": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "message": {
                "type": "string"
              }
            },
            "required": [
              "message"
            ]
          },
          "audit": {
            "type": "object"
          }
        },
        "required": [
          "ok",
          "data",
          "audit"
        ]
      }
    }
  ],
  "allow_stub_connectors": false,
  "post_call_retention_days": 7,
  "booking_fields": [
    {
      "key": "from_city",
      "label": "Città di partenza",
      "type": "text",
      "required": true,
      "default_value": null
    },
    {
      "key": "to_city",
      "label": "Destinazione",
      "type": "text",
      "required": true,
      "default_value": null
    },
    {
      "key": "passengers",
      "label": "Numero passeggeri",
      "type": "number",
      "required": true,
      "default_value": "1"
    }
  ]
}

Show JSON Schema (SettingsData)

{
  "$defs": {
    "AttachmentConfig": {
      "description": "Storage and validation rules for external media and documents.",
      "properties": {
        "storage_dir": {
          "default": "attachments",
          "title": "Storage Dir",
          "type": "string"
        },
        "max_bytes": {
          "default": 10000000,
          "minimum": 1,
          "title": "Max Bytes",
          "type": "integer"
        },
        "allowed_mime_types": {
          "items": {
            "type": "string"
          },
          "title": "Allowed Mime Types",
          "type": "array"
        }
      },
      "title": "AttachmentConfig",
      "type": "object"
    },
    "BookingField": {
      "description": "Definition of a single data field to be captured during a call.",
      "properties": {
        "key": {
          "maxLength": 64,
          "minLength": 1,
          "title": "Key",
          "type": "string"
        },
        "label": {
          "maxLength": 128,
          "minLength": 1,
          "title": "Label",
          "type": "string"
        },
        "type": {
          "default": "text",
          "enum": [
            "text",
            "number",
            "date",
            "time",
            "datetime",
            "phone"
          ],
          "title": "Type",
          "type": "string"
        },
        "required": {
          "default": true,
          "title": "Required",
          "type": "boolean"
        },
        "default_value": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Default Value"
        }
      },
      "required": [
        "key",
        "label"
      ],
      "title": "BookingField",
      "type": "object"
    },
    "ComplianceConfig": {
      "description": "Transparency and legal compliance settings for voice interactions.",
      "properties": {
        "recording_notice_enabled": {
          "default": true,
          "title": "Recording Notice Enabled",
          "type": "boolean"
        },
        "recording_notice_text": {
          "default": "Nota: la chiamata potrebbe essere registrata per finalità operative/diagnostiche e cancellata entro 24 ore.",
          "title": "Recording Notice Text",
          "type": "string"
        },
        "outbound_responsibility_notice_enabled": {
          "default": true,
          "title": "Outbound Responsibility Notice Enabled",
          "type": "boolean"
        },
        "outbound_responsibility_notice_text": {
          "default": "Uso responsabile: prima di chiedere una chiamata outbound devi avere titolo a contattare quel numero e rispettare privacy e normative. L'utente che richiede la chiamata si assume la responsabilità dell'uso.",
          "title": "Outbound Responsibility Notice Text",
          "type": "string"
        }
      },
      "title": "ComplianceConfig",
      "type": "object"
    },
    "ConnectorConfig": {
      "description": "Generic configuration for scenario backend connectors (e.g., restaurant, hotel).",
      "properties": {
        "provider": {
          "default": "multi_agent",
          "enum": [
            "stub",
            "webhook",
            "multi_agent"
          ],
          "title": "Provider",
          "type": "string"
        },
        "webhook_url": {
          "default": "",
          "title": "Webhook Url",
          "type": "string"
        },
        "auth_token": {
          "default": "",
          "title": "Auth Token",
          "type": "string"
        },
        "timeout_seconds": {
          "default": 8.0,
          "exclusiveMinimum": 0,
          "title": "Timeout Seconds",
          "type": "number"
        }
      },
      "title": "ConnectorConfig",
      "type": "object"
    },
    "CustomToolDefinition": {
      "additionalProperties": true,
      "description": "Definition for a user-defined tool that communicates via webhooks.",
      "properties": {
        "name": {
          "maxLength": 64,
          "minLength": 1,
          "title": "Name",
          "type": "string"
        },
        "description": {
          "maxLength": 256,
          "minLength": 1,
          "title": "Description",
          "type": "string"
        },
        "enabled": {
          "default": true,
          "title": "Enabled",
          "type": "boolean"
        },
        "provider": {
          "default": "stub",
          "enum": [
            "stub",
            "webhook"
          ],
          "title": "Provider",
          "type": "string"
        },
        "webhook_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Webhook Url"
        },
        "auth_token": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Auth Token"
        },
        "timeout_seconds": {
          "default": 1.0,
          "exclusiveMinimum": 0,
          "title": "Timeout Seconds",
          "type": "number"
        },
        "stub_delay_seconds": {
          "default": 0.0,
          "minimum": 0,
          "title": "Stub Delay Seconds",
          "type": "number"
        },
        "parameters": {
          "additionalProperties": true,
          "title": "Parameters",
          "type": "object"
        },
        "response_schema": {
          "additionalProperties": true,
          "title": "Response Schema",
          "type": "object"
        }
      },
      "required": [
        "name",
        "description",
        "parameters",
        "response_schema"
      ],
      "title": "CustomToolDefinition",
      "type": "object"
    },
    "FeatureFlags": {
      "description": "System-wide toggles for enabling/disabling specific modules and AI capabilities.",
      "properties": {
        "enable_contact_lookup": {
          "default": true,
          "title": "Enable Contact Lookup",
          "type": "boolean"
        },
        "enable_outbound_call": {
          "default": true,
          "title": "Enable Outbound Call",
          "type": "boolean"
        },
        "enable_route_estimate": {
          "default": false,
          "title": "Enable Route Estimate",
          "type": "boolean"
        },
        "enable_booking_capture": {
          "default": true,
          "title": "Enable Booking Capture",
          "type": "boolean"
        },
        "enable_server_recording": {
          "default": false,
          "title": "Enable Server Recording",
          "type": "boolean"
        },
        "enable_pairing": {
          "default": false,
          "title": "Enable Pairing",
          "type": "boolean"
        },
        "enable_kb_search": {
          "default": false,
          "title": "Enable Kb Search",
          "type": "boolean"
        },
        "enable_web_search": {
          "default": false,
          "title": "Enable Web Search",
          "type": "boolean"
        },
        "enable_restaurant_tools": {
          "default": false,
          "title": "Enable Restaurant Tools",
          "type": "boolean"
        },
        "enable_helpdesk_tools": {
          "default": false,
          "title": "Enable Helpdesk Tools",
          "type": "boolean"
        },
        "enable_hotel_tools": {
          "default": false,
          "title": "Enable Hotel Tools",
          "type": "boolean"
        },
        "enable_ecommerce_tools": {
          "default": false,
          "title": "Enable Ecommerce Tools",
          "type": "boolean"
        },
        "enable_dispatch_tools": {
          "default": false,
          "title": "Enable Dispatch Tools",
          "type": "boolean"
        },
        "enable_send_email": {
          "default": false,
          "title": "Enable Send Email",
          "type": "boolean"
        },
        "enable_notify_sms": {
          "default": false,
          "title": "Enable Notify Sms",
          "type": "boolean"
        },
        "enable_notify_whatsapp": {
          "default": false,
          "title": "Enable Notify Whatsapp",
          "type": "boolean"
        },
        "enable_post_call_processing": {
          "default": false,
          "title": "Enable Post Call Processing",
          "type": "boolean"
        },
        "enable_vision_analysis": {
          "default": false,
          "title": "Enable Vision Analysis",
          "type": "boolean"
        }
      },
      "title": "FeatureFlags",
      "type": "object"
    },
    "LLMCostConfig": {
      "description": "LLM/API provider cost monitoring settings.\n\nBudgets are warning-only. Runtime call blocking is intentionally not enabled\nhere because no existing product-level blocking setting exists.",
      "properties": {
        "daily_estimated_budget": {
          "minimum": 0,
          "title": "Daily Estimated Budget",
          "type": "number"
        },
        "currency": {
          "default": "USD",
          "title": "Currency",
          "type": "string"
        },
        "gpt_realtime_whisper_audio_minute_price": {
          "minimum": 0,
          "title": "Gpt Realtime Whisper Audio Minute Price",
          "type": "number"
        },
        "pricing_overrides": {
          "items": {
            "$ref": "#/$defs/LLMPricingOverride"
          },
          "title": "Pricing Overrides",
          "type": "array"
        }
      },
      "title": "LLMCostConfig",
      "type": "object"
    },
    "LLMPricingOverride": {
      "description": "Tenant/session override for LLM provider pricing rows.",
      "properties": {
        "provider": {
          "maxLength": 64,
          "minLength": 1,
          "title": "Provider",
          "type": "string"
        },
        "model": {
          "maxLength": 128,
          "minLength": 1,
          "title": "Model",
          "type": "string"
        },
        "unit_type": {
          "default": "text_tokens",
          "enum": [
            "text_tokens",
            "audio_tokens",
            "image_tokens",
            "audio_duration"
          ],
          "title": "Unit Type",
          "type": "string"
        },
        "input_price": {
          "anyOf": [
            {
              "minimum": 0,
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Input Price"
        },
        "output_price": {
          "anyOf": [
            {
              "minimum": 0,
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Output Price"
        },
        "cached_price": {
          "anyOf": [
            {
              "minimum": 0,
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Cached Price"
        },
        "audio_duration_price": {
          "anyOf": [
            {
              "minimum": 0,
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Audio Duration Price"
        },
        "currency": {
          "default": "USD",
          "title": "Currency",
          "type": "string"
        },
        "source_note": {
          "default": "settings override",
          "title": "Source Note",
          "type": "string"
        }
      },
      "required": [
        "provider",
        "model"
      ],
      "title": "LLMPricingOverride",
      "type": "object"
    },
    "NotificationConfig": {
      "description": "Configuration for SMTP and Twilio notification services.",
      "properties": {
        "email_provider": {
          "const": "smtp",
          "default": "smtp",
          "title": "Email Provider",
          "type": "string"
        },
        "sms_provider": {
          "const": "twilio",
          "default": "twilio",
          "title": "Sms Provider",
          "type": "string"
        },
        "whatsapp_provider": {
          "const": "twilio",
          "default": "twilio",
          "title": "Whatsapp Provider",
          "type": "string"
        },
        "smtp_host": {
          "default": "",
          "title": "Smtp Host",
          "type": "string"
        },
        "smtp_port": {
          "default": 587,
          "maximum": 65535,
          "minimum": 1,
          "title": "Smtp Port",
          "type": "integer"
        },
        "smtp_timeout_seconds": {
          "default": 15,
          "minimum": 1,
          "title": "Smtp Timeout Seconds",
          "type": "integer"
        },
        "smtp_username": {
          "default": "",
          "title": "Smtp Username",
          "type": "string"
        },
        "smtp_password": {
          "default": "",
          "title": "Smtp Password",
          "type": "string"
        },
        "smtp_use_tls": {
          "default": true,
          "title": "Smtp Use Tls",
          "type": "boolean"
        },
        "smtp_from_email": {
          "default": "",
          "title": "Smtp From Email",
          "type": "string"
        },
        "sms_from_number": {
          "default": "",
          "title": "Sms From Number",
          "type": "string"
        },
        "whatsapp_from_number": {
          "default": "",
          "title": "Whatsapp From Number",
          "type": "string"
        },
        "twilio_messaging_service_sid": {
          "default": "",
          "title": "Twilio Messaging Service Sid",
          "type": "string"
        },
        "max_attempts": {
          "default": 3,
          "minimum": 1,
          "title": "Max Attempts",
          "type": "integer"
        },
        "retry_delay_seconds": {
          "default": 30,
          "minimum": 0,
          "title": "Retry Delay Seconds",
          "type": "integer"
        }
      },
      "title": "NotificationConfig",
      "type": "object"
    },
    "OpenAIRealtimeConfig": {
      "description": "Configuration for the OpenAI Realtime API session.",
      "properties": {
        "model": {
          "title": "Model",
          "type": "string"
        },
        "voice": {
          "default": "coral",
          "title": "Voice",
          "type": "string"
        },
        "output_modalities": {
          "items": {
            "enum": [
              "audio",
              "text"
            ],
            "type": "string"
          },
          "title": "Output Modalities",
          "type": "array"
        },
        "audio_input_type": {
          "default": "audio/pcmu",
          "title": "Audio Input Type",
          "type": "string"
        },
        "audio_input_rate": {
          "default": 8000,
          "title": "Audio Input Rate",
          "type": "integer"
        },
        "audio_output_type": {
          "default": "audio/pcmu",
          "title": "Audio Output Type",
          "type": "string"
        },
        "transcription_model": {
          "title": "Transcription Model",
          "type": "string"
        },
        "transcription_fallback_model": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Transcription Fallback Model"
        },
        "transcription_prompt": {
          "default": "Telephone speech in Italian. Expect Italian city names, personal names, phone numbers, email-like spellings, and 6-digit pairing codes.",
          "title": "Transcription Prompt",
          "type": "string"
        },
        "input_noise_reduction": {
          "anyOf": [
            {
              "enum": [
                "near_field",
                "far_field"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": "near_field",
          "title": "Input Noise Reduction"
        },
        "reasoning_effort": {
          "title": "Reasoning Effort",
          "type": "string"
        },
        "temperature": {
          "default": 0.7,
          "title": "Temperature",
          "type": "number"
        },
        "max_output_tokens": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "const": "inf",
              "type": "string"
            }
          ],
          "default": "inf",
          "title": "Max Output Tokens"
        },
        "system_prompt": {
          "default": "You are a professional voice assistant. This system is a multi-scenario demo platform (bus, restaurant, helpdesk, hotel, e-commerce). Collect the necessary information, confirm details, and stay concise.",
          "title": "System Prompt",
          "type": "string"
        },
        "greeting_enabled": {
          "default": true,
          "title": "Greeting Enabled",
          "type": "boolean"
        },
        "greeting_prompt": {
          "default": "Hello! Do you have a 6-digit pairing code? You can say it aloud or type it on your phone keypad. If you don't have a code, we can continue without the live dashboard.",
          "title": "Greeting Prompt",
          "type": "string"
        },
        "turn_detection": {
          "anyOf": [
            {
              "$ref": "#/$defs/TurnDetectionConfig"
            },
            {
              "type": "null"
            }
          ]
        },
        "truncate_safety_ms": {
          "default": 150,
          "title": "Truncate Safety Ms",
          "type": "integer"
        },
        "conversation_style": {
          "anyOf": [
            {
              "enum": [
                "responsive",
                "balanced",
                "patient"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Conversation Style"
        }
      },
      "title": "OpenAIRealtimeConfig",
      "type": "object"
    },
    "RouteConfig": {
      "description": "Configuration for routing and route estimation providers.",
      "properties": {
        "provider": {
          "default": "none",
          "enum": [
            "none",
            "openrouteservice",
            "google_maps"
          ],
          "title": "Provider",
          "type": "string"
        }
      },
      "title": "RouteConfig",
      "type": "object"
    },
    "TelephonyConfig": {
      "description": "Security and compliance configuration for Twilio interactions.",
      "properties": {
        "outbound_from_number": {
          "default": "",
          "title": "Outbound From Number",
          "type": "string"
        },
        "fallback_to_caller_number": {
          "default": true,
          "title": "Fallback To Caller Number",
          "type": "boolean"
        },
        "use_phonenumbers": {
          "default": true,
          "title": "Use Phonenumbers",
          "type": "boolean"
        },
        "require_outbound_confirmation": {
          "default": true,
          "title": "Require Outbound Confirmation",
          "type": "boolean"
        },
        "outbound_max_calls_per_session": {
          "default": 3,
          "title": "Outbound Max Calls Per Session",
          "type": "integer"
        },
        "outbound_cooldown_seconds": {
          "default": 30,
          "title": "Outbound Cooldown Seconds",
          "type": "integer"
        },
        "block_emergency_numbers": {
          "default": true,
          "title": "Block Emergency Numbers",
          "type": "boolean"
        },
        "allowlist_countries": {
          "items": {
            "type": "string"
          },
          "title": "Allowlist Countries",
          "type": "array"
        },
        "denylist_numbers": {
          "items": {
            "type": "string"
          },
          "title": "Denylist Numbers",
          "type": "array"
        },
        "denylist_prefixes": {
          "items": {
            "type": "string"
          },
          "title": "Denylist Prefixes",
          "type": "array"
        },
        "outbound_unlimited_numbers": {
          "items": {
            "type": "string"
          },
          "title": "Outbound Unlimited Numbers",
          "type": "array"
        },
        "outbound_daily_max_per_caller": {
          "default": 5,
          "minimum": 0,
          "title": "Outbound Daily Max Per Caller",
          "type": "integer"
        },
        "max_call_duration_seconds": {
          "default": 180,
          "minimum": 0,
          "title": "Max Call Duration Seconds",
          "type": "integer"
        }
      },
      "title": "TelephonyConfig",
      "type": "object"
    },
    "TurnDetectionConfig": {
      "description": "Voice Activity Detection (VAD) configuration for the OpenAI Realtime session.\n\nDetermines how the AI detects user speech, handles interruptions, and triggers responses.\n\nTypes:\n- server_vad: Traditional VAD based on audio levels and silence detection\n- semantic_vad: AI-powered detection that understands when user finished speaking semantically\n(recommended for gpt-realtime-2.1, more natural conversation flow)",
      "properties": {
        "type": {
          "default": "semantic_vad",
          "enum": [
            "server_vad",
            "semantic_vad"
          ],
          "title": "Type",
          "type": "string"
        },
        "threshold": {
          "default": 0.5,
          "title": "Threshold",
          "type": "number"
        },
        "prefix_padding_ms": {
          "default": 300,
          "title": "Prefix Padding Ms",
          "type": "integer"
        },
        "silence_duration_ms": {
          "default": 500,
          "title": "Silence Duration Ms",
          "type": "integer"
        },
        "interrupt_response": {
          "default": true,
          "title": "Interrupt Response",
          "type": "boolean"
        },
        "create_response": {
          "default": true,
          "title": "Create Response",
          "type": "boolean"
        },
        "idle_timeout_ms": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Idle Timeout Ms"
        }
      },
      "title": "TurnDetectionConfig",
      "type": "object"
    },
    "WebSearchConfig": {
      "description": "Configuration for controlled web search capabilities.",
      "properties": {
        "provider": {
          "default": "duckduckgo_html",
          "enum": [
            "stub",
            "duckduckgo_html"
          ],
          "title": "Provider",
          "type": "string"
        },
        "cache_ttl_seconds": {
          "default": 300,
          "minimum": 1,
          "title": "Cache Ttl Seconds",
          "type": "integer"
        }
      },
      "title": "WebSearchConfig",
      "type": "object"
    }
  },
  "description": "The root configuration object for a tenant, encapsulating all system settings.",
  "properties": {
    "runtime_settings_policy_version": {
      "default": 1,
      "minimum": 0,
      "title": "Runtime Settings Policy Version",
      "type": "integer"
    },
    "app_mode": {
      "default": "dispatch",
      "enum": [
        "demo_router",
        "dispatch",
        "restaurant",
        "helpdesk",
        "hotel",
        "ecommerce",
        "call_center",
        "voice_assistant"
      ],
      "title": "App Mode",
      "type": "string"
    },
    "tenant_display_name": {
      "default": "Demo Tenant",
      "title": "Tenant Display Name",
      "type": "string"
    },
    "language": {
      "default": "en",
      "title": "Language",
      "type": "string"
    },
    "openai": {
      "$ref": "#/$defs/OpenAIRealtimeConfig"
    },
    "telephony": {
      "$ref": "#/$defs/TelephonyConfig"
    },
    "routes": {
      "$ref": "#/$defs/RouteConfig"
    },
    "features": {
      "$ref": "#/$defs/FeatureFlags"
    },
    "web_search": {
      "$ref": "#/$defs/WebSearchConfig"
    },
    "compliance": {
      "$ref": "#/$defs/ComplianceConfig"
    },
    "attachments": {
      "$ref": "#/$defs/AttachmentConfig"
    },
    "notifications": {
      "$ref": "#/$defs/NotificationConfig"
    },
    "llm_costs": {
      "$ref": "#/$defs/LLMCostConfig"
    },
    "restaurant_connector": {
      "$ref": "#/$defs/ConnectorConfig"
    },
    "helpdesk_connector": {
      "$ref": "#/$defs/ConnectorConfig"
    },
    "hotel_connector": {
      "$ref": "#/$defs/ConnectorConfig"
    },
    "ecommerce_connector": {
      "$ref": "#/$defs/ConnectorConfig"
    },
    "dispatch_connector": {
      "$ref": "#/$defs/ConnectorConfig"
    },
    "custom_tools": {
      "items": {
        "$ref": "#/$defs/CustomToolDefinition"
      },
      "title": "Custom Tools",
      "type": "array"
    },
    "allow_stub_connectors": {
      "default": false,
      "title": "Allow Stub Connectors",
      "type": "boolean"
    },
    "post_call_retention_days": {
      "default": 7,
      "minimum": 1,
      "title": "Post Call Retention Days",
      "type": "integer"
    },
    "booking_fields": {
      "items": {
        "$ref": "#/$defs/BookingField"
      },
      "title": "Booking Fields",
      "type": "array"
    }
  },
  "title": "SettingsData",
  "type": "object"
}

Tip: For production Twilio usage, BASE_URL must be https to get wss.

Settings

Quick Settings

Notifiche (SMTP/Twilio)

Scenario connectors (webhook)

Feature flags

Advanced JSON Editor