---
title: "Zana zilizojengewa ndani"
description: "Waelekeze ejenti wa ThunderPhone kumaliza simu, kuhamisha wapigaji simu, kutumia vitufe vya simu, kusubiri kwenye holdi, kutafuta maarifa, kucheza sauti na kutuma barua pepe."
---

Zana zilizojengewa ndani humwezesha ejenti kutekeleza vitendo vya kawaida vya simu bila kuunganisha API yako mwenyewe. Nyingi zinapatikana kiotomatiki; barua pepe, sauti na utafutaji wa maarifa huonekana tu baada ya kusanidi mpangilio au chanzo husika. Mwambie ejenti wakati wa kutumia kila tendo kwenye prompt yake.

| Zana | Itumie kwa | Jinsi ya kuiwezesha | Simu zinazotumika |
| --- | --- | --- | --- |
| `end_call` | Kukamilisha mazungumzo yaliyomalizika | Inapatikana kila wakati | Simu, Talk ya kivinjari, wijeti, uigaji na Realtime |
| `transfer_call` | Kuelekeza mpigaji simu | Sanidi uelekezaji kwenye prompt | Simu za kawaida; Realtime ya ndani yenye `call_events` inaweza kutumia uhamisho wa moja kwa moja. Realtime ya ejenti iliyohifadhiwa haijumuishi zana hii. |
| `send_keypad_input` | Kubonyeza vitufe katika menyu ya simu | Inapatikana kila wakati kwenye simu za kawaida | Simu; Realtime ya ndani ya kutoka yenye `call_events`. Realtime ya ejenti iliyohifadhiwa haijumuishi zana hii. |
| `no_response` | Kuendelea kusikiliza huku menyu otomatiki ikiongea | Inapatikana kila wakati | Aina zote za simu |
| `wait_on_hold` | Kusubiri kimya mtu arudi | Imejumuishwa kwenye simu za kutoka | Vipindi vya simu za kutoka na Realtime ya ndani ya kutoka |
| `search_knowledge_base` | Kujibu kutoka kwenye vyanzo vilivyoambatishwa | Ambatisha maarifa kwa ejenti | Simu za ejenti iliyohifadhiwa zenye maarifa yaliyoambatishwa |
| `play_sound` | Kucheza sauti ya arifa iliyosanidiwa | **Advanced → Tool sound** | Simu za ejenti iliyohifadhiwa |
| `send_email` | Kutuma barua pepe kwa mpokeaji mmoja maalum | **Advanced → Send email** | Simu za ejenti iliyohifadhiwa |

## `end_call`

Hukomesha simu ya sasa wakati prompt inapoielekeza modeli kufanya hivyo. Inapatikana kwa chaguomsingi na haina mpangilio wa ejenti.

Andika sharti na salamu yoyote ya kuaga inayohitajika kwenye prompt:

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

Simu ya kawaida inayokatishwa na modeli huwa na `end_reason: "ai_hangup"`. Kukatishwa kwa sababu ya muda au salio kunaweza kutumia sababu mahususi zaidi ya kukatisha badala yake.

## `transfer_call`

Humhamisha mpigaji simu kwenda kwenye nambari maalum inayotolewa na modeli. Uhamisho wa moja kwa moja hutekelezwa mara moja. Uhamisho wa kuunganisha uliokaguliwa hupigia faraghani mahali panakopelekwa kabla ya kuwaunganisha wahusika. Uhamisho wa kuunganisha unahitaji nambari ya VoIP iliyoingizwa na kuthibitishwa inayoweza kupiga simu za kutoka.

Weka nambari ya mahali panakopelekwa na sharti kamili la uelekezaji kwenye prompt:

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

Uhamisho wa moja kwa moja uliofanikiwa huwa na `end_reason: "ai_transfer"`; uunganishaji uliokamilika huwa na `end_reason: "ai_warm_transfer"`. Jaribio la uhamisho wa kuunganisha lisilofaulu hurudisha udhibiti kwa ejenti, kwa hivyo kukatishwa kwa simu baadaye ndiko huamua sababu yake ya kukatisha. Kwenye vipindi visivyo vya simu, ombi la uhamisho hukomesha kipindi badala yake.

Tazama [Hamisha simu](/sw/guides/call-transfers) kwa usanidi wa dashibodi na API, uelekezaji, ukaguzi, ushughulikiaji wa hitilafu, vikomo na majaribio.

## `send_keypad_input`

Hutuma tarakimu za DTMF (vitufe vya simu) `0`–`9`, `*`, na `#` kwenye laini ya simu. Modeli huitumia kuvinjari IVR, menyu otomatiki inayowaomba wapigaji kubonyeza vitufe. Inapatikana kwa chaguomsingi na haina mpangilio wa ejenti.

Iambie modeli menyu inazoruhusiwa kuvinjari na mahali ambapo thamani zinazohitajika hutoka. Usiombe ikisie chaguo za menyu:

```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.
```

Jukwaa huondoa herufi zisizotumika na kutuma tarakimu halali kwa mpangilio. Ikiwa hakuna tarakimu halali zinazobaki au simu haiwezi kutuma vitufe, hitilafu hurudishwa kwa ejenti ili iweze kurekebisha hali.

## `no_response`

Humweka ejenti kimya wakati mfumo otomatiki bado unaongea au unapoiomba iendelee kusikiliza. Haitumiki kwa salamu ya mtu wa moja kwa moja, swali, au foleni halisi ya kusubiri. Inapatikana kwa chaguomsingi na haina mpangilio wa ejenti.

Kwa kawaida maelezo yaliyojengewa ndani yanatosha. Kwa simu zenye IVR nyingi, sisitiza mpaka huo kwenye prompt:

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

