---
title: "Уграђени алати"
description: "Наведите ThunderPhone агентима да заврше позиве, преусмере позиваоце, користе тастатуре, чекају на вези, претражују базу знања, пуштају звукове и шаљу е-поруке."
---

Уграђене алатке омогућавају агенту да обавља уобичајене радње у позиву без повезивања са Вашим API-јем. Већина је аутоматски доступна; е-пошта, звукови и претрага знања појављују се тек након што конфигуришете повезано подешавање или извор. У упиту наведите агенту када да користи сваку радњу.

| Алатка | Користите за | Како да је омогућите | Подржани позиви |
| --- | --- | --- | --- |
| `end_call` | Завршетак довршеног разговора | Увек доступно | Телефон, Talk у прегледачу, виџет, симулација и Realtime |
| `transfer_call` | Преусмеравање телефонског позиваоца | Конфигуришите усмеравање у упиту | Обични телефонски позиви; уграђени Realtime са `call_events` може да користи хладан пренос. Realtime са сачуваним агентом га не укључује. |
| `send_keypad_input` | Притискање тастера у телефонском менију | Увек доступно за обичне телефонске позиве | Телефонски позиви; уграђени одлазни Realtime са `call_events`. Realtime са сачуваним агентом га не укључује. |
| `no_response` | Наставак слушања док аутоматизовани мени говори | Увек доступно | Све врсте позива |
| `wait_on_hold` | Тихо чекање да се особа врати | Укључено у одлазним позивима | Одлазни телефонски позиви и одлазне уграђене Realtime сесије |
| `search_knowledge_base` | Одговарање на основу приложених извора | Приложите знање агенту | Позиви са сачуваним агентом и приложеним знањем |
| `play_sound` | Репродуковање конфигурисаног звука обавештења | **Напредно → Звук алатке** | Позиви са сачуваним агентом |
| `send_email` | Слање е-поште једном фиксном примаоцу | **Напредно → Пошаљи е-пошту** | Позиви са сачуваним агентом |

## `end_call`

Завршава тренутни позив када упит наложи моделу да то уради. Подразумевано је доступна и нема подешавање агента.

У упит унесите услов и сваку потребну опроштајну поруку:

```text
When the caller confirms they need nothing else, say goodbye and end the call.
```

Обичан позив који модел заврши има `end_reason: "ai_hangup"`. Прекид због трајања или стања може уместо тога да користи конкретнији разлог завршетка.

## `transfer_call`

Преусмерава телефонског позиваоца на фиксни број који наводи модел. Хладан пренос је тренутан. Проверени топли пренос приватно позива одредиште пре повезивања страна. Топли пренос захтева верификовани увезени VoIP број који може да упућује одлазне позиве.

У упит унесите одредишни број и тачан услов усмеравања:

```text
If the caller asks for billing, transfer them to +15551234567.
```

Успешан хладан пренос има `end_reason: "ai_transfer"`; довршена топла предаја има `end_reason: "ai_warm_transfer"`. Неуспео топли покушај враћа контролу агенту, па каснији завршетак позива одређује његов разлог завршетка. У сесијама које нису телефонски позиви, захтев за пренос уместо тога завршава сесију.

Погледајте [Преусмеравање позива](/sr/guides/call-transfers) за подешавање у контролној табли и путем API-ја, усмеравање, проверу, обраду неуспеха, ограничења и тестирање.

## `send_keypad_input`

Шаље DTMF цифре телефонске тастатуре `0`–`9`, `*` и `#` телефонској линији. Модел га користи за кретање кроз IVR, аутоматизовани мени који од позивалаца тражи да притисну тастере. Подразумевано је доступна и нема подешавање агента.

Наведите моделу кроз које меније сме да се креће и одакле потичу тражене вредности. Немојте тражити од њега да погађа опције менија:

```text
Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.
```

Платформа уклања неподржане знакове и шаље важеће цифре по редоследу. Ако не остане ниједна важећа цифра или позив не може да пошаље унос са тастатуре, неуспех се враћа агенту како би могао да се опорави.

## `no_response`

Одржава агента тихим док аутоматизовани систем још говори или тражи од њега да настави да слуша. Није намењена за поздрав живе особе, питање или стварни ред чекања. Подразумевано је доступна и нема подешавање агента.

Обично је уграђени опис довољан. За позиве са много IVR менија, појачајте ограничење у упиту:

```text
Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.
```

Ова радња не завршава позив.

## `wait_on_hold`

