--- title: "Integruoti įrankiai" description: "Nurodykite ThunderPhone agentams užbaigti skambučius, peradresuoti skambinančiuosius, naudotis klaviatūromis, laukti sulaikius, ieškoti žinių bazėje, leisti garsus ir siųsti el. laiškus." --- Integruoti įrankiai leidžia agentui atlikti įprastus skambučio veiksmus neprijungiant jūsų nuosavos API. Dauguma jų pasiekiami automatiškai; el. paštas, garsai ir žinių paieška rodomi tik sukonfigūravus susijusį nustatymą arba šaltinį. Agento raginime nurodykite, kada naudoti kiekvieną veiksmą. | Įrankis | Naudokite jį, kai reikia | Kaip įjungti | Palaikomi skambučiai | | --- | --- | --- | --- | | `end_call` | Užbaigti baigtą pokalbį | Visada pasiekiamas | Telefonas, naršyklės Talk, valdiklis, simuliacija ir Realtime | | `transfer_call` | Nukreipti skambinantįjį telefonu | Raginime sukonfigūruokite nukreipimą | Įprasti telefono skambučiai; įterptinis Realtime su `call_events` gali naudoti šaltą perjungimą. Išsaugoto agento Realtime jo neturi. | | `send_keypad_input` | Spausti telefono meniu klavišus | Visada pasiekiamas įprastuose telefono skambučiuose | Telefono skambučiai; įterptinis išeinantis Realtime su `call_events`. Išsaugoto agento Realtime jo neturi. | | `no_response` | Tęsti klausymąsi, kol kalba automatinis meniu | Visada pasiekiamas | Visų tipų skambučiai | | `wait_on_hold` | Tyliai laukti, kol asmuo grįš | Įtrauktas į išeinančius skambučius | Išeinantys telefono ir išeinančios įterptinės Realtime sesijos | | `search_knowledge_base` | Atsakyti naudojantis pridėtais šaltiniais | Pridėkite žinias prie agento | Išsaugoto agento skambučiai su pridėtomis žiniomis | | `play_sound` | Paleisti sukonfigūruotą pranešimo garsą | **Išplėstiniai → Įrankio garsas** | Išsaugoto agento skambučiai | | `send_email` | Siųsti el. laišką vienam fiksuotam gavėjui | **Išplėstiniai → Siųsti el. laišką** | Išsaugoto agento skambučiai | ## `end_call` Užbaigia dabartinį skambutį, kai modelis taip nurodomas raginime. Jis pasiekiamas pagal numatytuosius nustatymus ir neturi agento nustatymo. Į raginimą įrašykite sąlygą ir bet kokią privalomą atsisveikinimo frazę: ```text When the caller confirms they need nothing else, say goodbye and end the call. ``` Įprasto modelio užbaigto skambučio reikšmė yra `end_reason: "ai_hangup"`. Vietoj jos trukmės arba likučio nutraukimo atveju gali būti naudojama konkretesnė užbaigimo priežastis. ## `transfer_call` Peradresuoja skambinantįjį telefonu į modelio pateiktą fiksuotą numerį. Šaltas perjungimas vyksta iš karto. Patikrintas šiltas perjungimas privačiai paskambina į paskirties vietą prieš sujungiant šalis. Šiltam perjungimui reikia patvirtinto importuoto VoIP numerio, kuriuo galima skambinti išeinančius skambučius. Į raginimą įrašykite paskirties numerį ir tikslią nukreipimo sąlygą: ```text If the caller asks for billing, transfer them to +15551234567. ``` Sėkmingo šalto perjungimo reikšmė yra `end_reason: "ai_transfer"`; užbaigto šilto perdavimo reikšmė yra `end_reason: "ai_warm_transfer"`. Jei šiltas bandymas nepavyksta, valdymas grąžinamas agentui, todėl vėlesnis skambučio užbaigimas nustato jo užbaigimo priežastį. Ne telefono sesijose peradresavimo užklausa vietoj to užbaigia sesiją. Informacijos apie valdymo skydelio ir API sąranką, nukreipimą, patikrą, nesėkmių tvarkymą, apribojimus ir testavimą rasite skiltyje [Skambučių peradresavimas](/lt/guides/call-transfers). ## `send_keypad_input` Siunčia DTMF (telefono klaviatūros) skaitmenis `0`–`9`, `*` ir `#` į telefono liniją. Modelis jį naudoja naršyti IVR – automatiniame meniu, kuriame skambintojų prašoma spausti klavišus. Jis pasiekiamas pagal numatytuosius nustatymus ir neturi agento nustatymo. Nurodykite modeliui, kuriuose meniu jis gali naršyti ir iš kur gaunamos prašomos reikšmės. Neprašykite jo spėlioti meniu parinkčių: ```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. ``` Platforma pašalina nepalaikomus simbolius ir siunčia galiojančius skaitmenis eilės tvarka. Jei nelieka galiojančių skaitmenų arba skambutis negali siųsti klaviatūros įvesties, nesėkmė grąžinama agentui, kad jis galėtų ją išspręsti. ## `no_response` Išlaiko agentą tylų, kol automatinė sistema dar kalba arba prašo jo toliau klausytis. Jis nėra skirtas gyvo asmens pasisveikinimui, klausimui ar tikrai laukimo eilei. Jis pasiekiamas pagal numatytuosius nustatymus ir neturi agento nustatymo. Paprastai pakanka integruoto aprašo. Skambučiams, kuriuose daug naudojamas IVR, raginime sustiprinkite ribą: ```text Stay silent while a phone menu is still speaking. Answer a live person as soon as they address you. ``` Šis veiksmas neužbaigia skambučio. ## `wait_on_hold` Perjungia skambučius inicijuojantį agentą į tylų laukimo režimą, kol grįžta gyvas asmuo. Modelis jį naudoja tik tada, kai kita šalis aiškiai pasako, kad agentas perjungiamas į laukimo režimą. Jis automatiškai pasiekiamas skambučiuose inicijuojant skambutį ir neturi nustatymo valdymo skydelyje. ```text If a person explicitly puts you on hold, wait silently. When they return, continue from the question you were discussing. ``` Nenurodykite agentui jo naudoti IVR pranešimui „prašome palaukti“. Pagal numatytuosius nustatymus laukimas trunka iki 15 minučių. Įprastiems skambučiams inicijuojant skambutį, `POST /v1/call` priima teigiamo sveikojo skaičiaus `max_hold_seconds`; įterptasis Realtime riboja `max_hold_seconds` iki 10–900 sekundžių. Jei asmuo grįžta, agentas tęsia darbą nepakeisdamas skambučio užbaigimo priežasties. Jei limitas baigiasi, platforma užbaigia skambutį su `end_reason: "ai_hangup"`. ## `search_knowledge_base` Ieško prie agento pridėtuose dokumentuose ir grąžina susijusias ištraukas. Pridėkite žinių bazę arba atskirus žinių dokumentus, kad tai įjungtumėte, tada nurodykite modeliui, kurie atsakymai turi būti gaunami iš šių šaltinių: ```text Search the knowledge base before answering policy questions. If the first search is inconclusive, try once more with different key terms. ``` Jei paieška nepavyksta, rezultatas grąžinamas agentui. Valdymo skydelio ir API nustatymus žr. [Žinių bazė](/lt/guides/knowledge-base). ## `play_sound` Paleidžia agento sukonfigūruotą pranešimo garsą po bet kokios kalbos tame pačiame ėjime. Valdymo skydelyje nustatykite **Išplėstiniai → Įrankio garsas** kaip **Skambutis**, **Ding**, arba **Pyptelėjimas**, tada įdiekite agentą. **Nėra** pašalina įrankį. Naudodami [Agents API](/api-reference/agents), paruoškite `play_sound_asset` kaip `"chime"`, `"ding"` arba `"beep"`, tada įdiekite. Nustatykite į `""`, kad išjungtumėte įrankį. ```text After confirming that an appointment was saved, say "You're all set" and play the notification sound. ``` Atkūrimo klaida grąžinama agentui ir neužbaigia skambučio. ## `send_email` Siunčia paprasto teksto el. laišką vienam agento savininko sukonfigūruotam gavėjui. Modelis pateikia temą ir turinį. Jis niekada nemato gavėjo parametro ir negali pasirinkti ar pakeisti adreso. Valdymo skydelyje įjunkite **Išplėstiniai → Siųsti el. laišką**, išsaugokite gavėjo adresą, tada įdiekite agentą. Naudodami [Agents API](/api-reference/agents), paruoškite abu `send_email_enabled: true` ir netuščią `send_email_recipient`, tada įdiekite. Apibrėžkite aktyviklį ir privalomą turinį raginime: ```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. ``` Per vieną skambutį galima bandyti išsiųsti ne daugiau kaip tris el. laiškus. Kiekviena tema ribojama iki 300 simbolių, o kiekvienas turinys – iki 20 000 simbolių. Trūkstama konfigūracija, netinkamas turinys, vieno skambučio limitas ir pristatymo klaidos grąžinamos agentui. Nepavykęs pristatymas vis tiek sunaudoja vieną iš trijų bandymų. Prieš plačiai diegdami išbandykite su kontroliuojamu gavėju. Naršyklės Talk ir simuliacijos siunčia tikrus el. laiškus; bandomojo vykdymo režimo nėra. ## Suderinamumo pastaba Nustatymas **Išplėstiniai → Nepertraukiami informaciniai pranešimai** ir senasis laukas `speak_uninterruptible_enabled` paliekami dėl suderinamumo, tačiau jų įjungimas neturi poveikio. Palikite nustatymą išjungtą; joks raginimas negali aktyvuoti šio įrankio. Jei būtinas pranešimas skambučio pradžioje, naudokite **Sutikimo pranešimas**. Jis atkuriamas pažodžiui prieš įprastą pokalbį ir negali būti pertrauktas. Žr. [Skambučių įrašymo sutikimo įstatymai](/lt/guides/recording-consent-laws). ## Integruotų įrankių testavimas ir stebėjimas Naudokite naršyklės Talk arba simuliaciją, kad patikrintumėte raginimus, žinių paiešką, garsus ir el. paštą. Šios aplinkos negali atkartoti telefono tinklo elgsenos. Išbandykite klaviatūros naršymą ir laukimo režimą inicijuojant skambutį telefonu, taip pat išbandykite pilną šiltąjį perdavimą tikro skambučio metu naudodami tinkamą importuotą VoIP numerį. Realtime palaikymas yra ribotas, kaip parodyta aukščiau esančioje lentelėje. ## Skambučiai, kainodara ir žiniatinklio kabliukai Už įtaisytųjų veiksmų naudojimą papildomas mokestis netaikomas. Vis tiek taikomi įprasti skambučių ir teikėjo mokesčiai; žr. [Kainodara](/lt/guides/pricing). Jų iškvietimai ir rezultatai gali būti rodomi užbaigtame nuoraše, tačiau jie nesiunčia `telephony.tool` ar `web.tool` įvykių. Šie įvykiai skirti [naudotojo apibrėžtoms funkcijoms](/lt/tools/overview). Tik sėkmingai užbaigtas pokalbio nutraukimas arba peradresavimas pakeičia skambučio `end_reason`; apie kitas klaidas pranešama agentui. Skambučio įrašą žr. [Užbaigimo žiniatinklio kabliukai](/lt/webhooks/call-complete).