---
title: "Kõnede edastamine"
description: "Suunake helistajad külma edastamisega või kontrollige enne sooja edastamisega sihtkohta."
---

Igal häälagendil on sisseehitatud toiming `transfer_call`. Määra agendi
viibas, millal kõne üle anda, millist numbrit kasutada ja kas üleandmine peaks
olema külm või soe.

| Režiim | Mis toimub | Kasuta seda, kui |
| --- | --- | --- |
| **Külm** | Helistaja suunatakse otse sihtkohta. Agent ei tutvusta helistajat ega kinnita, et keegi vastab. | Kiire suunamine on olulisem kui eelkontrollitud üleandmine või kõne kasutab ThunderPhone'i pakutud numbrit. |
| **Soe** | Helistaja ootab ootel, samal ajal kui agent helistab privaatselt sihtkontaktile ja kontrollib seda. Osapooled ühendatakse ainult siis, kui sihtkontakt nõustub. | Sihtkontakt vajab enne nõustumist konteksti või helistaja peaks naasma agendi juurde, kui keegi pole saadaval. |

Kui agent jätab režiimi määramata, on üleandmine külm.

## Seadista üleandmised

Juhtpaneelil:

1. Ava **Häälagendid**, vali agent ja ava **Seadistus**.
2. Lisa viibale iga sihtkoht, selle suunamistingimus ja teave selle kohta, kas
   kasutada režiimi `cold` või `warm`. Eraldi üleandmislülitit ei pea lubama ega
   kohandatud tööriista looma.
3. Vajadusel määra **Täpsemad → Helisemise kestus** vahemikus 5 kuni 120 sekundit.
4. Vali **Juuruta**.