Ставља одлазног агента у стање тихог чекања док се жива особа не врати.
Модел га користи само након што друга страна изричито каже да ставља агента
на чекање. Аутоматски је доступан у одлазним позивима и нема подешавање на
контролној табли.

```text
If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.
```

Немојте упућивати агента да га користи за IVR поруку „молимо сачекајте“. Чекање
подразумевано траје до 15 минута. За уобичајене одлазне позиве, `POST /v1/call`
прихвата позитивноцелобројни параметар `max_hold_seconds`; уграђени Realtime
ограничава `max_hold_seconds` на 10–900 секунди. Ако се особа
врати, агент наставља без промене разлога завршетка позива. Ако ограничење
истекне, платформа завршава позив са `end_reason: "ai_hangup"`.

## `search_knowledge_base`

Претражује документе приложене агенту и враћа релевантне одломке. Приложите
базу знања или појединачне документе знања да бисте је омогућили, а затим
реците моделу који одговори морају потицати из тих извора:

```text
Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.
```

Ако претрага не успе, резултат се враћа агенту. Погледајте [База
знања](/sr/guides/knowledge-base) за подешавање контролне табле и API-ја.

## `play_sound`

Репродукује подешени звук обавештења агента након сваког говора у истом
потезу. На контролној табли подесите **Напредно → Звук алатке** на **Звончић**, **Динг**
или **Бип**, а затим примените агента. **Ништа** уклања алатку.

Са [Agents API](/api-reference/agents), припремите `play_sound_asset` као
`"chime"`, `"ding"` или `"beep"`, а затим примените. Подесите на `""` да бисте
онемогућили алатку.

```text
After confirming that an appointment was saved, say "You're all set" and play
the notification sound.
```

Неуспех репродукције се враћа агенту и не завршава позив.

## `send_email`

Шаље е-поруку у обичном тексту једином примаоцу кога је конфигурисао власник
агента. Модел наводи предмет и тело поруке. Никада не види параметар примаоца
и не може да изабере или промени адресу.

На контролној табли омогућите **Напредно → Пошаљи е-поруку**, сачувајте адресу
примаоца, а затим примените агента. Са [Agents API](/api-reference/agents), припремите и
`send_email_enabled: true` и непразан `send_email_recipient`, а затим примените.
Упитом дефинишите окидач и обавезан садржај:

```text
When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.
```

Позив може покушати да пошаље највише три е-поруке. Сваки предмет је ограничен
на 300 знакова, а свако тело на 20.000 знакова. Недостајућа конфигурација,
неважећи садржај, ограничење по позиву и неуспеси испоруке враћају се агенту.
Неуспела испорука и даље користи један од три покушаја.

Тестирајте са контролисаним примаоцем пре шире примене. Talk у прегледачу и
симулације шаљу стварну е-пошту; не постоји режим пробног покретања.

## Напомена о компатибилности

Подешавање **Напредно → Обавештења која се не могу прекинути** и застарело
поље `speak_uninterruptible_enabled` остају ради компатибилности, али њихово
омогућавање нема ефекта. Оставите подешавање искљученим; ниједан упит не може
активирати ову алатку.

За обавезно обавештење на почетку позива користите **Обавештење о пристанку**. Оно се
репродукује дословно пре уобичајеног разговора и не може се прекинути. Погледајте [Закони о пристанку за
снимање позива](/sr/guides/recording-consent-laws).

## Тестирајте и надгледајте уграђене алатке

Користите Talk у прегледачу или симулацију да бисте проверили упите, претрагу
знања, звукове и е-пошту. Та окружења не могу да репродукују понашање телефонске
мреже. Тестирајте навигацију тастатуром и чекање у одлазном телефонском позиву,
а комплетан топли пренос тестирајте у стварном позиву користећи одговарајући
увезени VoIP број. Подршка за Realtime је ограничена како је приказано у табели изнад.

## Позиви, цене и вебхукови

Уграђене радње немају накнаду по коришћењу алата. Уобичајене накнаде за позиве и добављаче
се и даље примењују; погледајте [Цене](/sr/guides/pricing). Њихови позиви и резултати могу се појавити
у завршеном транскрипту, али не емитују `telephony.tool` или `web.tool`.
Ти догађаји су за [функције које дефинише корисник](/sr/tools/overview). Само завршено
прекидање везе или преусмеравање мења `end_reason` позива; остали неуспеси се враћају
агенту. За евиденцију позива погледајте [вебхукове о завршетку](/sr/webhooks/call-complete).