Asistanı güncelle

curl --request PUT \
  --url https://api.example.com/user/assistant/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "voice_id": 123,
  "language_id": 123,
  "type": "<string>",
  "mode": "<string>",
  "timezone": "<string>",
  "initial_message": "<string>",
  "system_prompt": "<string>",
  "llm_model_id": 123,
  "multimodal_model_id": 123,
  "chat_llm_fallback_id": 123,
  "turn_detection_threshold": 123,
  "secondary_language_ids": [
    123
  ],
  "knowledgebase_id": 123,
  "knowledgebase_mode": "<string>",
  "phone_number_id": 123,
  "tool_ids": [
    123
  ],
  "tools": [
    {}
  ],
  "tts_emotion_enabled": true,
  "voice_stability": 123,
  "voice_similarity": 123,
  "speech_speed": 123,
  "llm_temperature": 123,
  "synthesizer_provider_id": 123,
  "transcriber_provider_id": 123,
  "allow_interruptions": true,
  "fillers": true,
  "filler_config": {},
  "record": true,
  "enable_noise_cancellation": true,
  "wait_for_customer": true,
  "max_duration": 123,
  "max_silence_duration": 123,
  "max_initial_silence_duration": 123,
  "ringing_time": 123,
  "reengagement_interval": 123,
  "reengagement_prompt": "<string>",
  "end_call_on_voicemail": true,
  "voice_mail_message": "<string>",
  "endpoint_type": "<string>",
  "endpoint_sensitivity": 123,
  "interrupt_sensitivity": 123,
  "min_interrupt_words": 123,
  "ambient_sound": "<string>",
  "ambient_sound_volume": 123,
  "is_webhook_active": true,
  "webhook_url": "<string>",
  "send_webhook_only_on_completed": true,
  "include_recording_in_webhook": true,
  "post_call_evaluation": true,
  "post_call_schema": [
    {
      "name": "<string>",
      "type": "<string>",
      "description": "<string>"
    }
  ],
  "variables": {},
  "conversation_inactivity_timeout": 123,
  "conversation_ended_retrigger": true,
  "conversation_ended_webhook_url": "<string>"
}
'

import requests

url = "https://api.example.com/user/assistant/{id}"

payload = {
    "name": "<string>",
    "voice_id": 123,
    "language_id": 123,
    "type": "<string>",
    "mode": "<string>",
    "timezone": "<string>",
    "initial_message": "<string>",
    "system_prompt": "<string>",
    "llm_model_id": 123,
    "multimodal_model_id": 123,
    "chat_llm_fallback_id": 123,
    "turn_detection_threshold": 123,
    "secondary_language_ids": [123],
    "knowledgebase_id": 123,
    "knowledgebase_mode": "<string>",
    "phone_number_id": 123,
    "tool_ids": [123],
    "tools": [{}],
    "tts_emotion_enabled": True,
    "voice_stability": 123,
    "voice_similarity": 123,
    "speech_speed": 123,
    "llm_temperature": 123,
    "synthesizer_provider_id": 123,
    "transcriber_provider_id": 123,
    "allow_interruptions": True,
    "fillers": True,
    "filler_config": {},
    "record": True,
    "enable_noise_cancellation": True,
    "wait_for_customer": True,
    "max_duration": 123,
    "max_silence_duration": 123,
    "max_initial_silence_duration": 123,
    "ringing_time": 123,
    "reengagement_interval": 123,
    "reengagement_prompt": "<string>",
    "end_call_on_voicemail": True,
    "voice_mail_message": "<string>",
    "endpoint_type": "<string>",
    "endpoint_sensitivity": 123,
    "interrupt_sensitivity": 123,
    "min_interrupt_words": 123,
    "ambient_sound": "<string>",
    "ambient_sound_volume": 123,
    "is_webhook_active": True,
    "webhook_url": "<string>",
    "send_webhook_only_on_completed": True,
    "include_recording_in_webhook": True,
    "post_call_evaluation": True,
    "post_call_schema": [
        {
            "name": "<string>",
            "type": "<string>",
            "description": "<string>"
        }
    ],
    "variables": {},
    "conversation_inactivity_timeout": 123,
    "conversation_ended_retrigger": True,
    "conversation_ended_webhook_url": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    voice_id: 123,
    language_id: 123,
    type: '<string>',
    mode: '<string>',
    timezone: '<string>',
    initial_message: '<string>',
    system_prompt: '<string>',
    llm_model_id: 123,
    multimodal_model_id: 123,
    chat_llm_fallback_id: 123,
    turn_detection_threshold: 123,
    secondary_language_ids: [123],
    knowledgebase_id: 123,
    knowledgebase_mode: '<string>',
    phone_number_id: 123,
    tool_ids: [123],
    tools: [{}],
    tts_emotion_enabled: true,
    voice_stability: 123,
    voice_similarity: 123,
    speech_speed: 123,
    llm_temperature: 123,
    synthesizer_provider_id: 123,
    transcriber_provider_id: 123,
    allow_interruptions: true,
    fillers: true,
    filler_config: {},
    record: true,
    enable_noise_cancellation: true,
    wait_for_customer: true,
    max_duration: 123,
    max_silence_duration: 123,
    max_initial_silence_duration: 123,
    ringing_time: 123,
    reengagement_interval: 123,
    reengagement_prompt: '<string>',
    end_call_on_voicemail: true,
    voice_mail_message: '<string>',
    endpoint_type: '<string>',
    endpoint_sensitivity: 123,
    interrupt_sensitivity: 123,
    min_interrupt_words: 123,
    ambient_sound: '<string>',
    ambient_sound_volume: 123,
    is_webhook_active: true,
    webhook_url: '<string>',
    send_webhook_only_on_completed: true,
    include_recording_in_webhook: true,
    post_call_evaluation: true,
    post_call_schema: [{name: '<string>', type: '<string>', description: '<string>'}],
    variables: {},
    conversation_inactivity_timeout: 123,
    conversation_ended_retrigger: true,
    conversation_ended_webhook_url: '<string>'
  })
};

