---
title: "Przekazywanie połączeń"
description: "Zapisz numery, na które agent może przekazywać połączenia, a następnie kieruj rozmówców za pomocą zimnego przekazania lub pozostań na linii i przedstaw ich przy ciepłym przekazaniu."
---

Agent przekazuje połączenia wyłącznie na swoje **numery przekierowań**: listę nazw i
numerów telefonów zapisanych przy agencie. Prompt odwołuje się do każdego numeru po nazwie
i określa, kiedy przekazać połączenie oraz czy przekazanie ma być zimne czy ciepłe. Agent
widzi tylko nazwy, nigdy numery. Agent bez numerów przekierowań nie może przekazywać połączeń.

| Tryb | Co się dzieje | Użyj, gdy |
| --- | --- | --- |
| **Zimny** | Rozmówca jest kierowany bezpośrednio do miejsca docelowego. Agent nie przedstawia rozmówcy ani nie potwierdza, że ktokolwiek odbierze. | Szybkie przekierowanie jest ważniejsze niż przedstawienie albo numer połączenia nie może wykonywać połączeń wychodzących. |
| **Ciepły** | Gdy tylko ktoś odbierze, rozmówca zostaje połączony, agent przedstawia rozmówcę na linii i rozłącza się. Możesz zamiast tego ustawić, aby agent [najpierw zapytał lub wyszeptał informację](#before-connecting). | Miejsce docelowe powinno wiedzieć, kto dzwoni i dlaczego, albo rozmówca powinien wrócić do agenta, gdy nikt nie odbierze. |

Jeśli agent pominie tryb, przekazanie jest zimne.

## Konfigurowanie przekazań

W panelu:

1. Otwórz **Agentów głosowych**, wybierz agenta i otwórz **Konfigurację**.
2. W sekcji **Numery przekierowań** dodaj każdy cel, podając nazwę i numer
   telefonu, na przykład **Billing** i `+1 415 555 2671`. Agent może mieć do
   50 numerów przekierowań.
3. W prompcie odwołaj się do każdego celu po nazwie i określ, kiedy go używać
   oraz czy używać trybu `cold` czy `warm`, na przykład „przekieruj pytania
   dotyczące rozliczeń do Billing”. Nie tworzysz niestandardowego narzędzia.
4. W przypadku ciepłych przekierowań wybierz, co ma się wydarzyć **Przed połączeniem**,
   oraz opcjonalnie, co ma zawierać **Briefing**. Zobacz
   [Przed połączeniem](#before-connecting).
5. W razie potrzeby ustaw **Zaawansowane → Czas dzwonienia** od 5 do 120 sekund.
6. Wybierz **Wdróż**.

Za pomocą interfejsu API użyj `PATCH /v1/agents/{agent_id}`, aby przygotować
`transfer_destinations`, prompt oraz opcjonalne `warm_transfer_style`, `warm_transfer_briefing`
i `ring_duration_seconds`, a następnie `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."
}
```

Zapis zastępuje całą listę, a `[]` usuwa wszystkie numery przekierowań. Zobacz
[API agentów](/api-reference/agents#transfer-numbers), aby poznać reguły pól i
błędy walidacji.

### Nazwy i numery

- **Nazwa:** od 1 do 60 znaków, unikatowa dla agenta bez uwzględniania wielkości liter. To
  słowo używane w instrukcji.
- **Numer:** pełny numer telefonu. Numery bez kodu kraju są odczytywane jako
  numery USA, a każdy numer jest przechowywany w formacie E.164. Numery
  wewnętrzne oraz fikcyjny zakres od 555-0100 do 555-0199 są odrzucane.
- **Numer ze zmiennej:** zamiast numeru telefonu — jedna
  [zmienna połączenia](/pl/guides/call-variables), na przykład `{{rep_phone}}`.
  Jest uzupełniany na podstawie zmiennych połączenia, gdy połączenie się
  rozpoczyna. Jeśli zmiennej brakuje lub nie jest prawidłowym numerem dla tego
  połączenia, przekazanie do tej nazwy zostanie odrzucone.

### Jakie numery może osiągnąć połączenie

To, do jakich numerów można przekazać połączenie, zależy od linii, przez którą
jest realizowane przekazanie. Przekazanie realizowane przez linię ThunderPhone
może osiągać tylko numery USA, z wyłączeniem numerów o podwyższonej opłacie i
innych numerów usług specjalnych. Przekazanie realizowane przez
[własnego operatora](/pl/guides/voip-providers) może osiągać każdy zapisany numer.

| Przekazanie | Realizowane przez |
| --- | --- |
| Zimne przekazanie w połączeniu przychodzącym | Operatora, przez którego połączenie nadeszło: linię ThunderPhone dla numeru ThunderPhone, własnego operatora dla numeru u własnego operatora. |
| Zimne przekazanie w połączeniu wychodzącym | Linię, z której wykonano połączenie. |
| Ciepłe przekazanie (nowa gałąź do celu) | Linię, z której wybierana jest nowa gałąź. |

Numer u własnego operatora realizuje połączenia wychodzące i ciepłe gałęzie
wyłącznie przez trunk wychodzący własnego połączenia: ręcznie skonfigurowane
połączenia SIP z trunkem wychodzącym, połączenia Twilio ze skonfigurowanymi
połączeniami wychodzącymi oraz połączenia Telnyx. Bez tego trunku numer w ogóle
nie może wykonywać połączeń wychodzących, więc obsługuje tylko zimne
przekazanie. Te połączenia nigdy nie przechodzą awaryjnie na linię
ThunderPhone.

Jeśli organizacja nie ma numerów u własnego operatora, zapisanie numeru,
którego linia ThunderPhone nie może osiągnąć, kończy się błędem. Po podłączeniu
własnego operatora numery te można zapisać i są oznaczane jako działające
wyłącznie w przekazaniach realizowanych przez operatora (`platform_ok: false`
w API). Jeden agent może odbierać połączenia na obu rodzajach numerów, dlatego
sprawdzenie jest wykonywane dla każdego połączenia.

## Przed połączeniem

Każdy agent wybiera, co dzieje się, gdy osoba docelowa odbierze ciepłe
przekazanie. Ustawienie dotyczy każdego ciepłego przekazania wykonywanego przez
agenta.

| Ustawienie | Wartość API | Co się dzieje | Czas oczekiwania rozmówcy |
| --- | --- | --- | --- |
| **Przedstaw na linii** (domyślnie) | `introduce` | Rozmówca zostaje połączony, gdy tylko osoba docelowa odbierze, i słyszy jej powitanie. Gdy osoba, która odebrała, skończy mówić, agent przedstawia rozmówcę w jednym lub dwóch zdaniach, które słyszą obie strony, a następnie się rozłącza. Nikt nie jest o nic pytany. | Tylko dzwonienie. |
| **Zapytaj najpierw** | `ask_first` | Agent prywatnie przekazuje kontekst osobie, która odbiera, i pyta, czy może przyjąć połączenie. Może ona zadawać pytania, zaakceptować lub odrzucić połączenie. Jeśli je zaakceptuje, rozmówca zostaje połączony, agent przedstawia go na linii i się rozłącza. | Dzwonienie oraz prywatna rozmowa, często 15 sekund lub dłużej. |
| **Szept** | `whisper` | Agent prywatnie informuje osobę, która odbiera, kto dzwoni i dlaczego, w jednym krótkim zdaniu. Niczego nie pyta. Następnie rozmówca zostaje połączony, a agent rozłącza się, nie mówiąc nic na linii. | Dzwonienie oraz jedno prywatne zdanie. |

Używaj **Przedstaw na linii**, chyba że osoba odbierająca musi mieć możliwość
odrzucania połączeń lub powinna poznać informacje o rozmówcy, zanim rozmówca
zostanie połączony. **Zapytaj najpierw** umożliwia jej odmowę, ale wydłuża czas
oczekiwania rozmówcy, a poczta głosowa, cisza lub odmowa kierują rozmówcę z
powrotem do agenta. **Szept** prywatnie przekazuje jej kontekst bez zadawania
pytań; poczta głosowa kieruje rozmówcę z powrotem do agenta.

### Informacja wstępna

Ustawienie **Informacja wstępna** określa, co agent mówi osobie odbierającej
o rozmówcy. W przypadku **Przedstaw na linii** jest to przedstawienie, które
obydwie osoby słyszą po połączeniu. Domyślnie jest bardzo krótkie: kto dzwoni
i w jakiej sprawie, na przykład „Cześć, mam na linii Alexa w sprawie zamówienia.
Alex, możesz mówić”. W przypadku **Najpierw zapytaj** jest to jedno prywatne
zdanie przed połączeniem rozmówcy, zakończone pytaniem, czy osoba może odebrać
połączenie; przedstawienie po akceptacji opiera się na tej samej zasadzie. W
przypadku **Szept** jest to jedno prywatne zdanie przed połączeniem rozmówcy,
na przykład „Dzwoni Alex w sprawie opóźnionego zamówienia, przełączam go
teraz”. Jest to stwierdzenie, a nie pytanie.

Aby zmienić jego treść, wpisz instrukcję **Informacja wstępna** dla agenta
(`warm_transfer_briefing`, maksymalnie 300 znaków), na przykład „Imię
rozmówcy, numer jego konta oraz to, czego potrzebuje”. Agent stosuje ją podczas
tworzenia każdego przedstawienia lub informacji wstępnej. Ogranicz ją do kilku
istotnych faktów: przedstawienie lub zdanie **Szept** dłuższe niż około 40
słów albo informacja wstępna **Najpierw zapytaj** dłuższa niż około 25 słów
zostaną zastąpione krótkim standardowym komunikatem. Pozostaw pole puste, aby
użyć ustawienia domyślnego.

## Co dzieje się podczas ciepłego przekazania

Z opcją **Przedstawienie na linii** (domyślną):

1. Agent informuje rozmówcę, że rozpoczyna transfer. Nagrywanie połączenia
   zostaje zatrzymane, a ThunderPhone od razu zaczyna dzwonić pod numer docelowy
   z numeru obsługującego połączenie, podczas gdy agent nadal mówi.
2. Gdy numer docelowy dzwoni, rozmówca krótko czeka w ciszy. W tym trybie
   nie ma muzyki oczekiwania.
3. Gdy tylko odbiorca odbierze, rozmówca jest już na linii, więc słyszy powitanie od pierwszego słowa.
4. Gdy osoba, która odebrała, skończy mówić i czeka na odpowiedź,
   agent przedstawia rozmówcę w jednym lub dwóch zdaniach, które słyszą
   obie strony, na przykład: „Dzień dobry, mam na linii Aleksa w sprawie zamówienia. Aleks, możesz mówić.”
   Agent ocenia to na podstawie tego, co zostało powiedziane, a nie na podstawie przerwy: komunikat
   o nagrywaniu lub „proszę czekać” nie oznacza końca wypowiedzi, natomiast „W czym mogę
   pomóc?” już tak. Jeśli osoba nic nie powie, agent rozpoczyna po około 3
   sekundach. Jeśli zacznie mówić podczas przedstawienia, agent przestaje,
   pozwala jej skończyć i ponownie przedstawia rozmówcę. Po około 15 sekundach, na przykład podczas
   długiego menu telefonicznego, agent mimo to przedstawia rozmówcę. Brakujące lub
   zbyt długie przedstawienie zostaje zastąpione krótkim standardowym komunikatem, wypowiedzianym
   w języku połączenia.
5. Agent rozłącza się automatycznie; nic więcej nie zostaje powiedziane.

Połączona zostaje osoba, która odbierze. Jeśli jest to powitanie poczty głosowej, agent
nic do niego nie mówi i rozłącza się, aby rozmówca mógł zostawić wiadomość. Jeśli
numer docelowy nie odbiera, jest zajęty,
nie można zestawić połączenia lub osoba, która odebrała, rozłączy się przed końcem
przedstawienia, ThunderPhone kończy to połączenie, a rozmówca wraca do
agenta. Agent otrzymuje wynik i kontynuuje pierwotną rozmowę.
Może przyjąć wiadomość, zaproponować inną opcję lub wykonać transfer bez zapowiedzi, jeśli
rozmówca nadal tego chce.

<Note>
  W przypadku **Przedstawienia na linii** nagrywanie kończy się wraz z rozpoczęciem transferu
  z zapowiedzią, tak jak w przypadku transferu bez zapowiedzi. Nic, co mówi odbiorca, nie jest
  nagrywane ani transkrybowane (ThunderPhone jedynie nasłuchuje do momentu przedstawienia,
  aby określić, kiedy odbiorca mówi i kiedy skończył), dlatego nie słyszy
  komunikatu agenta o zgodzie. Jeśli transfer się nie powiedzie i rozmówca wróci do agenta,
  pozostała część połączenia również nie jest nagrywana; jej transkrypcja jest kontynuowana. Obiekt
  [połączenia](/api-reference/calls#call-object) oraz
  [webhook ukończenia](/pl/webhooks/call-complete) wskazują, kiedy to nastąpiło:
  `recording_stopped_at` oznacza moment zatrzymania nagrywania, a
  `recording_stopped_reason` ma wartość `warm_transfer`.
</Note>

### Z opcją Najpierw zapytaj

1. Agent informuje rozmówcę, że rozpoczyna przekierowanie, a następnie rozmówca
   słyszy muzykę oczekiwania, gdy numer docelowy dzwoni.
2. Gdy osoba docelowa odbierze połączenie, agent pozwala jej najpierw dokończyć
   powitanie, oceniane w taki sam sposób jak powyżej. Jeśli komunikat agenta o
   zgodzie jest włączony, osoba odbierająca słyszy go jako pierwsza. Następnie
   agent przekazuje informację wstępną i pyta, czy może odebrać połączenie.
   Rozmówca, pozostający w oczekiwaniu, nie słyszy nic z tego.
3. Osoba może zadawać pytania, na które agent odpowiada na podstawie
   dotychczasowej rozmowy. Jeśli zaakceptuje połączenie, rozmówca zostaje
   połączony, agent przedstawia go w jednym lub dwóch zdaniach, które słyszą
   obydwie osoby, a następnie się rozłącza.
4. Jeśli osoba odmówi, nie odpowie lub połączenie trafi do poczty głosowej,
   ThunderPhone kończy to połączenie i wyłącza rozmówcę z oczekiwania. Agent
   otrzymuje wynik, w tym każdą wiadomość, o której przekazanie poprosiła
   osoba odbierająca, i kontynuuje rozmowę z rozmówcą.

W tym stylu przekierowanie nie przerywa nagrywania połączenia. Jeśli agent
nagrywa połączenia, nagrywane są zarówno prywatna rozmowa z osobą odbierającą,
jak i połączona rozmowa. Jeśli nagrywanie połączeń jest wyłączone dla agenta,
żadna z nich nie jest nagrywana.

### Z opcją Szept

1. Agent informuje rozmówcę, że rozpoczyna przekierowanie, a następnie rozmówca
   słyszy muzykę oczekiwania, gdy numer docelowy dzwoni.
2. Gdy osoba docelowa odbierze połączenie, agent czeka, aż osoba odbierająca
   dokończy powitanie. Jeśli komunikat agenta o zgodzie jest włączony, osoba
   odbierająca słyszy go jako pierwsza. Następnie agent informuje ją w jednym
   krótkim zdaniu, kto dzwoni i w jakiej sprawie. Nie pyta, czy może odebrać
   połączenie. Rozmówca, pozostający w oczekiwaniu, nie słyszy nic z tego.
3. Rozmówca zostaje połączony, a agent się rozłącza. Na linii nie padają żadne
   słowa.
4. Jeśli połączenie trafi do poczty głosowej, agent rozłącza je i wyłącza
   rozmówcę z oczekiwania. Jeśli osoba docelowa nie odbierze, będzie zajęta lub
   nie będzie można nawiązać połączenia, rozmówca również wraca do agenta.
   Agent otrzymuje wynik i kontynuuje rozmowę z rozmówcą.

Nagrywanie działa tak samo jak w przypadku **Najpierw zapytaj**: jeśli agent
nagrywa połączenia, nagrywane są zarówno prywatne zdanie, jak i połączona
rozmowa.

## Wskazówki dla agenta dotyczące prawidłowego przekazywania połączeń

Umieść reguły przekierowywania w promptcie agenta i nazwij każdy cel dokładnie tak,
jak widnieje w sekcji **Numery przekierowań**. Nie wpisuj numerów telefonów w
prompcie; agent przekierowuje według nazwy. Określ tryb przekierowania dla każdej trasy
i zapewnij agentowi rozwiązanie awaryjne na wypadek nieudanego ciepłego przekierowania.

```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.
```

Agent podaje te pola, gdy wywołuje wbudowaną akcję:

| Pole | Kiedy używane | Cel |
| --- | --- | --- |
| `destination` | Zawsze | Nazwa jednego z numerów przekierowań agenta. |
| `mode` | Opcjonalnie | `cold` lub `warm`; domyślnie `cold`. |
| `screen_message` | Wymagane dla ciepłego przekierowania | W przypadku **Przedstaw na linii** jest to [przedstawienie](#the-briefing), które rozmówca i osoba odbierająca słyszą po połączeniu. W przypadku **Najpierw zapytaj** jest to prywatne omówienie, które osoba odbierająca słyszy przed podjęciem decyzji. W przypadku **Szept** jest to prywatne zdanie, które osoba odbierająca słyszy przed połączeniem rozmówcy. Rozmówca nie słyszy żadnej z prywatnych informacji. |
| `introduction` | Opcjonalnie dla ciepłego przekierowania | W przypadku **Najpierw zapytaj** jest to przedstawienie, które obie strony słyszą, gdy osoba zaakceptuje połączenie. W przypadku **Przedstaw na linii** jest używane tylko wtedy, gdy `screen_message` jest puste. Nie jest dostępne w przypadku **Szept**, ponieważ na linii nic nie jest mówione. |

Nie musisz definiować ani dołączać niestandardowego narzędzia o nazwie `transfer_call`.
Opis akcji jest zgodny z ustawieniami agenta **Przed połączeniem** i
**Omówienie**, więc prompt nie musi ich powtarzać.

## Gdy przekazanie zostanie odrzucone

ThunderPhone sprawdza każde przekazanie przed jego wykonaniem. Odrzuca przekazanie, gdy nazwa nie jest jedną z nazw numerów przekierowania agenta, gdy numer zmienny nie ma prawidłowej wartości w tym połączeniu lub gdy przekazanie realizowane na linii ThunderPhone prowadziłoby do numeru poza USA albo numeru o podwyższonej opłacie.

Odrzucone przekazanie nie kończy połączenia. Agent nie zapowiada przekazania, otrzymuje jego przyczynę (w tym listę prawidłowych nazw, gdy nazwa nie pasowała) i kontynuuje rozmowę z rozmówcą. W prompcie określ, co ma zrobić zamiast tego, na przykład przyjąć wiadomość. Odrzucenie pojawia się jako błąd narzędzia w historii połączenia.

## Przekazania z szeptem

„Transfer z szeptem” to powszechna w branży nazwa transferu konsultowanego, w którym odbiorca słyszy prywatny kontekst przed połączeniem z rozmówcą, bez pytania, czy chce odebrać połączenie. Jest to ustawienie **Szept** w sekcji
[Przed połączeniem](#before-connecting).

Różni się to od
[`POST /v1/calls/{id}/whisper`](/pl/guides/monitor-live-calls).
Ten punkt końcowy umożliwia pracownikowi lub właścicielowi wysłanie prywatnych wskazówek tekstowych do agenta AI
podczas trwającego połączenia. Nie dzwoni on ani nie przekazuje informacji celowi przekazania.

## Wymagania, ograniczenia i testowanie

| Pytanie | Odpowiedź |
| --- | --- |
| Do jakich miejsc docelowych może zostać przekazane połączenie? | W przypadku numeru udostępnionego przez ThunderPhone obsługiwane są tylko numery w USA, w tym numery bezpłatne; numery w Kanadzie, innych krajach z kodem +1 oraz numery o podwyższonej opłacie nie są obsługiwane. ThunderPhone odrzuca każde inne miejsce docelowe przed wybraniem numeru: rozmówca pozostaje na linii, a agent otrzymuje przyczynę i kontynuuje rozmowę (zobacz [Gdy przekazanie zostanie odrzucone](#when-a-transfer-is-refused)). Aby przekazywać połączenia do innych krajów, [podłącz własnego operatora](/pl/guides/voip-providers) i odbieraj połączenia na numerze zaimportowanym za jego pośrednictwem. Przekazanie jest wtedy realizowane przez Twojego operatora, więc musi on akceptować przekazywanie połączeń i zezwalać na połączenia do tego kraju. W przypadku łącza SIP Twilio włącz **Przekazywanie połączeń** oraz **Włącz przekazywanie połączeń do PSTN**. |
| Które numery obsługują przekazanie z konsultacją? | Numer, z którego można wykonywać połączenia wychodzące: zweryfikowany numer zaimportowany przez połączenie VoIP z obsługą połączeń wychodzących albo numer udostępniony przez ThunderPhone po zatwierdzeniu [wniosku o połączenia wychodzące](/pl/guides/get-a-phone-number) Twojej organizacji. Pozostałe numery ThunderPhone obsługują tylko przekazanie bez konsultacji. Jeśli tryb z konsultacją jest niedostępny, akcja przełącza się na przekazanie bez konsultacji. [Podłącz dostawcę VoIP](/pl/guides/voip-providers). |
| Które typy połączeń to obsługują? | Przekazanie bez konsultacji jest dostępne w zwykłych połączeniach telefonicznych. Browser Talk, widżety, symulacje i połączenia testowe nie pozwalają testować przekazania z konsultacją. Realtime zapisanego agenta nie obejmuje `transfer_call`; wbudowany Realtime z `call_events` może żądać przekazania bez konsultacji. |
| Co z połączeniami bez zapisanego agenta? | [Połączenie wychodzące](/api-reference/outbound-calls) lub odpowiedź [`call.incoming`](/pl/webhooks/call-incoming) z wbudowanym `config`, a także wbudowana sesja [Realtime](/api-reference/realtime#call-events), akceptują tę samą listę `transfer_destinations`. Z listą połączenie jest przekazywane tylko do wskazanych nazw. Bez listy agent zachowuje akcję przekazania, która przyjmuje numer telefonu, a połączenia na numerach ThunderPhone nadal mogą docierać wyłącznie do numerów w USA. |
| Jak to przetestować? | Sprawdź język routingu w Browser Talk lub symulacji: zobaczysz, którą nazwę wybiera agent albo że przekazanie zostaje odrzucone. Następnie przetestuj pełne przekazanie za pomocą rzeczywistego połączenia telefonicznego na numer agenta. Każdy numer ThunderPhone lub numer zaimportowany działa w przypadku przekazania bez konsultacji; przekazanie z konsultacją wymaga numeru ThunderPhone z zatwierdzonym wnioskiem o połączenia wychodzące albo zaimportowanego numeru z obsługą połączeń wychodzących. |
| Jak długo dzwoni numer docelowy? | `ring_duration_seconds` akceptuje wartości od 5 do 120 sekund. `null` używa 45 sekund dla przekazania z konsultacją i domyślnego czasu operatora dla przekazania bez konsultacji. Zwykłe połączenia wychodzące domyślnie używają 60 sekund. To ustawienie nie zmienia dzwonienia dla połączeń przychodzących. |
| Co, jeśli mój operator odrzuci przekazanie bez konsultacji? | Zwykle operator przekazuje połączenie do miejsca docelowego. Niektóre połączenia z operatorami odrzucają przekazania, na przykład łącze Twilio bez włączonego przekazywania połączeń (SIP REFER). Gdy numer połączenia może wykonywać połączenia wychodzące, ThunderPhone sam łączy wtedy połączenie: wybiera numer docelowy, rozmówca słyszy sygnał dzwonienia do momentu odebrania, a agent rozłącza się bez przedstawienia. Nagrywanie zatrzymuje się przy przekazaniu. Jeśli nikt nie odbierze albo numer nie może wykonywać połączeń wychodzących, połączenie zostaje zakończone. Administratorzy Twojej organizacji otrzymają e-mail, gdy połączenie po raz pierwszy odrzuci przekazanie. Gdy podłączasz konto Twilio w panelu, opcja **Zezwalaj na przekazywanie połączeń** (domyślnie włączona) włącza przekazywanie dla jego łącza SIP. W przypadku istniejącego połączenia Twilio użyj opcji **Włącz przekazywanie połączeń** na stronie połączeń VoIP. Inni operatorzy udostępniają to ustawienie we własnym portalu. |
| Jak długo może trwać połączenie między rozmówcami? | Do 4 godzin po połączeniu przez agenta obu osób. Przy opcji **Przedstaw na linii** połączenie między rozmówcami nie jest nagrywane: nagrywanie zatrzymuje się po rozpoczęciu przekazania. Przy opcjach **Najpierw zapytaj** i **Szept** jest nagrywane, gdy agent nagrywa połączenia. |
| Co dzieje się w razie niepowodzenia? | W przypadku przekazania z konsultacją, jeśli numer docelowy nie odpowie, jest zajęty albo połączenie wychodzące się nie powiedzie, rozmówca wraca do agenta z wynikiem. Prompt powinien określać następny krok. Przekazanie bez konsultacji kończy już udział agenta w połączeniu, więc nieudane przekazanie bez konsultacji kończy połączenie. |
| Ile to kosztuje? | Nie ma opłaty za narzędzie do przekazywania połączeń. Standardowe opłaty za połączenia obejmują proces przekazania z konsultacją, dopóki agent się nie rozłączy. Gdy AI opuści przekazanie z konsultacją, ThunderPhone utrzymuje połączenie między obiema osobami i nalicza za ten czas stawkę za minutę połączenia pomostowego; zobacz [Cennik](/pl/guides/pricing). Przekazanie bez konsultacji zatrzymuje naliczanie opłat w momencie przekazania. Gdy ThunderPhone sam łączy odrzucone przekazanie bez konsultacji, czas połączenia jest rozliczany według tej samej stawki za połączenie pomostowe. W przypadku zaimportowanych numerów VoIP Twój operator może nadal naliczać opłaty za część połączenia związaną z przekazaniem, gdy obie osoby pozostają połączone. |

## Webhooki i przyczyny zakończenia

Payload zakończenia zapisuje numer docelowy w `transfer_number` i używa
jednej z tych przyczyn zakończenia:

| `end_reason` | Znaczenie |
| --- | --- |
| `ai_transfer` | Agent zainicjował zimne przekierowanie. |
| `ai_warm_transfer` | Numer docelowy odebrał ciepłe przekierowanie, strony zostały połączone, a agent opuścił rozmowę. |

Nieodebrana, zajęta lub nieudana próba ciepłego przekierowania nie stanowi zrealizowanego przekierowania. Rozmówca wraca do agenta, więc ostateczna przyczyna zakończenia odzwierciedla to,
co kończy pierwotne połączenie.

W przypadku udanego ciepłego przekierowania zdarzenie zakończenia i przyczyna zakończenia połączenia AI są rejestrowane, gdy AI opuszcza rozmowę, bezpośrednio po połączeniu stron.
Przy opcji **Przedstaw na linii** nagranie obejmuje połączenie do momentu
przekierowania i kończy się w tym miejscu (`recording_stopped_at`); rozmowa między
obiema osobami nie jest ani nagrywana, ani transkrybowana. Przy opcjach **Najpierw zapytaj** i
**Szept** nagranie (gdy agent nagrywa połączenia) trwa do zakończenia połączonej rozmowy.

<Accordion title="Starszy webhook zakończenia">
  Starszy webhook z jednym adresem URL może opóźnić transfer bez konsultacji o maksymalnie pięć minut,
  zwracając `{"transfer_ready": false}`, a następnie aktualizując stan
  gotowości transferu połączenia. Dostarczanie webhooków do punktu końcowego i transfery z konsultacją nie
  korzystają z tej koordynacji.
</Accordion>

Zobacz [Webhooki zakończenia](/pl/webhooks/call-complete), aby poznać pełny payload i
starsze zachowanie.

## Rozwiązywanie problemów

### Połączenie zostaje przerwane, gdy agent je przekazuje

Sprawdź kraj docelowy. Połączenia na numerach ThunderPhone obsługują przekazywanie wyłącznie na numery w USA. Operator może odrzucić przekazanie do innego kraju, co rozłącza rozmówcę, a połączenie nadal kończy się przez `ai_transfer`. Aby łączyć się z innymi krajami,
[połącz własnego operatora](/pl/guides/voip-providers) i kieruj połączenie przez numer zaimportowany od niego. Operator musi akceptować przekazywanie połączeń i zezwalać na połączenia do tego kraju. W przypadku trunku SIP Twilio włącz **Przekazywanie połączeń** oraz **Włącz przekazywanie połączeń do PSTN**.

### Agent wykonuje transfer zimny zamiast ciepłego

Sprawdź, czy połączenie korzysta z numeru, który może wykonywać połączenia wychodzące: zweryfikowanego, zaimportowanego numeru VoIP z działającym routingiem połączeń wychodzących albo numeru ThunderPhone z zatwierdzoną obsługą połączeń wychodzących. Tryb ciepły jest usuwany z opcji narzędzia dla innych numerów i sesji niebędących połączeniami telefonicznymi. Uwzględnij też wyraźnie ten tryb w tabeli routingu promptu.

### Odbiorca nigdy nie odbiera

Potwierdź, że Twój trunk VoIP może wykonywać połączenia wychodzące do miejsca docelowego
oraz że jego reguły uwierzytelniania i routingu są aktualne. Sprawdź numer zapisany
w sekcji **Numery przekierowań**. Zwiększ `ring_duration_seconds`, jeśli 45 sekund to za krótko
na przekierowanie z zapowiedzią.

### Odbiorca trafia na pocztę głosową

W przypadku **Przedstawienia na linii** rozmówca zostaje połączony z tym, co odbierze połączenie,
w tym z powitaniem poczty głosowej. Agent rozpoznaje powitanie, nie mówi nic do skrzynki i rozłącza się, a rozmówca może zostawić wiadomość. W przypadku
**Najpierw zapytaj** i **Szeptu** agent rozłącza się z pocztą głosową, a rozmówca wraca do agenta. Jeśli cel często kieruje połączenia do poczty głosowej, podaj agentowi w promptcie inną trasę
dla niego.

### Transfer zimny oczekuje przed połączeniem

Jeśli używasz starszego webhooka z jednym adresem URL, sprawdź, czy zwrócił
`{"transfer_ready": false}`. Rozmówca słyszy muzykę oczekiwania, podczas gdy ThunderPhone czeka. Zaktualizuj stan gotowości transferu połączenia, gdy miejsce docelowe będzie przygotowane.

### Agent mówi, że nie może przekazać połączenia

Sprawdź, czy agent ma numery przekierowania i czy prompt używa tych samych nazw. Agent bez numerów przekierowania w ogóle nie ma działania przekazania. Jeśli przekazanie odbywa się na linii ThunderPhone (zobacz
[Do jakich numerów może dzwonić połączenie](#which-numbers-a-call-can-reach)), numer docelowy musi znajdować się w USA i nie może być numerem o podwyższonej opłacie. W przypadku numeru zmiennego sprawdź, czy zmienne połączenia zawierają dla niego prawidłowy numer telefonu.

### Wdrożenie kończy się niepowodzeniem z błędem numeru przekierowania

Każde wdrożenie ponownie sprawdza zapisane numery przekierowania. Numer spoza USA zapisany, gdy Twoja organizacja miała numer u własnego operatora, nie przejdzie sprawdzenia, gdy organizacja nie będzie już go mieć. Usuń numer lub ponownie połącz własnego operatora.

### Szept personelu nie rozpoczyna transferu

Szept podczas trwającego połączenia jedynie instruuje AI. Dodaj instrukcje transferu do promptu agenta i pozwól mu wywołać `transfer_call`. Zobacz
[Monitorowanie połączeń na żywo](/pl/guides/monitor-live-calls).
