AI Sync

Working with AI Agents

Voice Agent Settings Reference

Every setting you can change by chat on V1 and V2 voice agents, with types, units, ranges and allowed values.

These are the settings you can change through Manage Voice Agents by Chat. Ask your assistant for a group by name, or a whole category.

Reading the tables. A dash means no limit is set for that value. Can clear means the field can be emptied on purpose. Default appears only where one value applies to every agent; otherwise, read the agent's current value. Several settings have two names for the same thing, and either works.

At a glance#

GroupCategoryV1V2
voice_languageVoice and language✅✅
welcome_messageConversation✅✅
conversationConversation✅✅
backchannelConversation—✅
natural_pausesConversation—✅
boosted_keywordsConversation✅✅
redialCall handling✅✅
memoryCall handling✅✅
max_durationCall handling✅✅
silenceCall handling✅✅
begin_message_delayCall handling✅—
pre_conversation_mediaCall handling—✅
voicemailCall handling✅✅
call_transferTransfers✅✅
integrationsIntegrations✅✅
inbound_field_mappingIntegrations✅✅
webhookIntegrations✅✅
end_callAdvanced✅✅
appointment_checkerAdvanced✅✅
calendarAdvanced✅✅
post_callAdvanced✅✅
live_callAdvanced✅✅
join_meetingAdvanced✅✅
complianceAdvanced✅✅
basicsAdvanced✅✅

Voice and language#

voice_language#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
ambient_soundstring——Yes—
ambient_sound_volumenumber—0 to 2No—
enable_backchannelboolean——No—
interruption_sensitivitynumber—0 to 1No—
languagestring——No—
normalize_for_speechboolean——No—
responsivenessnumber—0 to 1No—
voice_idstring——No—
voice_speednumber—0.5 to 2No—
voice_temperaturenumber—0 to 2No—
volumenumber—0 to 2No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
ambient_soundstring——Yes—
ambient_sound_volumenumber—0 to 1No—
languagestring——No—
language_switchingboolean——No—
modelstring——No—
voice_idstring——No—
voice_similaritynumber—0 to 1No—
voice_speednumber—0.7 to 1.2No—
voice_stabilitynumber—0 to 1No—
voice_stylenumber—0 to 1No—
voice_temperaturenumber—0 to 2No—
volumenumber—0 to 3No—

Conversation#

welcome_message#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
begin_messagestring——Yes—
llmbeginmsgstring—silent_YES, silent_NO, CustomYes—
llmbeginmsgValstring——Yes—
mode (required)string—user_initiates, ai_dynamic, ai_custom, silent_YES, silent_NO, CustomNo—
welcome_messagestring——Yes—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
delaynumberseconds0 to 10Yes—
llmbeginmsg (required)string—silent_YES, silent_NO, CustomNo—
llmbeginmsgValstring——Yes—
talkFirstDelaynumberseconds0 to 10Yes—
talk_first_delaynumberseconds0 to 10Yes—

conversation#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
backchannel_frequencynumber—0 to 1No—
backchannel_wordsarray——No—
enable_backchannelboolean——No—
interruption_sensitivitynumber—0 to 1No—
normalize_for_speechboolean——No—
reminder_max_countinteger—0 to 20No—
reminder_trigger_msintegermilliseconds0 to —No—
reminder_trigger_secondsnumberseconds0 to —No—
responsivenessnumber—0 to 1No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
interruption_sensitivitynumber—0 to 1No1
responsivenessnumber—0 to 1No1

backchannel#

V1: not available.

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
backchannel_frequencynumber—0 to 1No—
backchannel_wordsarray—1 to —No—
enable_backchannelboolean——No—

natural_pauses#

V1: not available.

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
enable_fillersboolean——No—
filler_phrasesarray—1 to 0No—

boosted_keywords#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
boosted_keywords (required)array——No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
boosted_keywords (required)array—1 to —No—

Call handling#

redial#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
redialinteger—0, 1No—
redial_afterintegerminutes0, 1, 2, 3, 4, 5, 10, 15, 20, 25, 30, 45, 60No—
redial_agent_idstring——Yes—
redial_voicemail_detectionstring—Yes, NoNo—
use_local_presencestring—Yes, NoNo—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
redialinteger—0, 1No—
redial_afterintegerminutes0, 1, 2, 3, 4, 5, 10, 15, 20, 25, 30, 45, 60No—
redial_agent_idstring——Yes—
redial_voicemail_detectionstring—Yes, NoNo—
use_local_presencestring—Yes, NoNo—