Tendo hili halikomeshi simu.

## `wait_on_hold`

Huweka ejenti ya simu za kutoka katika hali ya kusubiri kimya hadi mtu halisi arejee.
Modeli huitumia tu baada ya upande mwingine kusema wazi kuwa ejenti anawekwa
kusubiri. Hupatikana kiotomatiki kwenye simu za kutoka na haina mpangilio wa dashibodi.

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

Usiagize ejenti kuitumia kwa ujumbe wa IVR wa "please wait". Kusubiri hudumu
hadi dakika 15 kwa chaguomsingi. Kwa simu za kawaida za kutoka, `POST /v1/call`
inakubali `max_hold_seconds` yenye nambari kamili chanya; Realtime ya ndani
huzuia `max_hold_seconds` kuwa sekunde 10–900. Mtu huyo
akirejea, ejenti huendelea bila kubadilisha sababu ya kumalizika kwa simu. Kikomo
kikiisha, jukwaa humaliza simu kwa `end_reason: "ai_hangup"`.

## `search_knowledge_base`

Hutafuta hati zilizoambatishwa kwa ejenti na kurejesha vifungu vinavyohusika. Ambatisha
msingi wa maarifa au hati binafsi za maarifa ili kuiwezesha, kisha iambie
modeli ni majibu yapi lazima yatokane na vyanzo hivyo:

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

Utafutaji ukishindwa, matokeo hurejeshwa kwa ejenti. Tazama [Msingi wa
maarifa](/sw/guides/knowledge-base) kwa usanidi wa dashibodi na API.

## `play_sound`

Hucheza sauti ya arifa iliyosanidiwa ya ejenti baada ya hotuba yoyote katika
zamu hiyo hiyo. Kwenye dashibodi, weka **Ya juu → Sauti ya zana** kuwa **Chime**, **Ding**,
au **Beep**, kisha chapisha ejenti. **Hakuna** huondoa zana.

Kwa kutumia [API ya Agents](/api-reference/agents), weka `play_sound_asset` kama
`"chime"`, `"ding"`, au `"beep"`, kisha chapisha. Iweke kuwa `""` ili kuzima
zana.

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

Hitilafu ya uchezaji hurejeshwa kwa ejenti na haimalizi simu.

## `send_email`

Hutuma barua pepe ya maandishi wazi kwa mpokeaji mmoja aliyesanidiwa na mmiliki wa ejenti.
Modeli hutoa mada na ujumbe. Haiwahi kuona kigezo cha mpokeaji
na haiwezi kuchagua au kubadilisha anwani.

Kwenye dashibodi, wezesha **Ya juu → Tuma barua pepe**, hifadhi anwani ya mpokeaji,
kisha chapisha ejenti. Kwa kutumia [API ya Agents](/api-reference/agents), weka zote
`send_email_enabled: true` na `send_email_recipient` isiyo tupu, kisha chapisha.
Bainisha kichochezi na maudhui yanayohitajika katika prompt:

```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.
```

Simu inaweza kujaribu kutuma barua pepe zisizozidi tatu. Kila mada ina kikomo cha
herufi 300 na kila ujumbe herufi 20,000. Usanidi unaokosekana, maudhui yasiyo sahihi,
kikomo kwa kila simu, na hitilafu za uwasilishaji hurejeshwa kwa ejenti.
Uwasilishaji ulioshindwa bado hutumia moja ya majaribio matatu.

Fanya jaribio kwa mpokeaji unayemdhibiti kabla ya kuchapisha kwa upana. Talk ya kivinjari na
simuleringar hutuma barua pepe halisi; hakuna hali ya majaribio bila kutuma.

## Dokezo la uoanifu

Mpangilio wa **Ya juu → Maelezo yasiyokatizwa** na sehemu ya zamani ya
`speak_uninterruptible_enabled` hubaki kwa uoanifu, lakini kuviwezesha
hakuna athari. Acha mpangilio umezimwa; hakuna prompt inayoweza kuwezesha zana hii.

Kwa tangazo la lazima mwanzoni mwa simu, tumia **Tangazo la idhini**. Huchezwa
kama lilivyo kabla ya mazungumzo ya kawaida na haliwezi kukatizwa. Tazama [Sheria za idhini ya kurekodi simu](/sw/guides/recording-consent-laws).

## Jaribu na ufuatilie zana zilizojengeka

Tumia Talk ya kivinjari au simuleringi kuangalia prompt, utafutaji wa maarifa, sauti,
na barua pepe. Mazingira hayo hayawezi kuiga tabia ya mtandao wa simu. Jaribu
urambazaji wa vitufe na kusubiri kwenye simu ya kutoka, na ujaribu uhamisho kamili wenye utambulisho
kwenye simu halisi kwa kutumia nambari ya VoIP iliyoingizwa inayostahiki. Usaidizi wa Realtime
una mipaka kama inavyoonyeshwa kwenye jedwali hapo juu.

## Simu, bei, na webhook

Vitendo vilivyojengewa ndani havina ada ya zana kwa kila matumizi. Ada za kawaida za simu na mtoa huduma
bado zinatumika; angalia [Bei](/sw/guides/pricing). Simu na matokeo yake yanaweza kuonekana
katika transkripti iliyokamilika, lakini hayatoi `telephony.tool` au `web.tool`.
Matukio hayo ni ya [vipengele vinavyofafanuliwa na mtumiaji](/sw/tools/overview). Kukata simu au kuhamisha simu kulikokamilika pekee
hubadilisha `end_reason` ya simu; hitilafu nyingine hurudishwa kwa ejenti. Angalia [Webhook za ukamilishaji](/sw/webhooks/call-complete) kwa rekodi ya simu.