fetch('https://api.example.com/user/assistant/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/user/assistant/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'voice_id' => 123,
    'language_id' => 123,
    'type' => '<string>',
    'mode' => '<string>',
    'timezone' => '<string>',
    'initial_message' => '<string>',
    'system_prompt' => '<string>',
    'llm_model_id' => 123,
    'multimodal_model_id' => 123,
    'chat_llm_fallback_id' => 123,
    'turn_detection_threshold' => 123,
    'secondary_language_ids' => [
        123
    ],
    'knowledgebase_id' => 123,
    'knowledgebase_mode' => '<string>',
    'phone_number_id' => 123,
    'tool_ids' => [
        123
    ],
    'tools' => [
        [
                
        ]
    ],
    'tts_emotion_enabled' => true,
    'voice_stability' => 123,
    'voice_similarity' => 123,
    'speech_speed' => 123,
    'llm_temperature' => 123,
    'synthesizer_provider_id' => 123,
    'transcriber_provider_id' => 123,
    'allow_interruptions' => true,
    'fillers' => true,
    'filler_config' => [
        
    ],
    'record' => true,
    'enable_noise_cancellation' => true,
    'wait_for_customer' => true,
    'max_duration' => 123,
    'max_silence_duration' => 123,
    'max_initial_silence_duration' => 123,
    'ringing_time' => 123,
    'reengagement_interval' => 123,
    'reengagement_prompt' => '<string>',
    'end_call_on_voicemail' => true,
    'voice_mail_message' => '<string>',
    'endpoint_type' => '<string>',
    'endpoint_sensitivity' => 123,
    'interrupt_sensitivity' => 123,
    'min_interrupt_words' => 123,
    'ambient_sound' => '<string>',
    'ambient_sound_volume' => 123,
    'is_webhook_active' => true,
    'webhook_url' => '<string>',
    'send_webhook_only_on_completed' => true,
    'include_recording_in_webhook' => true,
    'post_call_evaluation' => true,
    'post_call_schema' => [
        [
                'name' => '<string>',
                'type' => '<string>',
                'description' => '<string>'
        ]
    ],
    'variables' => [
        
    ],
    'conversation_inactivity_timeout' => 123,
    'conversation_ended_retrigger' => true,
    'conversation_ended_webhook_url' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/user/assistant/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"voice_id\": 123,\n  \"language_id\": 123,\n  \"type\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"initial_message\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"llm_model_id\": 123,\n  \"multimodal_model_id\": 123,\n  \"chat_llm_fallback_id\": 123,\n  \"turn_detection_threshold\": 123,\n  \"secondary_language_ids\": [\n    123\n  ],\n  \"knowledgebase_id\": 123,\n  \"knowledgebase_mode\": \"<string>\",\n  \"phone_number_id\": 123,\n  \"tool_ids\": [\n    123\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"tts_emotion_enabled\": true,\n  \"voice_stability\": 123,\n  \"voice_similarity\": 123,\n  \"speech_speed\": 123,\n  \"llm_temperature\": 123,\n  \"synthesizer_provider_id\": 123,\n  \"transcriber_provider_id\": 123,\n  \"allow_interruptions\": true,\n  \"fillers\": true,\n  \"filler_config\": {},\n  \"record\": true,\n  \"enable_noise_cancellation\": true,\n  \"wait_for_customer\": true,\n  \"max_duration\": 123,\n  \"max_silence_duration\": 123,\n  \"max_initial_silence_duration\": 123,\n  \"ringing_time\": 123,\n  \"reengagement_interval\": 123,\n  \"reengagement_prompt\": \"<string>\",\n  \"end_call_on_voicemail\": true,\n  \"voice_mail_message\": \"<string>\",\n  \"endpoint_type\": \"<string>\",\n  \"endpoint_sensitivity\": 123,\n  \"interrupt_sensitivity\": 123,\n  \"min_interrupt_words\": 123,\n  \"ambient_sound\": \"<string>\",\n  \"ambient_sound_volume\": 123,\n  \"is_webhook_active\": true,\n  \"webhook_url\": \"<string>\",\n  \"send_webhook_only_on_completed\": true,\n  \"include_recording_in_webhook\": true,\n  \"post_call_evaluation\": true,\n  \"post_call_schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\"\n    }\n  ],\n  \"variables\": {},\n  \"conversation_inactivity_timeout\": 123,\n  \"conversation_ended_retrigger\": true,\n  \"conversation_ended_webhook_url\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.example.com/user/assistant/{id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"voice_id\": 123,\n  \"language_id\": 123,\n  \"type\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"initial_message\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"llm_model_id\": 123,\n  \"multimodal_model_id\": 123,\n  \"chat_llm_fallback_id\": 123,\n  \"turn_detection_threshold\": 123,\n  \"secondary_language_ids\": [\n    123\n  ],\n  \"knowledgebase_id\": 123,\n  \"knowledgebase_mode\": \"<string>\",\n  \"phone_number_id\": 123,\n  \"tool_ids\": [\n    123\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"tts_emotion_enabled\": true,\n  \"voice_stability\": 123,\n  \"voice_similarity\": 123,\n  \"speech_speed\": 123,\n  \"llm_temperature\": 123,\n  \"synthesizer_provider_id\": 123,\n  \"transcriber_provider_id\": 123,\n  \"allow_interruptions\": true,\n  \"fillers\": true,\n  \"filler_config\": {},\n  \"record\": true,\n  \"enable_noise_cancellation\": true,\n  \"wait_for_customer\": true,\n  \"max_duration\": 123,\n  \"max_silence_duration\": 123,\n  \"max_initial_silence_duration\": 123,\n  \"ringing_time\": 123,\n  \"reengagement_interval\": 123,\n  \"reengagement_prompt\": \"<string>\",\n  \"end_call_on_voicemail\": true,\n  \"voice_mail_message\": \"<string>\",\n  \"endpoint_type\": \"<string>\",\n  \"endpoint_sensitivity\": 123,\n  \"interrupt_sensitivity\": 123,\n  \"min_interrupt_words\": 123,\n  \"ambient_sound\": \"<string>\",\n  \"ambient_sound_volume\": 123,\n  \"is_webhook_active\": true,\n  \"webhook_url\": \"<string>\",\n  \"send_webhook_only_on_completed\": true,\n  \"include_recording_in_webhook\": true,\n  \"post_call_evaluation\": true,\n  \"post_call_schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\"\n    }\n  ],\n  \"variables\": {},\n  \"conversation_inactivity_timeout\": 123,\n  \"conversation_ended_retrigger\": true,\n  \"conversation_ended_webhook_url\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/user/assistant/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"voice_id\": 123,\n  \"language_id\": 123,\n  \"type\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"initial_message\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"llm_model_id\": 123,\n  \"multimodal_model_id\": 123,\n  \"chat_llm_fallback_id\": 123,\n  \"turn_detection_threshold\": 123,\n  \"secondary_language_ids\": [\n    123\n  ],\n  \"knowledgebase_id\": 123,\n  \"knowledgebase_mode\": \"<string>\",\n  \"phone_number_id\": 123,\n  \"tool_ids\": [\n    123\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"tts_emotion_enabled\": true,\n  \"voice_stability\": 123,\n  \"voice_similarity\": 123,\n  \"speech_speed\": 123,\n  \"llm_temperature\": 123,\n  \"synthesizer_provider_id\": 123,\n  \"transcriber_provider_id\": 123,\n  \"allow_interruptions\": true,\n  \"fillers\": true,\n  \"filler_config\": {},\n  \"record\": true,\n  \"enable_noise_cancellation\": true,\n  \"wait_for_customer\": true,\n  \"max_duration\": 123,\n  \"max_silence_duration\": 123,\n  \"max_initial_silence_duration\": 123,\n  \"ringing_time\": 123,\n  \"reengagement_interval\": 123,\n  \"reengagement_prompt\": \"<string>\",\n  \"end_call_on_voicemail\": true,\n  \"voice_mail_message\": \"<string>\",\n  \"endpoint_type\": \"<string>\",\n  \"endpoint_sensitivity\": 123,\n  \"interrupt_sensitivity\": 123,\n  \"min_interrupt_words\": 123,\n  \"ambient_sound\": \"<string>\",\n  \"ambient_sound_volume\": 123,\n  \"is_webhook_active\": true,\n  \"webhook_url\": \"<string>\",\n  \"send_webhook_only_on_completed\": true,\n  \"include_recording_in_webhook\": true,\n  \"post_call_evaluation\": true,\n  \"post_call_schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\"\n    }\n  ],\n  \"variables\": {},\n  \"conversation_inactivity_timeout\": 123,\n  \"conversation_ended_retrigger\": true,\n  \"conversation_ended_webhook_url\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Assistant updated successfully",
  "data": {
    "id": 789,
    "name": "Updated Sales Assistant",
    "status": "active",
    "type": "outbound",
    "mode": "pipeline"
  }
}