memory#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
memory_enabled (required)boolean——No—
memory_instructionsstring——Yes—
memory_retention_daysstringdays—Yes—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
memory_enabled (required)boolean——No—
memory_instructionsstring——Yes—
memory_retention_daysintegerdays0 to —Yes—

max_duration#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
maxDurationSecondsintegerseconds60 to 7200No—
max_call_duration_msintegermilliseconds60000 to —No—
max_call_duration_secnumberseconds60 to —No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
isEnabledboolean——No—
maxDurationInTransferSecondsintegerseconds60 to 14400No—
maxDurationSecondsintegerseconds60 to 7200No—

silence#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
endAfterSilenceThresholdSecondsintegerseconds10 to —Yes—
endWhenReminderLimitExceededboolean——No—
end_call_after_silence_msintegermilliseconds1000 to —No—
end_call_after_silence_secnumberseconds1 to —No—
isEnabledboolean——No—
maxReminderAttemptsinteger—0 to 10No—
reminderSilenceThresholdSecondsintegerseconds2 to 30No—
silenceEnableExtendedTimeoutboolean——No—
silence_timeout_msintegermilliseconds1000 to —No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
endAfterSilenceThresholdSecondsintegerseconds10 to —Yes—
endWhenReminderLimitExceededboolean——No—
isEnabledboolean——No—
maxReminderAttemptsinteger—0 to 10No—
reminderSilenceThresholdSecondsintegerseconds2 to 30No—
silenceEnableExtendedTimeoutboolean——No—

begin_message_delay#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
begin_message_delay_msintegermilliseconds0 to 60000No—
begin_message_delay_secnumberseconds0 to 60No—
delaynumberseconds0 to 60No—

V2: not available.

pre_conversation_media#

V1: not available.

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
enabledForInboundboolean——No—
enabledForOutboundboolean——No—
enabledForWebCallboolean——No—
isEnabledboolean——No—
mediaFilenamestring——Yes—

voicemail#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
action_typestring—hangup, prompt, static_textNo—
enable_voicemail_detectionboolean——No—
enabledboolean——No—
isEnabledboolean——No—
messagestring——Yes—
textstring——Yes—
voicemail_action_typestring—hangup, prompt, static_textYes—
voicemail_detection_timeout_msintegermilliseconds5000 to 120000No—
voicemail_message_textstring——Yes—
voicemail_optionarray——Yes—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
additionalInstructionsstring——Yes—
behaviorTypestring—static, smartV1Yes—
enable_smart_screeningboolean——No—
enable_voicemail_detectionboolean——No—
immediateDetectionboolean——No—
isEnabledboolean——No—
recognitionEnginestring——Yes—
screeningInstructionsstring——Yes—
screening_instructionsstring——Yes—
smartScreeningHandlingboolean——No—
staticPhrasestring——Yes—
voiceRecognitionEnabledboolean——No—
voicemailHandlingstring—hang_up, leave_messageNo—
voicemail_action_typestring—hangup, static_text, promptYes—
voicemail_detection_timeout_msintegermilliseconds5000 to 120000No—
voicemail_message_textstring——Yes—

Transfers#

