Масив от вградени инструменти за активиране. Всеки инструмент има type и полета специфични за инструмента.
Show Типове инструменти
call_transfer - Прехвърля обаждането към друг телефонен номер
phone_number (задължително): Телефонен номер за прехвърляне (напр. “+1234567890”)
description: Кога да се прехвърли обаждането
custom: Ако е true, AI може да определи номера за прехвърляне динамично
timezone: Часова зона за достъпност на прехвърлянето
warm_transfer: Изпрати съобщение на клиента преди прехвърляне (по подразбиране: false)
warm_transfer_message: Prompt който казва на AI какво да каже преди прехвърляне (напр. “Tell the customer that the call is being transferred.”)
warm_call_transfer - Топло прехвърляне с briefing на супервизора
supervisor_phone (задължително): Телефонен номер за набиране за топлото прехвърляне (напр. “+14155552001”). Ако custom_sip е активиран, това е SIP адрес или вътрешен номер.
outbound_phone_id (задължително): ID на телефонния номер използван за набиране на супервизора. Използвайте Get Phone Numbers за да намерите налични номера.
description (задължително): Кога да се прехвърли — описва кога AI трябва да инициира топлото прехвърляне (напр. “Transfer the call to a human supervisor when the customer requests to speak with a real person.”)
custom_sip: Активирайте за да въведете персонализиран SIP адрес или вътрешен номер вместо телефонен номер (по подразбиране: false)
caller_id_mode: Какъв телефонен номер вижда супервизорът при получаване на обаждането. Опции: outbound_number (по подразбиране — показва outbound телефонния номер), customer_number (показва номера на обаждащия се), custom (показва персонализиран номер)
custom_caller_id: Персонализиран телефонен номер показван на супервизора. Използва се само когато caller_id_mode е custom.
hold_music: Аудио изпълнявано на обаждащия се докато чака. Опции: hold_music (по подразбиране — изпълнява музика по подразбиране за чакане), none (тишина, без музика)
hold_music_volume: Ниво на звука за музиката при чакане, 0-100 (по подразбиране: 80)
hold_message: Съобщение изговаряно на обаждащия се преди да го поставят на чакане (по подразбиране: “Please hold while I connect you with a supervisor.”)
summary_instructions: Инструкции за това как AI трябва да информира супервизора за обаждането (по подразбиране: “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 казва на супервизора когато отговори (по подразбиране: “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.”)
end_call - Приключи обаждането програмно
description: Кога AI трябва да приключи обаждането
dtmf_input - Изпрати DTMF тонове (въвеждане с клавиатура)
description: Кога да се използва DTMF въвеждане (за IVR навигация)
collect_keypad - Събери въвеждане с клавиатура от обаждащия се
timeout: Секунди за чакане на въвеждане, 1-30 (по подразбиране: 5)
stop_key: Клавиш който приключва въвеждането. Опции: # (по подразбиране), *
calendar_integration - Планирай срещи чрез Cal.com
calcom_api_key (задължително): Вашият Cal.com API ключ
calcom_event_slug (задължително): Slug-ът на типа събитие от Cal.com
calcom_team_slug: Team slug ако събитието принадлежи на Cal.com екип
calcom_endpoint: Cal.com API регион. Опции: us (по подразбиране — https://api.cal.com), eu (https://api.cal.eu), custom (използва calcom_custom_endpoint)
calcom_custom_endpoint: Персонализиран Cal.com API базов URL. Използва се само когато calcom_endpoint е custom (напр. https://my-calcom-instance.com).
calcom_booking_fields: Масив от персонализирани полета за резервация за събитието. Всяко поле има:
slug (задължително): Идентификатор на полето
type (задължително): Тип поле (напр. “text”, “email”, “phone”, “select”)
label (задължително): Етикет за показване
required: Дали полето е задължително (по подразбиране: false)
options: Масив от опции за select полета
description: Кога да се предложи планиране
"tools": [ { "type": "call_transfer", "phone_number": "+1234567890", "description": "Transfer when customer requests human support" }, { "type": "warm_call_transfer", "supervisor_phone": "+1234567891", "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 customer confirms satisfaction" }]
ID на персонализиран TTS доставчик. Избира се автоматично на базата на езика, ако не е предоставено. Използвайте Get Synthesizer Providers endpoint за да откриете наличните доставчици.
ID на персонализиран STT доставчик. Избира се автоматично на базата на езика, ако не е предоставено. Само за pipeline режим. Използвайте Get Transcriber Providers endpoint за да откриете наличните доставчици.
Персонализирани профили за filler думи по категория. Ако не са предоставени, се задават по подразбиране на базата на езика на асистента. Всяка категория е масив от кратки фрази.
positive: Filler думи за позитивни/утвърдителни отговори (напр. “Great!”, “Perfect!”)
negative: Filler думи за негативни/неутрални отговори (напр. “Hmm.”, “Mhm.”)
question: Filler думи при обработка на въпрос (напр. “Hmm.”, “Let me think.”)
neutral: Filler думи за неутрални потвърждения (напр. “Ok.”, “I understand.”)
"filler_config": { "positive": ["Super!", "Great!", "Perfect!"], "negative": ["Hmm.", "Mhm.", "I see."], "question": ["Hmm.", "Let me check.", "Good question."], "neutral": ["Ok.", "I understand.", "Noted."]}
{ "name": "Sales Assistant", "voice_id": 1, "language_id": 1, "type": "outbound", "mode": "pipeline", "timezone": "Europe/Bucharest", "initial_message": "Hello! How can I help you today?", "system_prompt": "You are a professional sales assistant...", "llm_model_id": 2, "secondary_language_ids": [2, 3], "knowledgebase_id": 1, "knowledgebase_mode": "prompt", "fillers": true, "filler_config": { "positive": ["Great!", "Perfect!", "Awesome!"], "negative": ["Hmm.", "I see."], "question": ["Good question.", "Let me check."], "neutral": ["Ok.", "Noted.", "I understand."] }, "tool_ids": [1, 5], "tools": [ { "type": "end_call", "description": "End call when customer is satisfied" }, { "type": "call_transfer", "phone_number": "+1234567890", "description": "Transfer to support" }, { "type": "warm_call_transfer", "supervisor_phone": "+1234567891", "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": "#" } ], "reengagement_interval": 20, "reengagement_prompt": "Are you still there?"}