{
  "message": "Assistant not found"
}

{
  "message": "Validation failed",
  "errors": {
    "speech_speed": ["The speech speed must be between 0.7 and 1.2."],
    "voice_id": ["The selected voice is not compatible with the chosen engine type."],
    "allow_interruptions": ["Interruptions cannot be disabled in multimodal or dualplex mode."]
  }
}

PUT

user

assistant

{id}

Asistanı güncelle

curl --request PUT \
  --url https://api.example.com/user/assistant/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "voice_id": 123,
  "language_id": 123,
  "type": "<string>",
  "mode": "<string>",
  "timezone": "<string>",
  "initial_message": "<string>",
  "system_prompt": "<string>",
  "llm_model_id": 123,
  "multimodal_model_id": 123,
  "chat_llm_fallback_id": 123,
  "turn_detection_threshold": 123,
  "secondary_language_ids": [
    123
  ],
  "knowledgebase_id": 123,
  "knowledgebase_mode": "<string>",
  "phone_number_id": 123,
  "tool_ids": [
    123
  ],
  "tools": [
    {}
  ],
  "tts_emotion_enabled": true,
  "voice_stability": 123,
  "voice_similarity": 123,
  "speech_speed": 123,
  "llm_temperature": 123,
  "synthesizer_provider_id": 123,
  "transcriber_provider_id": 123,
  "allow_interruptions": true,
  "fillers": true,
  "filler_config": {},
  "record": true,
  "enable_noise_cancellation": true,
  "wait_for_customer": true,
  "max_duration": 123,
  "max_silence_duration": 123,
  "max_initial_silence_duration": 123,
  "ringing_time": 123,
  "reengagement_interval": 123,
  "reengagement_prompt": "<string>",
  "end_call_on_voicemail": true,
  "voice_mail_message": "<string>",
  "endpoint_type": "<string>",
  "endpoint_sensitivity": 123,
  "interrupt_sensitivity": 123,
  "min_interrupt_words": 123,
  "ambient_sound": "<string>",
  "ambient_sound_volume": 123,
  "is_webhook_active": true,
  "webhook_url": "<string>",
  "send_webhook_only_on_completed": true,
  "include_recording_in_webhook": true,
  "post_call_evaluation": true,
  "post_call_schema": [
    {
      "name": "<string>",
      "type": "<string>",
      "description": "<string>"
    }
  ],
  "variables": {},
  "conversation_inactivity_timeout": 123,
  "conversation_ended_retrigger": true,
  "conversation_ended_webhook_url": "<string>"
}
'

import requests

url = "https://api.example.com/user/assistant/{id}"