call_transfer#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
autoGreetstring—0, 1, true, falseNo—
auto_greetboolean——No—
descriptionstring——Yes—
detectionTimeoutinteger—10 to 300No—
detection_timeoutinteger—10 to 300No—
displayedNumberTransferstring——Yes—
displayed_numberstring——Yes—
dynamicRoutingDescriptionstring——Yes—
dynamic_routing_descriptionstring——Yes—
extensionNumberstring—0, 1, true, falseNo—
extensionValuestring——Yes—
extension_numberboolean——No—
extension_valuestring——Yes—
humanDetectionstring—0, 1, true, falseNo—
human_detectionboolean——No—
isEnabledboolean——No—
navigateIVRstring—0, 1, true, falseNo—
navigateIVRDescriptionstring——Yes—
navigate_ivrboolean——No—
navigate_ivr_descriptionstring——Yes—
onHoldMusicstring—none, relaxing_sound, uplifting_beats, ringtoneYes—
on_hold_musicstring—none, relaxing_sound, uplifting_beats, ringtoneYes—
phoneNumberstring——Yes—
threeWayHandoffMessageDescriptionstring——Yes—
threeWayHandoffMessageTypestring—prompt, static_messageNo—
threeWayMessagestring—0, 1, true, falseNo—
three_way_handoff_message_descriptionstring——Yes—
three_way_handoff_message_typestring—prompt, static_messageNo—
three_way_messageboolean——No—
transferDescriptionstring——Yes—
transferDestinationTypestring—static, dynamicNo—
transferTypestring—warm, coldNo—
transfer_destination_typestring—static, dynamicNo—
transfer_numberstring——Yes—
typeTransferstring—warm, coldNo—
type_transferstring—warm, coldNo—
whisperHandoffMessageDescriptionstring——Yes—
whisperHandoffMessageTypestring—prompt, static_messageNo—
whisperMessagestring—0, 1, true, falseNo—
whisper_handoff_message_descriptionstring——Yes—
whisper_handoff_message_typestring—prompt, static_messageNo—
whisper_messageboolean——No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
auto_greetboolean——No—
businessRoutingModestring—always, scheduleNo—
businessRulesarray——No—
business_routing_modestring—always, scheduleNo—
business_rulesarray——No—
callerIdModestring—agentPhoneNumber, userPhoneNumberNo—
descriptionstring——Yes—
detection_timeoutinteger—1 to —No—
displayed_numberstring——Yes—
dynamic_routing_descriptionstring——Yes—
extension_numberboolean——No—
extension_valuestring——Yes—
failoverContinueConversationboolean——No—
failoverStaticPhrasestring——Yes—
failover_continue_conversationboolean——No—
failover_static_phrasestring——Yes—
fallbackDescriptionstring——Yes—
fallbackNumberstring——Yes—
fallback_descriptionstring——Yes—
fallback_numberstring——Yes—
human_detectionboolean——No—
isEnabledboolean——No—
navigate_ivrboolean——No—
navigate_ivr_descriptionstring——Yes—
on_hold_musicstring——Yes—
phoneNumberstring——Yes—
three_way_handoff_message_descriptionstring——Yes—
three_way_handoff_message_typestring—prompt, static_messageNo—
three_way_messageboolean——No—
transferTypestring—warm, cold, httpNo—
transfer_destination_typestring—static, dynamicNo—
transfer_numberstring——Yes—
type_transferstring—warm, cold, httpNo—
whisper_handoff_message_descriptionstring——Yes—
whisper_handoff_message_typestring—prompt, static_messageNo—
whisper_messageboolean——No—

Integrations#

integrations#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
send_recording_to_ghlstring——Yes—
send_transcription_to_ghlstring——Yes—
send_user_sentiment_to_ghlstring——Yes—
send_call_summary_to_ghlstring——Yes—
send_call_duration_to_ghl_filedstring——Yes—
send_agent_name_to_ghl_filedstring——Yes—
send_call_direction_to_ghlstring——Yes—
ghl_tag_on_answerdstring——Yes—
ghl_tag_on_no_answerdstring——Yes—
ghl_tag_on_busystring——Yes—
ghl_tag_on_inactivitystring——Yes—
ghl_tag_on_appointmentstring——Yes—
ghl_tag_on_voicemailstring——Yes—
ghl_tag_user_hangupstring——Yes—
ghl_tag_on_call_transferstring——Yes—
ghl_tag_on_failed_outbound_callstring——Yes—
glocation_idstring——Yes—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
send_recording_to_ghlstring——Yes—
send_transcription_to_ghlstring——Yes—
send_user_sentiment_to_ghlstring——Yes—
send_call_summary_to_ghlstring——Yes—
send_call_duration_to_ghl_filedstring——Yes—
send_agent_name_to_ghl_filedstring——Yes—
send_call_direction_to_ghlstring——Yes—
ghl_tag_on_answerdstring——Yes—
ghl_tag_on_no_answerdstring——Yes—
ghl_tag_on_busystring——Yes—
ghl_tag_on_inactivitystring——Yes—
ghl_tag_on_appointmentstring——Yes—
ghl_tag_on_voicemailstring——Yes—
ghl_tag_user_hangupstring——Yes—
ghl_tag_on_call_transferstring——Yes—
ghl_tag_on_failed_outbound_callstring——Yes—
glocation_idstring——Yes—

inbound_field_mapping#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
inbound_field_sourcestring—ghl, ai_syncNo—
mappings (required)array——No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
inbound_field_sourcestring—ghl, ai_syncNo—
mappings (required)array——No—