API-ga kasuta `PATCH /v1/agents/{agent_id}`, et salvestada viip mustandina ja
määrata valikuline `ring_duration_seconds`, seejärel kasuta
`POST /v1/agents/{agent_id}/deploy`. Vaata [Agentide API](/api-reference/agents#update-an-agent-writes-the-draft).

## Mis toimub sooja üleandmise ajal

1. Agent ütleb helistajale, et alustab üleandmist.
2. Helistaja kuuleb ootemuusikat. Helistaja ei kuule sihtkontakti helisemist ega
   privaatset vestlust.
3. ThunderPhone helistab sihtkontaktile kõnet haldava VoIP-numbri kaudu. Agent
   edastab oma `screen_message`, mis peaks tutvustama agenti, nimetama
   helistajat, selgitama kõne põhjust ja küsima, kas sihtkontakt saab kõne vastu võtta.
4. Sihtkontakt võib enne otsustamist küsimusi esitada. Agent vastab algse
   vestluse ja oma viiba põhjal, samal ajal kui helistaja jääb ootele.
5. Kui sihtkontakt nõustub, ei ole helistaja enam ootel ning mõlemad osapooled
   kuulevad lühikest `introduction`. Seejärel katkestab agent ühenduse
   automaatselt. Kaks osapoolt jäävad ühendatuks.

Kui sihtkontakt keeldub, ei vasta või kõne jõuab kõnepostini, eemaldab
ThunderPhone selle privaatse kõne ja võtab helistaja ootelolekust ära. Agent
saab tulemuse ning jätkab algset vestlust. See võib võtta sõnumi, soovitada
teist suunamisviisi või teha külma üleandmise, kui helistaja seda endiselt
soovib. Soe üleandmine ei jäta kõneposti. Kui sihtkontakt palub agendil sõnumi
edastada, sisaldab tööriista tulemus seda kujul `relay_message_for_caller`.

<Note>
  Kui agendi nõusolekuteade on lubatud, kuuleb sihtkontakt seda teadet enne
  privaatse kontrollvestluse algust. Ootel olev helistaja ei kuule seda teist korda.
</Note>

## Juhenda häälagenti kõnesid hästi suunama

Pane suunamisreeglid häälagendi juhisesse. Kasuta E.164 vormingut: `+`, riigikood
ja täielik riigisisene number, näiteks `+14155550123`. Määra iga marsruudi jaoks
suunamisrežiim ja anna häälagendile ebaõnnestunud soojade suunamiste jaoks varuvariant.

```text
Transfer policy

Confirm the caller's name and reason for calling before any transfer.

| Caller needs | Destination | Transfer mode |
| --- | --- | --- |
| A new purchase or plan change | +14155550123 | warm |
| Help with an existing order | +14155550124 | warm |
| The main office | +14155550125 | cold |

For a warm transfer:
- In the private screen message, identify yourself, give the caller's name and
  a one-sentence reason for the call, then ask whether the target can take it.
- Answer reasonable questions from the target using the conversation context.
- If the target accepts, introduce both people in one short sentence. Do not
  plan to speak after the introduction because you will be dropped.
- If the target declines, does not answer, or reaches voicemail, tell the
  caller what happened. Relay any message from the target, then offer to take
  a message or try another route. Do not cold-transfer unless the caller asks.
```

Häälagent täidab sisseehitatud toimingu kutsumisel järgmised väljad:

| Väli | Millal kasutatakse | Eesmärk |
| --- | --- | --- |
| `phone_number` | Alati | Sihtnumber E.164 vormingus. |
| `mode` | Valikuline | `cold` või `warm`; vaikimisi on `cold`. |
| `screen_message` | Nõutav sooja suunamise korral | Avateade, mida sihtkontakt kuuleb privaatselt. |
| `introduction` | Nõutav sooja suunamise korral | Üks lühike lause, mida mõlemad osapooled kuulevad pärast sihtkontakti nõustumist. |

Sa ei pea määratlema ega lisama kohandatud tööriista nimega `transfer_call`.

## Sosinaga suunamised

„Sosinaga suunamine” on levinud valdkonnatermin sooja suunamise kohta, mille
puhul sihtkontakt kuuleb enne helistaja ühendamist privaatset konteksti. Teenuses
ThunderPhone pakub selle privaatse ülevaate sooja suunamise `screen_message`.
Seejärel saab sihtkontakt enne nõustumist või keeldumist häälagendilt esitada
täpsustavaid küsimusi.

See erineb toimingust
[`POST /v1/calls/{id}/whisper`](/et/guides/monitor-live-calls).
See lõpp-punkt võimaldab töötajal või omanikul saata aktiivse kõne ajal
AI häälagendile privaatseid tekstijuhiseid. See ei helista suunamise sihtkontaktile
ega anna talle ülevaadet.

## Nõuded, piirangud ja testimine

| Küsimus | Vastus |
| --- | --- |
| Millised numbrid toetavad sooja edasiühendust? | Kinnitatud number, mis on imporditud väljuvaid kõnesid teha võimaldava VoIP-ühenduse kaudu. ThunderPhone'i pakutavad numbrid toetavad ainult külma edasiühendust. Kui soe režiim pole saadaval, kasutatakse külma edasiühendust. [Ühenda VoIP-teenusepakkuja](/et/guides/voip-providers). |
| Millised kõnetüübid seda toetavad? | Külm edasiühendus on saadaval tavalistel telefonikõnedel. Browser Talk, vidinad, simulatsioonid ja testkõned ei võimalda sooja edasiühendust testida. Salvestatud agendi Realtime ei sisalda `transfer_call`; reasisene Realtime koos `call_events`-iga saab taotleda külma edasiühendust. |
| Kuidas seda testida? | Kontrolli suunamise sõnastust Browser Talkis või simulatsioonis, seejärel testi täielikku edasiühendust päris telefonikõnel sobiva imporditud VoIP-numbriga. |
| Kui kaua sihtnumber heliseb? | `ring_duration_seconds` aktsepteerib väärtusi 5–120 sekundit. `null` kasutab sooja edasiühenduse puhul 45 sekundit ja külma edasiühenduse puhul operaatori vaikeväärtust. Tavaliste väljuvate kõnede vaikeväärtus on 60 sekundit. See säte ei muuda sissetulevate kõnede helisemist. |
| Kui kaua võib inimestevaheline ühendus kesta? | Kuni 60 minutit pärast seda, kui agent on kaks inimest ühendanud. |
| Mis juhtub ebaõnnestumise korral? | Kui sihtisik keeldub, ei vasta, kõne jõuab kõneposti või väljuv kõneharu ebaõnnestub, naaseb helistaja tulemuse teabega agendi juurde. Viip peaks määratlema järgmise sammu. |
| Kui palju see maksab? | Edasiühenduse tööriista eest tasu ei ole. Tavapärased kõnetasud hõlmavad sooja edasiühenduse protsessi kuni tutvustuseni, seejärel ThunderPhone'i arvestus peatub, kui AI lahkub. Sinu operaator võib jätkata väljuva edasiühenduse kõneharu eest arveldamist, kuni kaks inimest jäävad ühendatuks. |

## Veebikonksud ja lõpetamise põhjused

Lõpetamise andmekoormus salvestab sihtnumbri väljal `transfer_number` ja kasutab
ühte järgmistest lõpetamise põhjustest:

| `end_reason` | Tähendus |
| --- | --- |
| `ai_transfer` | Agent algatas külma edasiühenduse. |
| `ai_warm_transfer` | Sihtisik võttis sooja edasiühenduse vastu, osapooled ühendati ja agent lahkus pärast tutvustust. |

Keeldutud, vastamata, ebaõnnestunud või kõneposti jõudnud soe katse ei ole lõpetatud
edasiühendus. Helistaja naaseb agendi juurde, seega kajastab lõplik lõpetamise põhjus
seda, mis algse kõne lõpetab.

Õnnestunud sooja edasiühenduse korral salvestatakse lõpetamissündmus ja AI-kõne
lõpetamise põhjus siis, kui tutvustus lõpeb ja AI lahkub. Kui salvestamine on
lubatud, jätkub heli salvestamine inimestevahelise ühenduse lõpuni; pärast
edasiühendust toimunud kõne salvestatakse, kuid seda ei transkribeerita. Kui agendi
nõusolekuteade on lubatud, kuuleb edasiühenduse sihtisik seda enne eelvestluse
algust.

<Accordion title="Pärandversiooni lõpetamise veebikonks">
  Pärandversiooni ühe URL-iga veebikonks võib külma edasiühendust kuni viis minutit
  edasi lükata, tagastades `{"transfer_ready": false}` ja uuendades hiljem kõne
  edasiühenduse valmiduse olekut. Veebikonksu lõpp-punkti edastused ja soojad
  edasiühendused ei kasuta seda koordineerimist.
</Accordion>

Täieliku andmekoormuse ja pärandkäitumise kohta vaata [lõpetamise veebikonksude](/et/webhooks/call-complete) dokumentatsiooni.

## Tõrkeotsing

### Agent teeb sooja edastuse asemel külma edastuse

Kontrolli, et kõne kasutab kinnitatud, imporditud VoIP-numbrit toimiva
väljamineva kõne marsruutimisega. Sooja edastuse režiim ei ole ThunderPhone'i
numbrite ja mitte-telefoniseansside puhul tööriista valikutes saadaval. Määra
režiim selgelt ka viiba marsruutimistabelis.

### Sihtkontakt ei vasta

Veendu, et sinu VoIP-trunk saab sihtnumbrile väljaminevaid kõnesid teha ning et
selle autentimis- ja marsruutimisreeglid on ajakohased. Kontrolli sihtnumbri
E.164 vormingut. Suurenda `ring_duration_seconds`, kui 45 sekundit on sooja
edastuse jaoks liiga lühike aeg.

### Sihtkontakt jõuab kõneposti

Soojade edastuste korral ei jäeta kõneposti. Helistaja eemaldatakse ootelolekust
ja häälagent saab tulemuse `voicemail`. Määra häälagendi viibas, kas võtta
sõnum, proovida teist sihtkontakti või pakkuda külma edastust.

### Helistaja ei saa sihtkontakti sõnumit

Ütle häälagendile, et ta edastaks `relay_message_for_caller` enne järgmiste
sammude pakkumist. See väli on olemas ainult siis, kui sihtkontakt keeldub ja
palub häälagendil midagi edasi anda.

### Külm edastus ootab enne ühendamist

Kui kasutad pärandatud ühe URL-iga veebikonksu, kontrolli, kas see tagastas
`{"transfer_ready": false}`. Helistaja kuuleb ootel muusikat, kuni ThunderPhone
ootab. Uuenda kõne edastamisvalmiduse olekut, kui sihtkontakt on valmis.

### Personali sosistamine ei käivita edastust

Reaalajas kõne ajal sosistamine ainult juhendab häälagenti. Lisa
edastusjuhised häälagendi viibale ja lase sellel kutsuda `transfer_call`. Vt
[Jälgi reaalajas kõnesid](/et/guides/monitor-live-calls).