payload = {
    "name": "<string>",
    "voice_id": 123,
    "language_id": 123,
    "type": "<string>",
    "mode": "<string>",
    "timezone": "<string>",
    "initial_message": "<string>",
    "system_prompt": "<string>",
    "llm_model_id": 123,
    "multimodal_model_id": 123,
    "chat_llm_fallback_id": 123,
    "turn_detection_threshold": 123,
    "secondary_language_ids": [123],
    "knowledgebase_id": 123,
    "knowledgebase_mode": "<string>",
    "phone_number_id": 123,
    "tool_ids": [123],
    "tools": [{}],
    "tts_emotion_enabled": True,
    "voice_stability": 123,
    "voice_similarity": 123,
    "speech_speed": 123,
    "llm_temperature": 123,
    "synthesizer_provider_id": 123,
    "transcriber_provider_id": 123,
    "allow_interruptions": True,
    "fillers": True,
    "filler_config": {},
    "record": True,
    "enable_noise_cancellation": True,
    "wait_for_customer": True,
    "max_duration": 123,
    "max_silence_duration": 123,
    "max_initial_silence_duration": 123,
    "ringing_time": 123,
    "reengagement_interval": 123,
    "reengagement_prompt": "<string>",
    "end_call_on_voicemail": True,
    "voice_mail_message": "<string>",
    "endpoint_type": "<string>",
    "endpoint_sensitivity": 123,
    "interrupt_sensitivity": 123,
    "min_interrupt_words": 123,
    "ambient_sound": "<string>",
    "ambient_sound_volume": 123,
    "is_webhook_active": True,
    "webhook_url": "<string>",
    "send_webhook_only_on_completed": True,
    "include_recording_in_webhook": True,
    "post_call_evaluation": True,
    "post_call_schema": [
        {
            "name": "<string>",
            "type": "<string>",
            "description": "<string>"
        }
    ],
    "variables": {},
    "conversation_inactivity_timeout": 123,
    "conversation_ended_retrigger": True,
    "conversation_ended_webhook_url": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    voice_id: 123,
    language_id: 123,
    type: '<string>',
    mode: '<string>',
    timezone: '<string>',
    initial_message: '<string>',
    system_prompt: '<string>',
    llm_model_id: 123,
    multimodal_model_id: 123,
    chat_llm_fallback_id: 123,
    turn_detection_threshold: 123,
    secondary_language_ids: [123],
    knowledgebase_id: 123,
    knowledgebase_mode: '<string>',
    phone_number_id: 123,
    tool_ids: [123],
    tools: [{}],
    tts_emotion_enabled: true,
    voice_stability: 123,
    voice_similarity: 123,
    speech_speed: 123,
    llm_temperature: 123,
    synthesizer_provider_id: 123,
    transcriber_provider_id: 123,
    allow_interruptions: true,
    fillers: true,
    filler_config: {},
    record: true,
    enable_noise_cancellation: true,
    wait_for_customer: true,
    max_duration: 123,
    max_silence_duration: 123,
    max_initial_silence_duration: 123,
    ringing_time: 123,
    reengagement_interval: 123,
    reengagement_prompt: '<string>',
    end_call_on_voicemail: true,
    voice_mail_message: '<string>',
    endpoint_type: '<string>',
    endpoint_sensitivity: 123,
    interrupt_sensitivity: 123,
    min_interrupt_words: 123,
    ambient_sound: '<string>',
    ambient_sound_volume: 123,
    is_webhook_active: true,
    webhook_url: '<string>',
    send_webhook_only_on_completed: true,
    include_recording_in_webhook: true,
    post_call_evaluation: true,
    post_call_schema: [{name: '<string>', type: '<string>', description: '<string>'}],
    variables: {},
    conversation_inactivity_timeout: 123,
    conversation_ended_retrigger: true,
    conversation_ended_webhook_url: '<string>'
  })
};