webhook#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
webhook_headersarray——Yes—
webhook_methodstring—GET, POSTYes—
webhook_urlurl—— to 2048Yes—
weebhook_endpoint_headersarray——Yes—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
webhook_headersarray——Yes—
webhook_methodstring—GET, POSTYes—
webhook_urlurl—— to 2048Yes—
weebhook_endpoint_headersarray——Yes—

Advanced#

end_call#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
descriptionstring——Yes—
endCallDescriptionstring——Yes—
isEnabledboolean——No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
description (required)string——No—
endCallDescription (required)string——No—

appointment_checker#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
blockstring—upcoming, past, allYes—
enabled (required)boolean——No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
blockstring—upcoming, past, allYes—
enabled (required)boolean——No—

calendar#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
appointment_titlestring——Yes—
bookAppointmentsOnstring—GHL, Rizler, CalendlyYes—
book_appointments_onstring—GHL, Rizler, CalendlyYes—
calendar_idstring——Yes—
calendar_namestring——Yes—
calendarghlstring——Yes—
calendarghlupaptstring——Yes—
calendarsarray—— to 10No—
calendlyEventTypestring——Yes—
calendlyEventTypeNamestring——Yes—
calendly_event_typestring——Yes—
calendly_event_type_namestring——Yes—
enabledboolean——No—
isEnabledboolean——No—
rizlerCalendarstring——Yes—
rizlerCalendarNamestring——Yes—
rizler_calendar_idstring——Yes—
rizler_calendar_namestring——Yes—
timezonestring——Yes—
timezoneSetupghlstring——Yes—
upcoming_daysintegerdays1 to —Yes—
user_info_fieldsarray——Yes—
usersInfoSetupghlarray——Yes—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
appointment_titlestring——Yes—
book_appointments_onstring—GHL, Rizler, Calendly, DecodaNo—
calendar_idstring——Yes—
calendar_namestring——Yes—
calendarsarray—— to 10No—
calendly_event_typestring——Yes—
calendly_event_type_namestring——Yes—
decoda_location_idstring——Yes—
decoda_organizer_idstring——Yes—
decoda_provider_idstring——Yes—
decoda_service_idstring——Yes—
enabledboolean——No—
rizler_calendar_idstring——Yes—
rizler_calendar_namestring——Yes—
timezonestring——Yes—
upcoming_daysintegerdays1 to —No—
user_info_fieldsarray——No—

post_call#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
aiSyncFieldsarray——No—
fieldsarray——No—
isEnabledboolean——No—
valueUserInfoarray——No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
aiSyncFieldsarray——No—
fieldsarray——No—
isEnabledboolean——No—

live_call#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
aiSyncFieldsarray——No—
fieldsarray——No—
isEnabledboolean——No—
moduleValarray——No—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
aiSyncFieldsarray——No—
fieldsarray——No—
isEnabledboolean——No—

join_meeting#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
descriptionstring——Yes—
enabledboolean——No—
google_calendarstring——Yes—
google_calendar_idstring——Yes—
isEnabledboolean——No—
joinMeetingDescriptionstring——Yes—
selectedCalendarstring——Yes—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
description (required)string——No—
enabledboolean——No—
google_calendar_idstring——Yes—
joinMeetingDescription (required)string——No—
selectedCalendarstring——Yes—

compliance#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
calling_daysarraydays—Yes—
calling_hours_endstring——Yes—
calling_hours_startstring——Yes—
calling_statesarray——Yes—
enforce_dncboolean——Yes—
enforce_state_legal_hoursboolean——Yes—
override_complianceboolean——Yes—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
calling_daysarraydays—Yes—
calling_hours_endstring——Yes—
calling_hours_startstring——Yes—
calling_statesarray——Yes—
enforce_dncboolean——Yes—
enforce_state_legal_hoursboolean——Yes—
override_complianceboolean——Yes—

basics#

V1

FieldTypeUnitRange or allowed valuesCan clearDefault
agent_namestring—— to 255No—
ai_timezone_idstring——Yes—
folder_idstring——Yes—
statusstring—Active, InactiveNo—

V2

FieldTypeUnitRange or allowed valuesCan clearDefault
agent_namestring—— to 255No—
ai_timezone_idstring——Yes—
folder_idstring——Yes—
statusstring—Active, InactiveNo—

Not changed through this flow#

Phone numbers, senders, pronunciation entries, knowledge bases, API functions and the widget each have their own add and remove tools. See Manage Voice Agents by Chat.