Creates a new voice assistant. Do not call it unless the user asks explicitly; do not invent fields such as name and language — ask. Defaults: engine 'cascade', llm_model 'openai/gpt-5.4-nano'. Unknown fields are rejected.
View input schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the assistant."
},
"language": {
"type": "string",
"description": "Spoken language, e.g. 'tr' or 'en'."
},
"system_prompt": {
"type": "string",
"description": "Behaviour instructions for the assistant."
},
"llm_model": {
"type": "string",
"enum": [
"openrouter/auto",
"openai/gpt-5.4-nano",
"openai/gpt-5.4-mini",
"openai/gpt-5.4",
"openai/gpt-5.4-pro",
"openai/gpt-4.1-nano",
"openai/gpt-4.1-mini",
"openai/gpt-4.1",
"anthropic/claude-sonnet-4.6",
"anthropic/claude-opus-4.6",
"anthropic/claude-opus-4.6-fast",
"google/gemini-3-flash-preview",
"deepseek/deepseek-chat-v3-0324",
"deepseek/deepseek-r1",
"meta-llama/llama-4-scout",
"meta-llama/llama-4-maverick",
"x-ai/grok-4.20",
"mistralai/mistral-small-2603",
"mistralai/mistral-medium-3",
"minimax/minimax-m2.5",
"qwen/qwen3.5-flash-02-23",
"qwen/qwen3.5-plus-02-15",
"qwen/qwen3-max-thinking",
"cohere/command-a",
"google/gemma-3-27b-it",
"openai/gpt-4o-mini",
"openai/gpt-4o"
],
"description": "LLM used by the cascade engine (OpenRouter id). Ignored by the realtime engine."
},
"engine": {
"type": "string",
"enum": [
"cascade",
"realtime"
],
"description": "'cascade' (speech-to-text, LLM, text-to-speech; default) or 'realtime' (GPT Realtime speech-to-speech, pricier per minute, needs an 'openai-*' voice)."
},
"temperature": {
"type": "number",
"minimum": 0,
"maximum": 2,
"description": "LLM sampling temperature (0-2)."
},
"voice_id": {
"type": "string",
"description": "Voice id from call2me_list_voices. Realtime engine needs an 'openai-*' voice; cascade cannot use 'openai-*' voices."
},
"builtin_functions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"end_call",
"transfer_call",
"hold_call",
"schedule_callback",
"dtmf_input"
]
},
"description": "Built-in actions the assistant may take during a call (replaces the list)."
},
"begin_message": {
"type": "string",
"description": "First sentence of every call (used when begin_message_mode is 'static')."
},
"begin_message_mode": {
"type": "string",
"enum": [
"static",
"dynamic"
],
"description": "'static' says begin_message as-is; 'dynamic' lets the LLM write the greeting."
},
"end_call_message": {
"type": "string",
"description": "Goodbye sentence said before hanging up."
},
"knowledge_base_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Knowledge base ids the assistant searches (replaces the list)."
},
"post_call_actions": {
"type": "array",
"items": {
"type": "object"
},
"description": "Actions to run after each call."
},
"post_call_extraction": {
"type": "array",
"items": {
"type": "object"
},
"description": "Data fields to extract from each call."
},
"webhook_url": {
"type": "string",
"description": "URL that receives call events."
},
"transfer_targets": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"required": [
"name",
"type",
"value"
],
"properties": {
"name": {
"type": "string",
"description": "Department name the caller asks for."
},
"type": {
"type": "string",
"enum": [
"phone",
"sip",
"agent",
"external",
"queue"
]
},
"value": {
"type": "string",
"description": "E.164 number, sip: URI, or agent id."
}
}
},
"description": "Where the assistant may transfer calls (replaces the list). A phone transfer is a billed outbound call; restricted destinations are refused."
},
"enable_recording": {
"type": "boolean",
"description": "Record calls (adds a per-minute fee)."
},
"enable_vcon_export": {
"type": "boolean",
"description": "Allow call2me_get_call_transcript to return vCon."
},
"max_call_duration_ms": {
"type": "integer",
"minimum": 60000,
"maximum": 7200000,
"description": "Hard cap on one call's length in ms (60000-7200000, default 3600000). Calls are billed per second, so this is also the most one call can cost."
},
"reminder_message_frequency_ms": {
"type": "integer",
"minimum": 3000,
"maximum": 60000,
"description": "After this much caller silence (ms, 3000-60000) the assistant speaks a reminder."
},
"reminder_max_count": {
"type": "integer",
"minimum": 0,
"maximum": 5,
"description": "Reminders before the call is ended for silence (0-5; 0 turns off reminders AND silence hang-up, so a silent line stays open, and billed, until max_call_duration_ms). Silence hang-up time is about reminder_message_frequency_ms x (count + 1)."
},
"responsiveness": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "How fast the assistant replies after the caller stops (0 patient, 1 immediate)."
},
"interruption_sensitivity": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "How easily the caller can interrupt (0 hard, 1 easy; below 0.1 disables interruptions)."
},
"enable_backchannel": {
"type": "boolean",
"description": "Short listening sounds ('mm-hm') while the caller talks."
},
"backchannel_words": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"maxLength": 30
},
"description": "Custom backchannel words (empty list = language defaults)."
},
"post_call_extraction_model": {
"type": "string",
"enum": [
"openai/gpt-5.4-nano",
"openai/gpt-5.4-mini",
"openai/gpt-4.1-nano",
"openai/gpt-4.1-mini",
"openai/gpt-4o-mini",
"google/gemini-3-flash-preview",
"qwen/qwen3.5-flash-02-23",
"deepseek/deepseek-chat-v3-0324"
],
"description": "LLM that extracts post_call_extraction fields after each call (low-cost models only)."
},
"metadata": {
"type": "object",
"description": "Your own key/value data on the assistant. MERGED into the existing metadata (a key set to null is removed). The 'custom_functions' key cannot be set here."
},
"voicemail_detection_enabled": {
"type": "boolean",
"description": "Outbound calls only: if the other side sounds like an answering machine (\"leave a message\", \"not available\"...), apply voicemail_action. Silence alone is NOT treated as voicemail."
},
"voicemail_detection_timeout_ms": {
"type": "integer",
"minimum": 2000,
"maximum": 15000,
"description": "How long after the opening line to listen for an answering-machine greeting (ms)."
},
"voicemail_action": {
"type": "string",
"enum": [
"hangup",
"leave_message"
],
"description": "hangup = end the call; leave_message = say voicemail_message, then end."
},
"voicemail_message": {
"type": "string",
"maxLength": 500,
"description": "Message left on voicemail; {{variables}} are filled per call."
}
},
"required": [
"name"
],
"additionalProperties": false
}