fetch('https://api.example.com/user/assistant/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/user/assistant/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'voice_id' => 123,
    'language_id' => 123,
    'type' => '<string>',
    'mode' => '<string>',
    'timezone' => '<string>',
    'initial_message' => '<string>',
    'system_prompt' => '<string>',
    'llm_model_id' => 123,
    'multimodal_model_id' => 123,
    'chat_llm_fallback_id' => 123,
    'turn_detection_threshold' => 123,
    'secondary_language_ids' => [
        123
    ],
    'knowledgebase_id' => 123,
    'knowledgebase_mode' => '<string>',
    'phone_number_id' => 123,
    'tool_ids' => [
        123
    ],
    'tools' => [
        [
                
        ]
    ],
    'tts_emotion_enabled' => true,
    'voice_stability' => 123,
    'voice_similarity' => 123,
    'speech_speed' => 123,
    'llm_temperature' => 123,
    'synthesizer_provider_id' => 123,
    'transcriber_provider_id' => 123,
    'allow_interruptions' => true,
    'fillers' => true,
    'filler_config' => [
        
    ],
    'record' => true,
    'enable_noise_cancellation' => true,
    'wait_for_customer' => true,
    'max_duration' => 123,
    'max_silence_duration' => 123,
    'max_initial_silence_duration' => 123,
    'ringing_time' => 123,
    'reengagement_interval' => 123,
    'reengagement_prompt' => '<string>',
    'end_call_on_voicemail' => true,
    'voice_mail_message' => '<string>',
    'endpoint_type' => '<string>',
    'endpoint_sensitivity' => 123,
    'interrupt_sensitivity' => 123,
    'min_interrupt_words' => 123,
    'ambient_sound' => '<string>',
    'ambient_sound_volume' => 123,
    'is_webhook_active' => true,
    'webhook_url' => '<string>',
    'send_webhook_only_on_completed' => true,
    'include_recording_in_webhook' => true,
    'post_call_evaluation' => true,
    'post_call_schema' => [
        [
                'name' => '<string>',
                'type' => '<string>',
                'description' => '<string>'
        ]
    ],
    'variables' => [
        
    ],
    'conversation_inactivity_timeout' => 123,
    'conversation_ended_retrigger' => true,
    'conversation_ended_webhook_url' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/user/assistant/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"voice_id\": 123,\n  \"language_id\": 123,\n  \"type\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"initial_message\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"llm_model_id\": 123,\n  \"multimodal_model_id\": 123,\n  \"chat_llm_fallback_id\": 123,\n  \"turn_detection_threshold\": 123,\n  \"secondary_language_ids\": [\n    123\n  ],\n  \"knowledgebase_id\": 123,\n  \"knowledgebase_mode\": \"<string>\",\n  \"phone_number_id\": 123,\n  \"tool_ids\": [\n    123\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"tts_emotion_enabled\": true,\n  \"voice_stability\": 123,\n  \"voice_similarity\": 123,\n  \"speech_speed\": 123,\n  \"llm_temperature\": 123,\n  \"synthesizer_provider_id\": 123,\n  \"transcriber_provider_id\": 123,\n  \"allow_interruptions\": true,\n  \"fillers\": true,\n  \"filler_config\": {},\n  \"record\": true,\n  \"enable_noise_cancellation\": true,\n  \"wait_for_customer\": true,\n  \"max_duration\": 123,\n  \"max_silence_duration\": 123,\n  \"max_initial_silence_duration\": 123,\n  \"ringing_time\": 123,\n  \"reengagement_interval\": 123,\n  \"reengagement_prompt\": \"<string>\",\n  \"end_call_on_voicemail\": true,\n  \"voice_mail_message\": \"<string>\",\n  \"endpoint_type\": \"<string>\",\n  \"endpoint_sensitivity\": 123,\n  \"interrupt_sensitivity\": 123,\n  \"min_interrupt_words\": 123,\n  \"ambient_sound\": \"<string>\",\n  \"ambient_sound_volume\": 123,\n  \"is_webhook_active\": true,\n  \"webhook_url\": \"<string>\",\n  \"send_webhook_only_on_completed\": true,\n  \"include_recording_in_webhook\": true,\n  \"post_call_evaluation\": true,\n  \"post_call_schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\"\n    }\n  ],\n  \"variables\": {},\n  \"conversation_inactivity_timeout\": 123,\n  \"conversation_ended_retrigger\": true,\n  \"conversation_ended_webhook_url\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.example.com/user/assistant/{id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"voice_id\": 123,\n  \"language_id\": 123,\n  \"type\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"initial_message\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"llm_model_id\": 123,\n  \"multimodal_model_id\": 123,\n  \"chat_llm_fallback_id\": 123,\n  \"turn_detection_threshold\": 123,\n  \"secondary_language_ids\": [\n    123\n  ],\n  \"knowledgebase_id\": 123,\n  \"knowledgebase_mode\": \"<string>\",\n  \"phone_number_id\": 123,\n  \"tool_ids\": [\n    123\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"tts_emotion_enabled\": true,\n  \"voice_stability\": 123,\n  \"voice_similarity\": 123,\n  \"speech_speed\": 123,\n  \"llm_temperature\": 123,\n  \"synthesizer_provider_id\": 123,\n  \"transcriber_provider_id\": 123,\n  \"allow_interruptions\": true,\n  \"fillers\": true,\n  \"filler_config\": {},\n  \"record\": true,\n  \"enable_noise_cancellation\": true,\n  \"wait_for_customer\": true,\n  \"max_duration\": 123,\n  \"max_silence_duration\": 123,\n  \"max_initial_silence_duration\": 123,\n  \"ringing_time\": 123,\n  \"reengagement_interval\": 123,\n  \"reengagement_prompt\": \"<string>\",\n  \"end_call_on_voicemail\": true,\n  \"voice_mail_message\": \"<string>\",\n  \"endpoint_type\": \"<string>\",\n  \"endpoint_sensitivity\": 123,\n  \"interrupt_sensitivity\": 123,\n  \"min_interrupt_words\": 123,\n  \"ambient_sound\": \"<string>\",\n  \"ambient_sound_volume\": 123,\n  \"is_webhook_active\": true,\n  \"webhook_url\": \"<string>\",\n  \"send_webhook_only_on_completed\": true,\n  \"include_recording_in_webhook\": true,\n  \"post_call_evaluation\": true,\n  \"post_call_schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\"\n    }\n  ],\n  \"variables\": {},\n  \"conversation_inactivity_timeout\": 123,\n  \"conversation_ended_retrigger\": true,\n  \"conversation_ended_webhook_url\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/user/assistant/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"voice_id\": 123,\n  \"language_id\": 123,\n  \"type\": \"<string>\",\n  \"mode\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"initial_message\": \"<string>\",\n  \"system_prompt\": \"<string>\",\n  \"llm_model_id\": 123,\n  \"multimodal_model_id\": 123,\n  \"chat_llm_fallback_id\": 123,\n  \"turn_detection_threshold\": 123,\n  \"secondary_language_ids\": [\n    123\n  ],\n  \"knowledgebase_id\": 123,\n  \"knowledgebase_mode\": \"<string>\",\n  \"phone_number_id\": 123,\n  \"tool_ids\": [\n    123\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"tts_emotion_enabled\": true,\n  \"voice_stability\": 123,\n  \"voice_similarity\": 123,\n  \"speech_speed\": 123,\n  \"llm_temperature\": 123,\n  \"synthesizer_provider_id\": 123,\n  \"transcriber_provider_id\": 123,\n  \"allow_interruptions\": true,\n  \"fillers\": true,\n  \"filler_config\": {},\n  \"record\": true,\n  \"enable_noise_cancellation\": true,\n  \"wait_for_customer\": true,\n  \"max_duration\": 123,\n  \"max_silence_duration\": 123,\n  \"max_initial_silence_duration\": 123,\n  \"ringing_time\": 123,\n  \"reengagement_interval\": 123,\n  \"reengagement_prompt\": \"<string>\",\n  \"end_call_on_voicemail\": true,\n  \"voice_mail_message\": \"<string>\",\n  \"endpoint_type\": \"<string>\",\n  \"endpoint_sensitivity\": 123,\n  \"interrupt_sensitivity\": 123,\n  \"min_interrupt_words\": 123,\n  \"ambient_sound\": \"<string>\",\n  \"ambient_sound_volume\": 123,\n  \"is_webhook_active\": true,\n  \"webhook_url\": \"<string>\",\n  \"send_webhook_only_on_completed\": true,\n  \"include_recording_in_webhook\": true,\n  \"post_call_evaluation\": true,\n  \"post_call_schema\": [\n    {\n      \"name\": \"<string>\",\n      \"type\": \"<string>\",\n      \"description\": \"<string>\"\n    }\n  ],\n  \"variables\": {},\n  \"conversation_inactivity_timeout\": 123,\n  \"conversation_ended_retrigger\": true,\n  \"conversation_ended_webhook_url\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Assistant updated successfully",
  "data": {
    "id": 789,
    "name": "Updated Sales Assistant",
    "status": "active",
    "type": "outbound",
    "mode": "pipeline"
  }
}

{
  "message": "Assistant not found"
}

{
  "message": "Validation failed",
  "errors": {
    "speech_speed": ["The speech speed must be between 0.7 and 1.2."],
    "voice_id": ["The selected voice is not compatible with the chosen engine type."],
    "allow_interruptions": ["Interruptions cannot be disabled in multimodal or dualplex mode."]
  }
}

Bu endpoint, mevcut bir AI asistanının yapılandırmasını güncellemenize olanak tanır. Tüm alanlar isteğe bağlıdır - yalnızca güncellemek istediğiniz alanları sağlayın.

Yol Parametreleri

integer

gerekli

Güncellenecek asistanın benzersiz tanımlayıcısı

İstek Gövdesi

Temel Alanlar

string

Asistanın adı (maks. 255 karakter)

integer

Asistan için kullanılacak ses ID’si. Motor modunuz ile uyumlu sesleri almak için mode parametresi ile Get Voices endpoint’ini kullanın.

