Open in
Preusmjeravanje poziva
Usmjerite pozivatelje hladnim preusmjeravanjem ili najprije provjerite odredište toplim preusmjeravanjem.
Svaki glasovni agent ima ugrađenu radnju transfer_call. U uputi navedite agentu kada treba preusmjeriti poziv, koji broj koristiti i treba li prijenos biti hladan ili topao.
| Način | Što se događa | Upotrijebite kada |
|---|---|---|
| Hladni | Pozivatelj se izravno preusmjerava na odredište. Agent ne predstavlja pozivatelja niti potvrđuje hoće li se itko javiti. | Brzo usmjeravanje važnije je od prijenosa uz provjeru ili poziv koristi broj koji je dodijelio ThunderPhone. |
| Topli | Pozivatelj čeka na čekanju dok agent privatno zove odredište i provjerava ga. Strane se povezuju samo ako cilj prihvati poziv. | Cilju je potreban kontekst prije prihvaćanja ili se pozivatelj treba vratiti agentu kada nitko nije dostupan. |
Ako agent izostavi način, prijenos je hladan.
Konfiguriranje prijenosa
Na nadzornoj ploči:
- Otvorite Glasovni agenti, odaberite agenta i otvorite Konfiguracija.
- U uputu dodajte svako odredište, uvjet usmjeravanja i treba li koristiti način
coldiliwarm. Ne uključujete zaseban prekidač za prijenos niti stvarate prilagođeni alat. - Prema potrebi postavite Napredno → Trajanje zvonjenja od 5 do 120 sekundi.
- Odaberite Objavite.
Putem API-ja upotrijebite PATCH /v1/agents/{agent_id} za pripremu upute i neobaveznog parametra ring_duration_seconds, a zatim POST /v1/agents/{agent_id}/deploy. Pogledajte API za agente.
Što se događa tijekom toplog prijenosa
- Agent kaže pozivatelju da započinje prijenos.
- Pozivatelj čuje glazbu na čekanju. Pozivatelj ne može čuti zvonjenje cilja ni privatni razgovor.
- ThunderPhone zove cilj s VoIP broja koji obrađuje poziv. Agent isporučuje svoju poruku
screen_message, koja treba identificirati agenta, navesti ime pozivatelja, objasniti razlog poziva i pitati može li cilj preuzeti poziv. - Cilj može postavljati pitanja prije donošenja odluke. Agent odgovara na temelju izvornog razgovora i svoje upute dok pozivatelj ostaje na čekanju.
- Ako cilj prihvati, pozivatelj prestaje čekati i obje osobe čuju kratki uvod
introduction. Agent se zatim automatski isključuje. Dvije osobe ostaju povezane.
Ako cilj odbije, ne javi se ili se aktivira govorna pošta, ThunderPhone prekida taj privatni poziv i pozivatelj prestaje čekati. Agent prima ishod i nastavlja izvorni razgovor. Može primiti poruku, predložiti drugu rutu ili izvršiti hladni prijenos ako ga pozivatelj i dalje želi. Topli prijenos ne ostavlja poruku na govornoj pošti. Ako cilj zatraži od agenta da proslijedi poruku, rezultat alata uključuje je kao relay_message_for_caller.
Uputite agenta da pravilno preusmjerava pozive
Pravila usmjeravanja unesite u prompt agenta. Upotrijebite format E.164: +, pozivni broj države
i puni nacionalni broj, kao što je +14155550123. Odredite način preusmjeravanja
za svaku rutu i agentu navedite zamjensku opciju za neuspjele tople preusmjeravanja.
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.Agent navodi ova polja kada pozove ugrađenu radnju:
| Polje | Kada se koristi | Svrha |
|---|---|---|
phone_number | Uvijek | Odredište u formatu E.164. |
mode | Neobavezno | cold ili warm; zadano je cold. |
screen_message | Obavezno za toplo preusmjeravanje | Uvodna poruka koju odredište čuje privatno. |
introduction | Obavezno za toplo preusmjeravanje | Jedna kratka rečenica koju obje strane čuju nakon što odredište prihvati poziv. |
Ne morate definirati ni priložiti prilagođeni alat pod nazivom transfer_call.
Šaptano preusmjeravanje
„Šaptano preusmjeravanje” uobičajen je naziv u industriji za toplo preusmjeravanje pri kojem
odredište čuje privatni kontekst prije povezivanja s pozivateljem. U
ThunderPhoneu screen_message za toplo preusmjeravanje pruža taj privatni
sažetak. Odredište zatim može agentu postaviti dodatna pitanja prije prihvaćanja
ili odbijanja.
To se razlikuje od
POST /v1/calls/{id}/whisper.
Ta krajnja točka omogućuje članu osoblja ili vlasniku da tijekom aktivnog poziva pošalje privatne tekstualne upute AI
agentu. Ne poziva niti informira odredište preusmjeravanja.
Zahtjevi, ograničenja i testiranje
| Pitanje | Odgovor |
|---|---|
| Koji brojevi podržavaju topli prijenos? | Potvrđeni broj uvezen putem VoIP veze koja može upućivati odlazne pozive. Brojevi koje je dodijelio ThunderPhone podržavaju samo hladni prijenos. Ako topli način rada nije dostupan, radnja se vraća na hladni prijenos. Povežite VoIP pružatelja usluga. |
| Koje vrste poziva to podržavaju? | Hladni prijenos dostupan je u uobičajenim telefonskim pozivima. Browser Talk, widgeti, simulacije i testni pozivi ne mogu testirati toplu predaju. Realtime spremljenog agenta izostavlja transfer_call; ugrađeni Realtime s call_events može zatražiti hladni prijenos. |
| Kako to testirati? | Provjerite jezik usmjeravanja u Browser Talku ili simulaciji, a zatim testirajte cjelovitu predaju u stvarnom telefonskom pozivu pomoću odgovarajućeg uvezenog VoIP broja. |
| Koliko dugo odredište zvoni? | ring_duration_seconds prihvaća 5–120 sekundi. null koristi 45 sekundi za topli prijenos i zadanu vrijednost operatera za hladni prijenos. Uobičajeni odlazni pozivi prema zadanim postavkama koriste 60 sekundi. Postavka ne mijenja zvonjenje dolaznih poziva. |
| Koliko dugo može trajati veza između osoba? | Do 60 minuta nakon što agent poveže dvije osobe. |
| Što se događa pri neuspjehu? | Ako primatelj prijenosa odbije, ne odgovori, dosegne govornu poštu ili odlazni segment ne uspije, pozivatelj se vraća agentu s rezultatom. Uputa bi trebala definirati sljedeći korak. |
| Koliko to košta? | Nema naknade za alat za prijenos. Uobičajene naknade za pozive uključuju tijek toplog prijenosa do uvoda, a zatim ThunderPhone prestaje mjeriti potrošnju kada AI napusti poziv. Vaš operater može nastaviti naplaćivati odlazni segment prijenosa dok dvije osobe ostanu povezane. |
Webhookovi i razlozi završetka
Završni sadržaj bilježi odredišni broj u transfer_number i koristi
jedan od ovih razloga završetka:
end_reason | Značenje |
|---|---|
ai_transfer | Agent je pokrenuo hladni prijenos. |
ai_warm_transfer | Primatelj prijenosa prihvatio je topli prijenos, strane su povezane, a agent je napustio poziv nakon uvoda. |
Odbijeni, neodgovoreni, neuspjeli pokušaj toplog prijenosa ili pokušaj koji je dosegnuo govornu poštu nije dovršeni prijenos. Pozivatelj se vraća agentu, pa konačni razlog završetka odražava ono što završava izvorni poziv.
Za uspješan topli prijenos, događaj završetka i razlog završetka AI poziva bilježe se kada uvod završi i AI napusti poziv. Ako je snimanje omogućeno, zvuk se nastavlja snimati tijekom veze između osoba dok ona ne završi; govor nakon predaje snima se, ali se ne transkribira. Kada je omogućena obavijest o pristanku koju izgovara agent, primatelj prijenosa čuje je prije početka provjere.
Naslijeđeni webhook završetka
Naslijeđeni webhook s jednim URL-om može odgoditi hladni prijenos do pet minuta
vraćanjem {"transfer_ready": false} te kasnijim ažuriranjem stanja
spremnosti prijenosa poziva. Isporuke na krajnju točku webhooka i topli prijenosi ne
koriste ovu koordinaciju.
Pogledajte Webhookove završetka za cjeloviti sadržaj i naslijeđeno ponašanje.
Rješavanje problema
Agent izvršava hladni prijenos umjesto toplog
Provjerite koristi li poziv potvrđeni, uvezeni VoIP broj s ispravnim odlaznim usmjeravanjem. Topli način rada uklanja se iz opcija alata za ThunderPhone brojeve i sesije koje nisu telefonske. Također izričito navedite način rada u tablici usmjeravanja prompta.
Odredište se nikada ne javlja
Potvrdite da vaš VoIP trunk može upućivati odlazne pozive na odredište i
da su njegova pravila provjere autentičnosti i usmjeravanja ažurna. Provjerite formatiranje
odredišta prema E.164 standardu. Povećajte ring_duration_seconds ako je 45 sekundi prekratko
za topli prijenos.
Odredište preusmjerava na govornu poštu
Topli prijenosi ne ostavljaju govornu poruku. Pozivatelj više nije na čekanju, a
agent prima rezultat voicemail. U promptu navedite agentu treba li
primiti poruku, pokušati s drugim odredištem ili ponuditi hladni prijenos.
Pozivatelj ne dobiva poruku odredišta
Recite agentu da prenese relay_message_for_caller prije nego što ponudi sljedeće korake.
To je polje prisutno samo kada odredište odbije poziv i zatraži od agenta da nešto prenese.
Hladni prijenos čeka prije povezivanja
Ako upotrebljavate naslijeđeni webhook s jednim URL-om, provjerite je li vratio
{"transfer_ready": false}. Pozivatelj čuje glazbu na čekanju dok ThunderPhone
čeka. Ažurirajte stanje spremnosti prijenosa poziva kada je odredište spremno.
Šaptanje osoblju ne pokreće prijenos
Šaptanje tijekom poziva uživo samo usmjerava AI. Dodajte upute za prijenos u
prompt agenta i dopustite mu da pozove transfer_call. Pogledajte
Praćenje poziva uživo.