Open in
Преусмеравање позива
Усмерите позиваоце хладним преусмеравањем или прво проверите одредиште топлим преусмеравањем.
Сваки гласовни агент има уграђену радњу transfer_call. У упиту агента наведите када треба да пребаци позив, који број да користи и да ли преусмеравање треба да буде хладно или топло.
| Режим | Шта се дешава | Када га користити |
|---|---|---|
| Хладан | Позивалац се директно повезује са одредиштем. Агент не представља позиваоца нити потврђује да ће се неко јавити. | Када је брзо усмеравање важније од провереног преусмеравања или када позив користи број који је обезбедио ThunderPhone. |
| Топао | Позивалац чека на вези док агент приватно позива и проверава одредиште. Стране се повезују само ако циљна особа прихвати позив. | Циљној особи је потребан контекст пре прихватања или позивалац треба да се врати агенту када нико није доступан. |
Ако агент изостави режим, преусмеравање је хладно.
Конфигуришите преусмеравања
На контролној табли:
- Отворите Гласовни агенти, изаберите агента и отворите Конфигурација.
- У упит додајте свако одредиште, услов усмеравања и да ли треба користити режим
coldилиwarm. Не укључујете засебан прекидач за преусмеравање нити креирате прилагођену алатку. - По потреби подесите Напредно → Трајање звона на вредност од 5 до 120 секунди.
- Изаберите Примените.
Путем API-ја, извршите PATCH /v1/agents/{agent_id} да бисте припремили упит и опциони
ring_duration_seconds, а затим POST /v1/agents/{agent_id}/deploy. Погледајте
API за агенте.
Шта се дешава током топлог преусмеравања
- Агент обавештава позиваоца да започиње преусмеравање.
- Позивалац чује музику на чекању. Позивалац не може да чује звоњење код циљне особе нити приватни разговор.
- ThunderPhone позива циљну особу са VoIP броја који обрађује позив. Агент износи свој
screen_message, који треба да идентификује агента, наведе име позиваоца, објасни разлог позива и пита да ли циљна особа може да преузме позив. - Циљна особа може да поставља питања пре одлуке. Агент одговара на основу оригиналног разговора и свог упита док позивалац остаје на чекању.
- Ако циљна особа прихвати позив, позивалац престаје да чека и обе особе чују кратак
introduction. Агент се затим аутоматски искључује. Две особе остају повезане.
Ако циљна особа одбије, не јави се или се укључи говорна пошта, ThunderPhone
уклања тај приватни позив и скида позиваоца са чекања. Агент добија
исход и наставља оригинални разговор. Може да прими поруку, предложи
другу путању или обави хладно преусмеравање ако га позивалац и даље жели. Топло
преусмеравање не оставља поруку на говорној пошти. Ако циљна особа затражи од агента да проследи
поруку, резултат алатке је садржи као relay_message_for_caller.
Упутите агента да добро преусмерава позиве
Унесите правила усмеравања у упит агента. Користите формат E.164: +, позивни број земље
и цео национални број, као што је +14155550123. Наведите режим преусмеравања
за сваку руту и обезбедите агенту резервну опцију за неуспела топла преусмеравања.
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.Агент доставља ова поља када позива уграђену радњу:
| Поље | Када се користи | Сврха |
|---|---|---|
phone_number | Увек | Одредиште у формату E.164. |
mode | Опционално | cold или warm; подразумевано је cold. |
screen_message | Обавезно за топло преусмеравање | Уводна порука коју прималац чује приватно. |
introduction | Обавезно за топло преусмеравање | Једна кратка реченица коју обе стране чују након што прималац прихвати. |
Не морате да дефинишете нити повезујете прилагођени алат под називом transfer_call.
Преусмеравања шапатом
„Преусмеравање шапатом“ је уобичајен назив у индустрији за топло преусмеравање при коме
одредиште чује приватни контекст пре него што се позивалац повеже. У
ThunderPhone, screen_message топлог преусмеравања обезбеђује тај приватни
брифинг. Прималац затим може да поставља агенту додатна питања пре прихватања
или одбијања.
Ово се разликује од
POST /v1/calls/{id}/whisper.
Та крајња тачка омогућава члану особља или власнику да пошаље приватне текстуалне смернице AI
агенту током активног позива. Она не позива нити информише одредиште за преусмеравање.
Захтеви, ограничења и тестирање
| Питање | Одговор |
|---|---|
| Који бројеви подржавају топли трансфер? | Верификован број увезен преко VoIP везе која може да упућује одлазне позиве. Бројеви које је доделио ThunderPhone подржавају само хладни трансфер. Ако топли режим није доступан, радња се враћа на хладни трансфер. Повежите VoIP провајдера. |
| Које врсте позива га подржавају? | Хладни трансфер је доступан за обичне телефонске позиве. Browser Talk, виџети, симулације и тест позиви не могу да тестирају топлу примопредају. Realtime сачуваног агента изоставља transfer_call; уграђени Realtime са call_events може да затражи хладни трансфер. |
| Како да га тестирам? | Проверите језик рутирања у Browser Talk-у или симулацији, а затим тестирајте целокупну примопредају у стварном телефонском позиву помоћу одговарајућег увезеног VoIP броја. |
| Колико дуго одредиште звони? | ring_duration_seconds прихвата 5–120 секунди. null користи 45 секунди за топли трансфер и подразумевано подешавање провајдера за хладни трансфер. Обични одлазни позиви подразумевано трају 60 секунди. Ово подешавање не мења звоњење за долазне позиве. |
| Колико дуго може да траје веза између људи? | До 60 минута након што агент повеже две особе. |
| Шта се дешава при неуспеху? | Ако одредишни контакт одбије, не одговори, јави се говорна пошта или одлазни део позива не успе, позивалац се враћа агенту са резултатом. Упит треба да дефинише следећи корак. |
| Колико кошта? | Нема накнаде за алатку за трансфер. Уобичајене накнаде за позив обухватају ток топлог трансфера до завршетка увода, а затим се обрачун ThunderPhone-а зауставља када AI напусти позив. Ваш провајдер може наставити да наплаћује одлазни део трансфера док су две особе повезане. |
Веб-хукови и разлози завршетка
Подаци о завршетку бележе одредиште у transfer_number и користе
један од ових разлога завршетка:
end_reason | Значење |
|---|---|
ai_transfer | Агент је покренуо хладни трансфер. |
ai_warm_transfer | Одредишни контакт је прихватио топли трансфер, стране су повезане, а агент је напустио позив након увода. |
Одбијен, неодговорен, неуспео покушај топлог трансфера или покушај који је доспео до говорне поште није завршен трансфер. Позивалац се враћа агенту, па коначни разлог завршетка одражава оно што завршава првобитни позив.
За успешан топли трансфер, догађај завршетка и разлог завршетка AI позива бележе се када се увод заврши и AI напусти позив. Ако је снимање омогућено, аудио се наставља кроз везу између људи до њеног завршетка; говор након примопредаје се снима, али се не транскрибује. Када је најава пристанка агента омогућена, одредишни контакт трансфера је чује пре почетка провере.
Застарели веб-хук за завршетак
Застарели веб-хук са једним URL-ом може да одложи хладни трансфер до пет минута
враћањем {"transfer_ready": false} и каснијим ажурирањем стања
спремности за трансфер позива. Испоруке на крајњу тачку веб-хука и топли трансфери не
користе ову координацију.
Погледајте Веб-хукове за завршетак за комплетне податке и застарело понашање.
Решавање проблема
Агент обавља хладан трансфер уместо топлог
Проверите да ли позив користи верификован, увезен VoIP број са исправним одлазним рутирањем. Топли режим се уклања из опција алатке за ThunderPhone бројеве и сесије које нису телефонски позиви. Такође изричито наведите режим у табели рутирања упита.
Одредиште се никада не јавља
Потврдите да Ваш VoIP trunk може да упућује одлазне позиве ка одредишту и
да су његова правила аутентификације и рутирања ажурна. Проверите E.164 формат
одредишта. Повећајте ring_duration_seconds ако је 45 секунди прекратко
за топли трансфер.
Одредиште преусмерава на говорну пошту
Топли трансфери не остављају говорну поруку. Позивалац више није на чекању, а
агент добија резултат voicemail. У упиту агента наведите да ли треба да
прими поруку, покуша друго одредиште или понуди хладан трансфер.
Позивалац не добија поруку одредишта
Наведите агенту да пренесе relay_message_for_caller пре него што понуди
следеће кораке. Ово поље је присутно само када одредиште одбије позив и затражи
од агента да нешто пренесе.
Хладни трансфер чека пре повезивања
Ако користите застарели webhook са једним URL-ом, проверите да ли је вратио
{"transfer_ready": false}. Позивалац чује музику на чекању док ThunderPhone
чека. Ажурирајте стање спремности за трансфер позива када је одредиште припремљено.
Шапутање особљу не покреће трансфер
Шапутање током активног позива само усмерава AI. Додајте упутства за трансфер у
упит агента и дозволите му да позове transfer_call. Погледајте
Надгледање активних позива.