---
title: "Siirrä puheluita"
description: "Tallenna numerot, joihin agentti voi siirtää puheluita, ja ohjaa soittajat kylmällä siirrolla tai pysy linjalla ja esittele heidät lämpimällä siirrolla."
---

Agentti siirtää puheluita vain **siirtonumeroihinsa**: agentille tallentamaasi nimien ja puhelinnumeroiden luetteloon. Kehote viittaa kuhunkin numeroon nimellä ja määrittää, milloin puhelu siirretään ja onko siirto kylmä vai lämmin. Agentti näkee vain nimet, ei koskaan numeroita. Agentti, jolla ei ole siirtonumeroita, ei voi siirtää puheluita.

| Tila | Mitä tapahtuu | Käytä, kun |
| --- | --- | --- |
| **Kylmä** | Soittaja ohjataan suoraan kohteeseen. Agentti ei esittele soittajaa eikä varmista, että joku vastaa. | Nopea reititys on esittelyä tärkeämpää tai puhelun numerosta ei voi soittaa lähteviä puheluita. |
| **Lämmin** | Heti kun joku vastaa, soittaja yhdistetään puheluun, agentti esittelee soittajan linjalla ja poistuu puhelusta. Voit myös pyytää agenttia [kysymään ensin tai kuiskaamaan](#before-connecting). | Kohteen pitäisi kuulla, kuka soittaa ja miksi, tai soittajan pitäisi palata agentille, kun kukaan ei vastaa. |

Jos agentti ei määritä tilaa, siirto on kylmä.

## Määritä siirrot

Hallintapaneelissa:

1. Avaa **Puheagentit**, valitse agentti ja avaa **Asetukset**.
2. Lisää kohdassa **Siirtonumerot** jokainen kohde nimellä ja puhelinnumerolla,
   esimerkiksi **Laskutus** ja `+1 415 555 2671`. Agentilla voi olla enintään
   50 siirtonumeroa.
3. Viittaa kehotteessa jokaiseen kohteeseen sen nimellä ja kerro, milloin sitä
   käytetään ja käytetäänkö `cold`- vai `warm`-tilaa, esimerkiksi "siirrä
   laskutukseen liittyvät kysymykset Laskutukseen". Älä luo mukautettua työkalua.
4. Valitse lämpimille siirroille, mitä tapahtuu **Ennen yhdistämistä**, ja
   valinnaisesti, mitä **Esittelyn** tulee sanoa. Katso
   [Ennen yhdistämistä](#before-connecting).
5. Aseta tarvittaessa **Lisäasetukset → Soittoaika** 5–120 sekuntiin.
6. Valitse **Ota käyttöön**.

API:n avulla valmistele `transfer_destinations`, kehote sekä valinnaiset
`warm_transfer_style`, `warm_transfer_briefing` ja `ring_duration_seconds`
kutsulla `PATCH /v1/agents/{agent_id}`, ja tee sitten kutsu `POST /v1/agents/{agent_id}/deploy`:

```json
{
  "transfer_destinations": [
    {"name": "Billing", "number": "+14155552671"},
    {"name": "Front desk", "number": "+19375551234"}
  ],
  "warm_transfer_style": "introduce",
  "warm_transfer_briefing": "The caller's name and what they need."
}
```

Kirjoitus korvaa koko luettelon, ja `[]` poistaa kaikki siirtonumerot. Katso
kenttäsäännöt ja validointivirheet [Agents API](/api-reference/agents#transfer-numbers) -dokumentaatiosta.

### Nimet ja numerot

- **Nimi:** 1–60 merkkiä, agentilla kirjainkoosta riippumatta yksilöllinen. Tämä on
  sana, jota kehotteessa käytetään.
- **Numero:** täydellinen puhelinnumero. Numerot ilman maatunnusta tulkitaan
  yhdysvaltalaisiksi numeroiksi, ja kaikki numerot tallennetaan E.164-muodossa.
  Alanumerot sekä kuvitteellinen numeroväli 555-0100–555-0199 hylätään.
- **Muuttujanumero:** puhelinnumeron sijaan yksi
  [puhelumuuttuja](/fi/guides/call-variables) yksinään, kuten `{{rep_phone}}`.
  Se täytetään puhelun muuttujista puhelun alkaessa. Jos muuttuja puuttuu tai
  se ei ole kyseisessä puhelussa kelvollinen numero, siirto tähän nimeen
  hylätään.

### Mitkä numerot puhelu voi tavoittaa

Se, minkä numeron siirto voi tavoittaa, riippuu sitä välittävästä linjasta.
ThunderPhonen linjalla välitetty siirto voi tavoittaa vain yhdysvaltalaisia
numeroita, lukuun ottamatta premium-hintaisia ja muita erityispalvelunumeroita.
[Oman operaattorisi](/fi/guides/voip-providers) välittämä siirto voi tavoittaa
minkä tahansa tallentamasi numeron.

| Siirto | Välittäjä |
| --- | --- |
| Kylmä siirto saapuvassa puhelussa | Operaattori, jonka kautta puhelu saapui: ThunderPhonen linja ThunderPhone-numerolle, oma operaattorisi oman operaattorisi numerolle. |
| Kylmä siirto lähtevässä puhelussa | Linja, jolla puhelu soitettiin. |
| Lämmin siirto (uusi puheluhaara kohteeseen) | Linja, jolla uusi puheluhaara soitetaan. |

Oman operaattorisi numero soittaa lähteviä puheluja ja lämpimiä puheluhaaraja
vain yhteytensä oman lähtevän trunkin kautta: manuaaliset SIP-yhteydet, joissa
on lähtevä trunk, Twilio-yhteydet, joissa lähtevät puhelut on määritetty, sekä
Telnyx-yhteydet. Ilman kyseistä trunkia numero ei voi soittaa lainkaan
ulospäin, joten se tukee vain kylmää siirtoa. Nämä puhelut eivät koskaan palaa
ThunderPhonen linjalle.

Jos organisaatiollasi ei ole numeroita omalla operaattorilla, sellaisen
numeron tallentaminen, jota ThunderPhonen linja ei voi tavoittaa, epäonnistuu
virheeseen. Kun yhdistät oman operaattorisi, nämä numerot tallennetaan ja ne
merkitään toimiviksi vain oman operaattorisi välittämissä siirroissa
(`platform_ok: false` API:ssa). Yksi agentti voi vastata molemmantyyppisissä
numeroissa, joten tarkistus suoritetaan jokaisessa puhelussa.

## Ennen yhdistämistä

Kukin agentti valitsee, mitä tapahtuu, kun lämpimän siirron kohde vastaa.
Asetus koskee kaikkia agentin tekemiä lämpimiä siirtoja.

| Asetus | API-arvo | Mitä tapahtuu | Soittajan odotus |
| --- | --- | --- | --- |
| **Esittele linjalla** (oletus) | `introduce` | Soittaja yhdistetään heti, kun kohde vastaa, ja kuulee tämän tervehdyksen. Kun vastannut henkilö on lopettanut, agentti esittelee soittajan yhdellä tai kahdella lauseella, jotka molemmat kuulevat, ja poistuu puhelusta. Keneltäkään ei kysytä mitään. | Vain soittoääni. |
| **Kysy ensin** | `ask_first` | Agentti kertoo vastanneelle henkilölle yksityisesti taustatiedot ja kysyy, voiko tämä ottaa puhelun. Hän voi esittää kysymyksiä, hyväksyä tai kieltäytyä. Jos hän hyväksyy, soittaja yhdistetään, agentti esittelee soittajan linjalla ja poistuu puhelusta. | Soittoääni sekä yksityinen keskustelu, usein 15 sekuntia tai enemmän. |
| **Kuiskaa** | `whisper` | Agentti kertoo vastanneelle henkilölle yksityisesti yhdellä lyhyellä lauseella, kuka soittaa ja miksi. Mitään ei kysytä. Tämän jälkeen soittaja yhdistetään ja agentti poistuu puhelusta sanomatta mitään linjalla. | Soittoääni ja yksi yksityinen lause. |

Käytä **Esittele linjalla** -asetusta, ellei vastaavan henkilön tarvitse voida
kieltäytyä puheluista tai hänen pitäisi kuulla soittajasta ennen kuin soittaja
on linjalla. **Kysy ensin** antaa hänen kieltäytyä, mutta pitää soittajan
odotuksessa pidempään, ja vastaaja, hiljaisuus tai kieltäytyminen kaikki
ohjaavat soittajan takaisin agentille. **Kuiskaa** antaa hänelle taustatiedot
yksityisesti kysymättä mitään; vastaaja ohjaa soittajan takaisin agentille.

### Yhteenveto

**Yhteenveto**-asetus määrittää, mitä agentti kertoo vastaavalle henkilölle
soittajasta. Kun käytössä on **Esittele linjalla**, se on esittely, jonka
molemmat kuulevat, kun heidät yhdistetään. Oletusarvoisesti se on hyvin lyhyt:
kuka soittaa ja miksi, esimerkiksi "Hei, minulla on Alex linjalla tilaukseen
liittyen. Alex, ole hyvä." Kun käytössä on **Kysy ensin**, se on yksi
yksityinen lause ennen kuin soittaja yhdistetään, ja se päättyy kysymykseen
siitä, voivatko he ottaa puhelun vastaan; hyväksymisen jälkeinen esittely
noudattaa samaa periaatetta. Kun käytössä on **Kuiskaus**, se on yksi
yksityinen lause ennen kuin soittaja yhdistetään, esimerkiksi "Alex soittaa
myöhästyneestä tilauksesta, yhdistän hänet nyt." Se on ilmoitus, ei kysymys.

Jos haluat muuttaa sen sisältöä, kirjoita agentille **Yhteenveto**-ohje
(`warm_transfer_briefing`, enintään 300 merkkiä), esimerkiksi "Soittajan nimi,
hänen tilinumeronsa ja mitä hän tarvitsee." Agentti noudattaa sitä
kirjoittaessaan jokaista esittelyä tai yhteenvetoa. Pidä mukana vain muutama
olennainen tieto: noin 40 sanaa pidempi esittely- tai **Kuiskaus**-lause tai
noin 25 sanaa pidempi **Kysy ensin** -yhteenveto korvataan lyhyellä
vakiolauseella. Jätä kenttä tyhjäksi, jos haluat käyttää oletusarvoa.

## Mitä tapahtuu lämpimän siirron aikana

Kun **Esittely linjalla** on käytössä (oletus):

1. Agentti kertoo soittajalle aloittavansa siirron. Puhelun tallennus
   päättyy, ja ThunderPhone alkaa heti soittaa kohteeseen puhelua käsittelevästä numerosta, samalla kun agentti vielä puhuu.
2. Kohteen hälyttäessä soittaja odottaa hetken hiljaisuudessa. Tässä tyylissä
   ei käytetä odotusmusiikkia.
3. Heti kun kohde vastaa, soittaja on jo linjalla, joten soittaja kuulee tervehdyksen sen ensimmäisestä sanasta alkaen.
4. Kun vastannut henkilö on lopettanut puhumisen ja odottaa vastausta,
   agentti esittelee soittajan yhdellä tai kahdella lauseella, jotka molemmat
   kuulevat, esimerkiksi: "Hei, Alex on linjalla tilaukseen liittyen. Alex, ole
   hyvä." Agentti päättelee tämän sanotun perusteella, ei tauosta: 
   tallennusilmoitus tai "odottakaa hetki" ei tarkoita puheenvuoron päättymistä, mutta "Miten voin
   auttaa?" tarkoittaa. Jos henkilö ei sano mitään, agentti aloittaa noin 3
   sekunnin kuluttua. Jos henkilö alkaa puhua esittelyn päälle, agentti lopettaa,
   antaa henkilön puhua loppuun ja sanoo esittelyn uudelleen. Noin 15 sekunnin kuluttua, esimerkiksi pitkän puhelinvalikon tapauksessa, agentti esittelee soittajan joka tapauksessa. Puuttuva tai liian pitkä esittely korvataan lyhyellä vakiolauseella, joka puhutaan puhelun kielellä.
5. Agentti poistuu puhelusta automaattisesti; mitään muuta ei sanota.

Vastannut henkilö yhdistetään puheluun. Jos kyseessä on vastaajatervehdys, agentti ei sano siihen mitään ja poistuu puhelusta, jotta soittaja voi jättää viestin. Jos
kohde ei vastaa, on varattu,
puhelua ei voida yhdistää tai vastannut henkilö katkaisee puhelun ennen
esittelyn päättymistä, ThunderPhone lopettaa kyseisen puhelun ja soittaja palaa
agentille. Agentti saa tiedon lopputuloksesta ja jatkaa alkuperäistä keskustelua.
Se voi ottaa viestin, ehdottaa toista reittiä tai tehdä kylmän siirron, jos
soittaja edelleen haluaa sellaisen.

<Note>
  Kun **Esittely linjalla** on käytössä, tallennus päättyy lämpimän siirron
  alkaessa, kuten kylmässä siirrossa. Mitään kohteen sanomaa ei tallenneta
  tai litteroida (ThunderPhone vain kuuntelee esittelyyn asti
  selvittääkseen, milloin henkilö puhuu ja milloin hän on lopettanut), joten se ei kuule
  agentin suostumusilmoitusta. Jos siirto epäonnistuu ja soittaja palaa agentille,
  myöskään puhelun loppuosaa ei tallenneta; sen tekstitys jatkuu. 
  [puheluobjekti](/api-reference/calls#call-object) ja
  [valmistumisen webhook](/fi/webhooks/call-complete) kertovat, milloin tämä tapahtui:
  `recording_stopped_at` on tallennuksen päättymishetki ja
  `recording_stopped_reason` on `warm_transfer`.
</Note>

### Kun käytössä on Kysy ensin

1. Agentti kertoo soittajalle aloittavansa siirron, minkä jälkeen soittaja
   kuulee odotusmusiikkia kohteen soidessa.
2. Kun kohde vastaa, agentti antaa vastaavan henkilön ensin lopettaa
   tervehdyksensä samalla tavalla arvioituna kuin edellä. Jos agentin
   suostumusilmoitus on käytössä, vastaava henkilö kuulee sen ensin. Sitten
   agentti kertoo yhteenvedon ja kysyy, voivatko he ottaa puhelun vastaan.
   Pidossa oleva soittaja ei kuule tästä mitään.
3. Henkilö voi esittää kysymyksiä, joihin agentti vastaa siihenastisen
   keskustelun perusteella. Jos hän hyväksyy, soittaja yhdistetään, agentti
   esittelee soittajan yhdellä tai kahdella lauseella, jotka molemmat kuulevat,
   ja katkaisee yhteyden.
4. Jos hän kieltäytyy, ei vastaa tai puhelu menee vastaajaan, ThunderPhone
   lopettaa kyseisen puhelun ja poistaa soittajan pidosta. Agentti saa tiedon
   lopputuloksesta, mukaan lukien mahdollisen viestin, jonka henkilö pyysi sitä
   välittämään, ja jatkaa soittajan kanssa.

Tässä tyylissä siirto ei keskeytä puhelun tallennusta. Jos agentti tallentaa
puheluita, sekä yksityinen keskustelu vastaavan henkilön kanssa että yhdistetty
puhelu tallennetaan. Jos puheluiden tallennus on poistettu käytöstä agentilta,
kumpaakaan ei tallenneta.

### Kun käytössä on Kuiskaus

1. Agentti kertoo soittajalle aloittavansa siirron, minkä jälkeen soittaja
   kuulee odotusmusiikkia kohteen soidessa.
2. Kun kohde vastaa, agentti odottaa, että vastaava henkilö lopettaa
   tervehdyksensä. Jos agentin suostumusilmoitus on käytössä, vastaava henkilö
   kuulee sen ensin. Sitten agentti kertoo hänelle yhdellä lyhyellä lauseella,
   kuka soittaa ja miksi. Se ei kysy, voivatko he ottaa puhelun vastaan.
   Pidossa oleva soittaja ei kuule tästä mitään.
3. Soittaja yhdistetään ja agentti katkaisee yhteyden. Linjalla ei sanota
   mitään.
4. Jos puhelu menee vastaajaan, agentti katkaisee sen ja poistaa soittajan
   pidosta. Jos kohde ei vastaa, on varattu tai puhelua ei voida muodostaa,
   soittaja palaa myös agentille. Agentti saa tiedon lopputuloksesta ja jatkaa
   soittajan kanssa.

Tallennus toimii kuten **Kysy ensin** -tilassa: jos agentti tallentaa
puheluita, sekä yksityinen lause että yhdistetty puhelu tallennetaan.

## Ohjeista agenttia siirtämään puhelut oikein

Kirjoita reitityssäännöt agentin kehotteeseen ja nimeä kukin kohde täsmälleen samoin kuin se näkyy kohdassa **Siirtonumerot**. Älä kirjoita puhelinnumeroita kehotteeseen; agentti siirtää puhelut nimen perusteella. Määritä siirtotapa kullekin reitille ja anna agentille varavaihtoehto epäonnistuneita lämpimiä siirtoja varten.

```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 | Sales | warm |
| Help with an existing order | Order support | warm |
| The main office | Front desk | cold |

For a warm transfer:
- Keep the introduction to one or two short sentences: who is calling and
  why.
- Do not plan to speak after the introduction because you will be dropped.
- If the target does not answer or is busy, tell the caller what happened,
  then offer to take a message or try another route. Do not cold-transfer
  unless the caller asks.
```

Agentti antaa nämä kentät kutsuessaan sisäänrakennettua toimintoa:

| Kenttä | Käytetään, kun | Tarkoitus |
| --- | --- | --- |
| `destination` | Aina | Yhden agentin siirtonumeron nimi. |
| `mode` | Valinnainen | `cold` tai `warm`; oletuksena on `cold`. |
| `screen_message` | Vaaditaan lämpimässä siirrossa | Kun käytössä on **Esittele puhelussa**, [esittely](#the-briefing), jonka sekä soittaja että vastaava henkilö kuulevat yhteyden muodostuttua. Kun käytössä on **Kysy ensin**, yksityinen taustoitus, jonka vastaava henkilö kuulee ennen päätöksentekoa. Kun käytössä on **Kuiskauksella**, yksityinen lause, jonka vastaava henkilö kuulee ennen kuin soittaja yhdistetään. Soittaja ei kuule kumpaakaan yksityistä viestiä. |
| `introduction` | Valinnainen lämpimässä siirrossa | Kun käytössä on **Kysy ensin**, esittely, jonka molemmat kuulevat, kun henkilö hyväksyy puhelun. Kun käytössä on **Esittele puhelussa**, käytetään vain, kun `screen_message` on tyhjä. Ei tarjota **Kuiskauksella**-tilassa, koska puhelussa ei sanota mitään. |

Sinun ei tarvitse määrittää tai liittää mukautettua työkalua nimeltä `transfer_call`. Toiminnon kuvaus noudattaa agentin **Ennen yhdistämistä**- ja **Taustoitus**-asetuksia, joten niitä ei tarvitse toistaa kehotteessa.

## Kun puhelunsiirto hylätään

ThunderPhone tarkistaa jokaisen puhelunsiirron ennen sen tekemistä. Se hylkää puhelunsiirron, kun nimi ei vastaa mitään agentin siirtonumeroista, muuttujanumerolla ei ole kelvollista arvoa tässä puhelussa tai ThunderPhonen linjaa pitkin tehtävä puhelunsiirto johtaisi Yhdysvaltojen ulkopuolella olevaan numeroon tai maksulliseen palvelunumeroon.

Hylätty puhelunsiirto ei lopeta puhelua. Agentti ei ilmoita puhelunsiirrosta, saa syyn hylkäykseen (mukaan lukien luettelon kelvollisista nimistä, jos nimi ei täsmännyt) ja jatkaa keskustelua soittajan kanssa. Kerro kehotteessa, mitä sen tulee tehdä sen sijaan, esimerkiksi ottaa viesti vastaan. Hylkäys näkyy työkalun virheenä puhelun historiassa.

## Kuiskaussiirrot

”Whisper-siirto” on alalla yleinen nimitys lämpimälle siirrolle, jossa
vastaanottaja kuulee yksityisen taustan ennen kuin soittaja yhdistetään, ilman
että vastaanottajalta kysytään, haluaako hän ottaa puhelun. Tämä on **Whisper**-asetus kohdassa
[Yhdistämistä ennen](#before-connecting).

Tämä eroaa toiminnosta
[`POST /v1/calls/{id}/whisper`](/fi/guides/monitor-live-calls).
Tämän päätepisteen avulla henkilöstön jäsen tai omistaja voi lähettää yksityisiä tekstiohjeita tekoälyagentille
aktiivisen puhelun aikana. Se ei soita siirron kohteeseen eikä taustoita sitä.

## Vaatimukset, rajoitukset ja testaus

| Kysymys | Vastaus |
| --- | --- |
| Mitkä kohteet siirto voi tavoittaa? | ThunderPhonen tarjoamassa numerossa tuetaan vain yhdysvaltalaisia numeroita, mukaan lukien maksuttomat numerot; Kanadaa, muita +1-maita ja premium-hintaisia numeroita ei tueta. ThunderPhone hylkää kaikki muut kohteet ennen soittamista: soittaja pysyy linjalla, ja agentti saa syyn ja jatkaa puhumista (katso [Kun siirto hylätään](#when-a-transfer-is-refused)). Jos haluat siirtää muihin maihin, [yhdistä oma operaattorisi](/fi/guides/voip-providers) ja vastaanota puhelu sen kautta tuodussa numerossa. Siirto kulkee silloin operaattorisi kautta, joten operaattorin on hyväksyttävä puhelunsiirrot ja sallittava puhelut kyseiseen maahan. Ota Twilio SIP -rungossa käyttöön **Puhelunsiirrot** ja **Ota puhelunsiirrot PSTN:ään käyttöön**. |
| Mitkä numerot tukevat lämmintä siirtoa? | Numero, jolla voi soittaa lähteviä puheluita: vahvistettu numero, joka on tuotu lähtevät puhelut mahdollistavan VoIP-yhteyden kautta, tai ThunderPhonen tarjoama numero sen jälkeen, kun organisaatiosi [lähtevien puhelujen pyyntö](/fi/guides/get-a-phone-number) on hyväksytty. Muut ThunderPhone-numerot tukevat vain kylmää siirtoa. Jos lämmin tila ei ole käytettävissä, toiminto käyttää kylmää siirtoa. [Yhdistä VoIP-palveluntarjoaja](/fi/guides/voip-providers). |
| Mitkä puhelutyypit tukevat sitä? | Kylmä siirto on käytettävissä tavallisissa puheluissa. Browser Talkilla, widgeteillä, simulaatioilla ja testipuheluilla ei voi testata lämmintä siirtoa. Tallennetun agentin Realtime jättää `transfer_call`-toiminnon pois; sisäinen Realtime, jossa on `call_events`, voi pyytää kylmää siirtoa. |
| Entä puhelut ilman tallennettua agenttia? | [Lähtevä puhelu](/api-reference/outbound-calls) tai [`call.incoming`](/fi/webhooks/call-incoming)-vastaus, jossa on sisäinen `config`, sekä sisäinen [Realtime](/api-reference/realtime#call-events)-istunto hyväksyvät saman `transfer_destinations`-luettelon. Luettelon kanssa puhelu siirretään vain siinä oleviin nimiin. Ilman luetteloa agentilla säilyy siirtotoiminto, joka hyväksyy puhelinnumeron, ja ThunderPhone-numeroihin tulevat puhelut voivat edelleen tavoittaa vain yhdysvaltalaisia numeroita. |
| Miten testaan sitä? | Tarkista reititystekstit Browser Talkissa tai simulaatiossa: näet, minkä nimen agentti valitsee tai hylkäyksen. Testaa sitten koko siirto oikealla puhelulla agentin numeroon. Mikä tahansa ThunderPhone- tai tuotu numero toimii kylmässä siirrossa; lämmin siirto edellyttää ThunderPhone-numeroa, jonka lähtevien puhelujen pyyntö on hyväksytty, tai tuotua numeroa, jolla voi soittaa lähteviä puheluita. |
| Kuinka kauan kohde hälyttää? | `ring_duration_seconds` hyväksyy 5–120 sekuntia. `null` käyttää lämpimässä siirrossa 45 sekuntia ja kylmässä siirrossa operaattorin oletusarvoa. Tavallisten lähtevien puhelujen oletusarvo on 60 sekuntia. Asetus ei muuta saapuvien puhelujen hälytystä. |
| Mitä jos operaattorini hylkää kylmän siirron? | Tavallisesti operaattorisi yhdistää puhelun kohteeseen. Jotkin operaattoriyhteydet hylkäävät siirrot, esimerkiksi Twilio-runko, jossa puhelunsiirtoa (SIP REFER) ei ole otettu käyttöön. Kun puhelun numerolla voi soittaa lähteviä puheluita, ThunderPhone yhdistää puhelun itse: se soittaa kohteeseen, soittaja kuulee hälytysäänen, kunnes kohde vastaa, ja agentti poistuu ilman esittelyä. Tallennus päättyy siirtoon. Jos kukaan ei vastaa tai numerolla ei voi soittaa lähteviä puheluita, puhelu päättyy. Organisaatiosi ylläpitäjät saavat sähköpostin ensimmäisellä kerralla, kun yhteys hylkää siirron. Kun yhdistät Twilio-tilin hallintapaneelissa, **Salli puhelunsiirrot** -asetus, joka on oletusarvoisesti käytössä, ottaa siirrot käyttöön sen SIP-rungossa. Jos sinulla on jo Twilio-yhteys, käytä VoIP-yhteydet-sivulla **Ota puhelunsiirrot käyttöön** -asetusta. Muilla operaattoreilla asetus löytyy niiden omasta portaalista. |
| Kuinka kauan ihmisten välinen siltayhteys voi kestää? | Enintään 4 tuntia sen jälkeen, kun agentti yhdistää kaksi henkilöä. Kun käytössä on **Esittele linjalla**, siltayhteyttä ei tallenneta: tallennus päättyy, kun siirto alkaa. Kun käytössä ovat **Kysy ensin** ja **Kuiskaa**, se tallennetaan, jos agentti tallentaa puhelut. |
| Mitä tapahtuu epäonnistuessa? | Lämpimässä siirrossa soittaja palaa agentille tuloksen kanssa, jos kohde ei vastaa, on varattu tai lähtevä yhteys epäonnistuu. Kehotteen tulee määrittää seuraava vaihe. Kylmä siirto on jo päättänyt agentin osuuden puhelusta, joten epäonnistunut kylmä siirto päättää puhelun. |
| Mitä se maksaa? | Siirtotyökalusta ei peritä maksua. Tavalliset puhelumaksut sisältävät lämpimän siirron kulun siihen asti, kun agentti poistuu. Kun puheagentti poistuu lämpimästä siirrosta, ThunderPhone pitää kaksi henkilöä yhdistettyinä ja laskuttaa tästä ajasta minuuttiperusteisen siltayhteyshinnan mukaan; katso [Hinnoittelu](/fi/guides/pricing). Kylmä siirto lopettaa mittauksen siirtohetkellä. Kun ThunderPhone yhdistää itse hylätyn kylmän siirron, yhdistetystä ajasta laskutetaan samalla siltayhteyshinnalla. Tuoduissa VoIP-numeroissa operaattorisi voi jatkaa siirtoyhteyden laskuttamista, kun kaksi henkilöä pysyy yhdistettyinä. |

## Webhookit ja päättymissyyt

Valmistumisen hyötykuorma tallentaa kohteen kenttään `transfer_number` ja käyttää
yhtä näistä päättymissyistä:

| `end_reason` | Merkitys |
| --- | --- |
| `ai_transfer` | Agentti aloitti kylmän siirron. |
| `ai_warm_transfer` | Kohde vastasi lämpimään siirtoon, osapuolet yhdistettiin ja agentti poistui puhelusta. |

Vastaamaton, varattu tai epäonnistunut lämmin siirtoyritys ei ole valmis siirto. Soittaja palaa agentille, joten lopullinen lopetussyy kuvastaa sitä, mikä päättää alkuperäisen puhelun.

Onnistuneessa lämpimässä siirrossa valmistumistapahtuma ja AI-puhelun lopetussyy tallennetaan, kun agentti poistuu puhelusta heti osapuolten yhdistämisen jälkeen.
Kun käytössä on **Esittele linjalla**, tallenne kattaa puhelun siirtoon asti ja päättyy siihen (`recording_stopped_at`); kahden henkilön välistä keskustelua ei tallenneta eikä litteroida. Kun käytössä ovat **Kysy ensin** ja **Kuiskaa**, tallennus jatkuu (jos agentti tallentaa puhelut), kunnes yhdistetty puhelu päättyy.

<Accordion title="Vanha valmistumisen webhook">
  Vanha yhden URL-osoitteen webhook voi viivästyttää kylmää siirtoa enintään viisi minuuttia
  palauttamalla `{"transfer_ready": false}` ja päivittämällä myöhemmin puhelun
  siirtovalmiuden tilan. Webhook-päätepisteen toimitukset ja lämpimät siirrot eivät
  käytä tätä koordinointia.
</Accordion>

Katso [Valmistumisen webhookit](/fi/webhooks/call-complete), jos haluat nähdä täydellisen hyötykuorman ja
vanhan toiminnan.

## Vianmääritys

### Puhelu katkeaa, kun agentti siirtää puhelun

Tarkista kohteen maa. ThunderPhone-numeroissa olevat puhelut tukevat puhelunsiirtoja vain yhdysvaltalaisiin numeroihin. Operaattori voi hylätä puhelunsiirron toiseen maahan, jolloin soittajan yhteys katkeaa ja puhelu päättyy silti tilaan `ai_transfer`. Jos haluat soittaa muihin maihin,
[yhdistä oma operaattorisi](/fi/guides/voip-providers) ja reititä puhelu sieltä tuodun numeron kautta. Operaattorin on hyväksyttävä puhelunsiirrot ja sallittava puhelut kyseiseen maahan. Ota Twilio SIP -rungossa käyttöön **Puhelunsiirrot** ja **Ota puhelunsiirrot PSTN:ään käyttöön**.

### Agentti tekee kylmän siirron lämpimän siirron sijaan

Varmista, että puhelussa käytetään numeroa, jolla voi soittaa lähteviä puheluita: vahvistettua, tuotua VoIP-numeroa, jossa lähtevien puheluiden reititys toimii, tai ThunderPhone-numeroa, jonka lähtevät puhelut on hyväksytty. Lämmin tila poistetaan työkalun vaihtoehdoista muiden numeroiden ja muiden kuin puhelinistuntojen osalta. Määritä tila myös selkeästi kehotteen
reititystaulukossa.

### Kohde ei koskaan vastaa

Varmista, että VoIP-runkosi voi soittaa lähteviä puheluita kohteeseen ja että sen todennus- ja reitityssäännöt ovat ajan tasalla. Tarkista kohtaan **Siirtonumerot** tallennettu numero. Lisää `ring_duration_seconds`-arvoa, jos 45 sekuntia on liian lyhyt
lämpimälle siirrolle.

### Kohde ohjautuu vastaajaan

**Esittele linjalla** -toiminnolla soittaja yhdistetään siihen, mikä tahansa vastaa,
myös vastaajatervehdykseen. Agentti tunnistaa tervehdyksen, ei sano mitään vastaajaan ja katkaisee puhelun, jolloin soittaja voi jättää viestin. **Kysy ensin**- ja **Kuiskaus**-toiminnoilla agentti katkaisee puhelun vastaajaan ja soittaja palaa agentin luo. Jos kohde ohjautuu usein vastaajaan, anna agentille kehotteessa sille toinen reitti.

### Kylmä siirto odottaa ennen yhdistämistä

Jos käytät vanhaa yhden URL-osoitteen webhookia, tarkista, palauttiko se arvon
`{"transfer_ready": false}`. Soittaja kuulee pitomusiikkia, kun ThunderPhone
odottaa. Päivitä puhelun siirtovalmiustila, kun kohde on valmis.

### Agentti sanoo, ettei se voi siirtää puhelua

Tarkista, että agentilla on siirtonumeroita ja että kehotteessa käytetään samoja nimiä. Agentilla, jolla ei ole siirtonumeroita, ei ole lainkaan puhelunsiirtotoimintoa. Jos puhelunsiirto kulkee ThunderPhonen linjaa pitkin (katso
[Mihin numeroihin puhelu voi soittaa](#which-numbers-a-call-can-reach)), kohteen on oltava yhdysvaltalainen numero, joka ei ole maksullinen palvelunumero. Tarkista muuttujanumeron kohdalla, että puhelun muuttujissa on sille kelvollinen puhelinnumero.

### Julkaisu epäonnistuu siirtonumerovirheen vuoksi

Jokainen julkaisu tarkistaa tallennetut siirtonumerot uudelleen. Yhdysvaltojen ulkopuolinen numero, joka tallennettiin, kun organisaatiollasi oli numero omalla operaattorillaan, ei läpäise tarkistusta, kun organisaatiolla ei enää ole sellaista. Poista numero tai yhdistä oma operaattorisi uudelleen.

### Henkilöstön kuiskaus ei käynnistä siirtoa

Reaaliaikaisen puhelun kuiskaus vain ohjaa tekoälyä. Lisää siirto-ohjeet
agentin kehotteeseen ja anna sen kutsua `transfer_call`. Katso
[Seuraa reaaliaikaisia puheluja](/fi/guides/monitor-live-calls).