integer

Asistanın dil ID’si. Mevcut dilleri almak için Get Languages endpoint’ini kullanın.

string

Asistan türü. Seçenekler: inbound, outbound

string

Motor modu. Seçenekler: pipeline, multimodal, dualplex

Modun değiştirilmesi, moda özel ayarları yeni modun varsayılan değerlerine sıfırlar.

string

Asistanın saat dilimi (ör. “Europe/Bucharest”, “America/New_York”)

string

Arama başladığında asistanın söyleyeceği ilk mesaj (maks. 200 karakter)

string

Asistanın davranışını ve kişiliğini tanımlayan sistem istemi

Moda Özel Alanlar

integer

Kullanılacak LLM model ID’si. Yalnızca pipeline modu için geçerlidir.Mevcut modelleri almak için Get Models endpoint’ini kullanın.

integer

Multimodal model ID’si. Yalnızca multimodal ve dualplex modları için geçerlidir.Mevcut multimodal modelleri almak için Get Models endpoint’ini kullanın.

integer

Multimodal/dualplex modlarında araç çağrıları için yedek LLM model ID’si. Kaldırmak için null olarak ayarlayın.

number

Multimodal/dualplex modları için konuşma sırası algılama hassasiyeti (0-1). Otomatik için null olarak ayarlayın.

İkincil Diller

integer[]

Asistanın konuşabileceği ek dil ID’lerinin dizisi. Mevcut ikincil dilleri değiştirir. Tüm ikincil dilleri kaldırmak için boş bir dizi [] gönderin.

"secondary_language_ids": [2, 3, 4]

Bilgi Bankası Ayarları

integer

Eklenecek bilgi bankası ID’si. Bilgi bankasını kaldırmak için null olarak ayarlayın.

string

Bilgi bankasının nasıl kullanılacağı. Seçenekler:

function_call - AI arama yapmak için bir fonksiyon çağırır (multimodal/dualplex için zorunlu)
prompt - Bilgi isteme enjekte edilir (yalnızca pipeline)

Telefon Numarası

integer

Atanacak telefon numarasının ID’si. Atamayı kaldırmak için null olarak ayarlayın. Hesabınıza ait olmalıdır.

inbound asistanlar için telefon numarası Arayan Kimliği türünde olamaz ve başka bir inbound asistana zaten atanmış olamaz.

Özel Görüşme İçi Araçlar

integer[]

Senkronize edilecek özel görüşme içi araç ID’lerinin dizisi. Mevcut tüm araç atamalarını değiştirir. Tüm araçları kaldırmak için boş bir dizi [] gönderin. Her araç hesabınıza ait olmalıdır.

"tool_ids": [1, 5, 12]

Yerleşik Araçlar

array

Yerleşik araçların dizisi. Mevcut tüm yerleşik araçları değiştirir. Tüm araçları kaldırmak için boş bir dizi [] gönderin.

Göster Araç türleri

call_transfer - Aramayı başka bir telefon numarasına aktarır

phone_number (zorunlu): Aktarılacak telefon numarası
description: Aramanın ne zaman aktarılacağı
custom: Doğru ise, AI aktarım numarasını dinamik olarak belirleyebilir
timezone: Aktarım müsaitliği için saat dilimi
warm_transfer: Aktarmadan önce müşteriye bir mesaj gönderir (varsayılan: false)
warm_transfer_message: AI’ya aktarmadan önce ne söyleyeceğini bildiren istem (ör. “Tell the customer that the call is being transferred.”)

warm_call_transfer - Yönetici bilgilendirmeli sıcak aktarım

supervisor_phone (zorunlu): Sıcak aktarım için aranacak telefon numarası (ör. “+14155552001”). custom_sip etkinleştirilmişse, bunun yerine bir SIP adresi veya dahili hat numarasıdır.
outbound_phone_id (zorunlu): Yöneticiyi aramak için kullanılan telefon numarasının ID’si.
description (zorunlu): Ne zaman aktarılacağı — AI’ın sıcak aktarımı ne zaman başlatması gerektiğini açıklar (ör. “Transfer the call to a human supervisor when the customer requests to speak with a real person.”)
custom_sip: Telefon numarası yerine özel bir SIP adresi veya dahili hat numarası girmek için etkinleştirin (varsayılan: false)
caller_id_mode: Yöneticinin aramayı alırken gördüğü telefon numarası. Seçenekler: outbound_number (varsayılan — giden telefon numarasını gösterir), customer_number (arayanın numarasını gösterir), custom (özel bir numara gösterir)
custom_caller_id: Yöneticiye gösterilen özel telefon numarası. Yalnızca caller_id_mode değeri custom olduğunda kullanılır.
hold_music: Arayan beklemedeyken çalınan ses. Seçenekler: hold_music (varsayılan — varsayılan bekleme müziğini çalar), none (sessizlik, müzik yok)
hold_music_volume: Bekleme müziği ses seviyesi, 0-100 (varsayılan: 80)
hold_message: Arayanı beklemeye almadan önce söylenen mesaj (varsayılan: “Please hold while I connect you with a supervisor.”)
summary_instructions: AI’ın yöneticiyi arama hakkında nasıl bilgilendirmesi gerektiğine dair talimatlar (varsayılan: “Introduce the conversation from your perspective:\n- WHO is calling (name, company if mentioned)\n- WHY they called (their goal or problem)\n- WHY a human is needed at this point\n\nKeep it brief (2-3 sentences).”)
briefing_initial_message: AI’ın yönetici cevapladığında söylediği ilk mesaj (varsayılan: “Hello! I have a caller on the line who needs your assistance. May I brief you on the situation?”)
connected_message: Yönetici bağlandıktan sonra arayana söylenen mesaj (varsayılan: “You are now connected with a supervisor. I’ll leave you to it.”)

end_call - Aramayı programlı olarak sonlandırır

description: AI’ın aramayı ne zaman sonlandırması gerektiği

dtmf_input - DTMF tonları gönderir (tuş takımı girişi)

description: DTMF girişinin ne zaman kullanılacağı (IVR navigasyonu için)

collect_keypad - Arayandan tuş takımı girişi toplar

timeout: Giriş için bekleme süresi (saniye), 1-30 (varsayılan: 5)
stop_key: Girişi sonlandıran tuş. Seçenekler: # (varsayılan), *

calendar_integration - Cal.com üzerinden randevu planlar

calcom_api_key (zorunlu): Cal.com API anahtarınız
calcom_event_slug (zorunlu): Cal.com’dan etkinlik türü slug’ı
calcom_team_slug: Etkinlik bir Cal.com takımına aitse takım slug’ı
calcom_endpoint: Cal.com API bölgesi. Seçenekler: us (varsayılan — https://api.cal.com), eu (https://api.cal.eu), custom (calcom_custom_endpoint kullanır)
calcom_custom_endpoint: Özel Cal.com API temel URL’si. Yalnızca calcom_endpoint değeri custom olduğunda kullanılır (ör. https://my-calcom-instance.com).
calcom_booking_fields: Etkinlik için özel rezervasyon alanları dizisi. Her alanın özellikleri:
- slug (zorunlu): Alan tanımlayıcısı
- type (zorunlu): Alan türü (ör. “text”, “email”, “phone”, “select”)
- label (zorunlu): Görüntüleme etiketi
- required: Alanın zorunlu olup olmadığı (varsayılan: false)
- options: Seçim alanları için seçenek dizisi
description: Randevu planlamanın ne zaman teklif edileceği

"tools": [
  {
    "type": "dtmf_input",
    "description": "Navigate IVR when needed"
  },
  {
    "type": "warm_call_transfer",
    "supervisor_phone": "+1234567890",
    "outbound_phone_id": 7,
    "description": "Transfer the call to a human supervisor when the customer requests to speak with a real person.",
    "custom_sip": false,
    "caller_id_mode": "outbound_number",
    "hold_music": "hold_music",
    "hold_music_volume": 80,
    "hold_message": "Please hold while I connect you with a supervisor.",
    "summary_instructions": "Introduce the conversation from your perspective:\n- WHO is calling (name, company if mentioned)\n- WHY they called (their goal or problem)\n- WHY a human is needed at this point\n\nKeep it brief (2-3 sentences).",
    "briefing_initial_message": "Hello! I have a caller on the line who needs your assistance. May I brief you on the situation?",
    "connected_message": "You are now connected with a supervisor. I'll leave you to it."
  },
  {
    "type": "collect_keypad",
    "timeout": 5,
    "stop_key": "#"
  },
  {
    "type": "end_call",
    "description": "End call when done"
  }
]

Ses ve TTS Ayarları

boolean

Duygusal metin-konuşma sentezinin etkinleştirilip etkinleştirilmeyeceği

number

Ses kararlılık ayarı (0-1). Yüksek = daha tutarlı ses

number

Ses benzerlik ayarı (0-1). Yüksek = orijinal sese daha yakın

number

Konuşma hızı çarpanı (0.7-1.2)

number

LLM sıcaklık ayarı (0-1). Düşük = daha belirleyici

integer

Özel TTS sağlayıcı ID’si. Dil varsayılanını kullanmak için null olarak ayarlayın. Mevcut sağlayıcıları keşfetmek için Get Synthesizer Providers endpoint’ini kullanın.

integer

Özel STT sağlayıcı ID’si. Yalnızca pipeline modu. Dil varsayılanını kullanmak için null olarak ayarlayın. Mevcut sağlayıcıları keşfetmek için Get Transcriber Providers endpoint’ini kullanın.

Arama Davranış Ayarları

boolean

Arayan kişinin sözünü kesmesine izin verilip verilmeyeceği.

multimodal ve dualplex modları için devre dışı bırakılamaz.

boolean

İşleme sırasında dolgu sesi kullanılıp kullanılmayacağı.

Yalnızca pipeline modu için kullanılabilir.

object

Kategoriye göre özel dolgu kelime profilleri. Mevcut dolgu yapılandırmasını değiştirir. Her kategori kısa ifadelerden oluşan bir dizidir.

positive: Olumlu/onaylayıcı yanıtlar için dolgu kelimeleri
negative: Olumsuz/nötr yanıtlar için dolgu kelimeleri
question: Bir soru işlenirken kullanılan dolgu kelimeleri
neutral: Nötr onay için dolgu kelimeleri

"filler_config": {
  "positive": ["Great!", "Perfect!"],
  "negative": ["Hmm.", "I see."],
  "question": ["Good question.", "Let me check."],
  "neutral": ["Ok.", "Noted."]
}

boolean

Aramanın kaydedilip kaydedilmeyeceği

boolean

Gürültü engellemenin etkinleştirilip etkinleştirilmeyeceği

boolean

Doğru ise, asistan müşterinin önce konuşmasını bekler

Zamanlama Ayarları

integer

Saniye cinsinden maksimum arama süresi (20-1200)

integer

Yeniden etkileşimden önce saniye cinsinden maksimum sessizlik süresi (1-360)

integer

Aramayı sonlandırmadan önce arama başlangıcındaki maksimum sessizlik (1-120 saniye). Devre dışı bırakmak için null olarak ayarlayın.

integer

Vazgeçmeden önce maksimum çalma süresi (1-60 saniye)

Yeniden Etkileşim Ayarları

integer

Saniye cinsinden yeniden etkileşim aralığı (7-600)

string

Yeniden etkileşim mesajları için özel istem (maks. 1000 karakter). Varsayılanı kullanmak için null olarak ayarlayın.

Sesli Mesaj Ayarları

boolean

Sesli mesaj algılandığında aramanın sonlandırılıp sonlandırılmayacağı

string

Kapatmadan önce sesli mesaja bırakılacak mesaj (maks. 1000 karakter). Devre dışı bırakmak için null olarak ayarlayın.

Uç Nokta Algılama

string

Ses aktivite algılama türü. Seçenekler: vad, ai

number

Uç nokta hassasiyet seviyesi (0-5)

number

Kesinti hassasiyet seviyesi (0-5)

integer

Kesintiye izin verilmeden önce minimum kelime sayısı (0-10). Devre dışı bırakmak için null olarak ayarlayın.

Ortam Sesi

string

Arka plan ortam sesi. Seçenekler: off, office, city, forest, crowded_room, cafe, nature

number

Ortam sesi ses seviyesi (0-1)

Webhook Yapılandırması

boolean

Webhook bildirimlerinin etkin olup olmadığı

string

Arama sonrası bildirimler için webhook URL’si. Kaldırmak için null olarak ayarlayın.

boolean

Webhook’ların yalnızca tamamlanan aramalarda gönderilip gönderilmeyeceği (başarısız/cevaplanmayan aramalar hariç)

boolean

Webhook yüküne kayıt URL’sinin dahil edilip edilmeyeceği

Arama Sonrası Değerlendirme

boolean

AI arama sonrası değerlendirmenin etkinleştirilip etkinleştirilmeyeceği

array

Arama sonrası veri çıkarma için şema tanımı. Mevcut şemayı değiştirir.

Göster post_call_schema properties

string

gerekli

Alan adı (3-16 karakter, küçük harf, yalnızca alfanümerik ve alt çizgi)

string

gerekli

Veri türü. Seçenekler: string, number, bool

string

gerekli

Bu alanın neyi temsil ettiğinin açıklaması (3-255 karakter)

Değişkenler

object

Özel değişkenlerin anahtar-değer çiftleri. Mevcut tüm değişkenleri değiştirir.

"variables": {
  "company_name": "Acme Corp",
  "product": "Premium Widget"
}

Görüşme Sona Erme Ayarları

integer

Görüşmenin sona ermiş sayılmasından önceki sohbet hareketsizlik süresi (dakika) (1-1440). Devre dışı bırakmak için null olarak ayarlayın. Varsayılan: 30

boolean

Hareketsizlik nedeniyle sona erdikten sonra görüşmenin yeniden tetiklenmesine izin verilip verilmeyeceği

string

Sohbet görüşmesi hareketsizlik nedeniyle sona erdiğinde çağrılan webhook URL’si. Kaldırmak için null olarak ayarlayın. Ana arama webhook’undan bağımsızdır.

Örnek İstekler

Temel Ayarları Güncelle

{
  "name": "Updated Assistant Name",
  "initial_message": "Hello! How may I assist you?",
  "max_duration": 900
}

Multimodal Moda Geç

{
  "mode": "multimodal",
  "voice_id": 41,
  "multimodal_model_id": 1,
  "chat_llm_fallback_id": 2,
  "knowledgebase_mode": "function_call"
}

Araçları ve Bilgi Bankasını Güncelle

{
  "tool_ids": [1, 5, 12],
  "knowledgebase_id": 3,
  "knowledgebase_mode": "prompt"
}

Yeniden Etkileşim ve Sesli Mesajı Güncelle

{
  "reengagement_interval": 15,
  "reengagement_prompt": "Are you still there? I'm here to help.",
  "end_call_on_voicemail": true,
  "voice_mail_message": "Hello, please call us back at your convenience."
}

İsteğe Bağlı Ayarları Kaldır

{
  "phone_number_id": null,
  "webhook_url": null,
  "tool_ids": [],
  "secondary_language_ids": []
}

Yanıt

string

Asistan güncellemesini onaylayan başarı mesajı

object

Göster properties

integer

Güncellenen asistanın benzersiz tanımlayıcısı

string

Asistanın adı

string

Asistanın mevcut durumu

string

Türü (inbound veya outbound)

string

Motor modu (pipeline, multimodal veya dualplex)

{
  "message": "Assistant updated successfully",
  "data": {
    "id": 789,
    "name": "Updated Sales Assistant",
    "status": "active",
    "type": "outbound",
    "mode": "pipeline"
  }
}

{
  "message": "Assistant not found"
}

{
  "message": "Validation failed",
  "errors": {
    "speech_speed": ["The speech speed must be between 0.7 and 1.2."],
    "voice_id": ["The selected voice is not compatible with the chosen engine type."],
    "allow_interruptions": ["Interruptions cannot be disabled in multimodal or dualplex mode."]
  }
}

Notlar

Yalnızca istek gövdesinde sağladığınız alanlar güncellenecektir
İsteğe bağlı alanları kaldırmak için açıkça null olarak ayarlayın
Dizileri temizlemek (araçlar, ikincil diller) için boş bir dizi [] gönderin
Asistan, kimlik doğrulaması yapılmış kullanıcıya ait olmalıdır
Uyumlu sesleri almak için mode parametresi ile Get Voices endpoint’ini kullanın
Multimodal/dualplex modları için knowledgebase_mode değeri function_call olmalıdır
Multimodal/dualplex modları için allow_interruptions devre dışı bırakılamaz
Modun değiştirilmesi moda özel ayarları sıfırlar (LLM modeli, multimodal model, sağlayıcılar)

​Yol Parametreleri

​İstek Gövdesi

​Temel Alanlar

​Moda Özel Alanlar

​İkincil Diller

​Bilgi Bankası Ayarları

​Telefon Numarası

​Özel Görüşme İçi Araçlar

​Yerleşik Araçlar

​Ses ve TTS Ayarları

​Arama Davranış Ayarları

​Zamanlama Ayarları

​Yeniden Etkileşim Ayarları

​Sesli Mesaj Ayarları

​Uç Nokta Algılama

​Ortam Sesi

​Webhook Yapılandırması

​Arama Sonrası Değerlendirme

​Değişkenler

​Görüşme Sona Erme Ayarları

​Örnek İstekler

​Temel Ayarları Güncelle

​Multimodal Moda Geç

​Araçları ve Bilgi Bankasını Güncelle

​Yeniden Etkileşim ve Sesli Mesajı Güncelle

​İsteğe Bağlı Ayarları Kaldır

​Yanıt

​Notlar

Yol Parametreleri

İstek Gövdesi

Temel Alanlar

Moda Özel Alanlar

İkincil Diller

Bilgi Bankası Ayarları

Telefon Numarası

Özel Görüşme İçi Araçlar

Yerleşik Araçlar

Ses ve TTS Ayarları

Arama Davranış Ayarları

Zamanlama Ayarları

Yeniden Etkileşim Ayarları

Sesli Mesaj Ayarları

Uç Nokta Algılama

Ortam Sesi

Webhook Yapılandırması

Arama Sonrası Değerlendirme

Değişkenler

Görüşme Sona Erme Ayarları

Örnek İstekler

Temel Ayarları Güncelle

Multimodal Moda Geç

Araçları ve Bilgi Bankasını Güncelle

Yeniden Etkileşim ve Sesli Mesajı Güncelle

İsteğe Bağlı Ayarları Kaldır

Yanıt

Notlar