---
title: "Połącz z Five9"
description: "Przekierowuj połączenia Five9 do agenta ThunderPhone przez SIP za pomocą AI Agent Connect i odbieraj je z powrotem z nagłówkami routingu odczytywanymi przez skrypt IVR."
---

Skrypt IVR Five9 przekazuje rozmówcę do agenta wraz ze szczegółami połączenia z Five9. Gdy agent zakończy rozmowę, rozłącza ją z nagłówkami routingu w komunikacie SIP
`BYE`, które skrypt odczytuje do zmiennych połączenia, aby skierować rozmówcę dalej.

## Zanim zaczniesz

- Agent ThunderPhone i organizacyjny [klucz API](/pl/guides/api-keys).
- Dodatek Five9 **AI Agent Connect**. Five9 ogranicza go do akredytowanych dostawców AI, a zespół wdrożeniowy Five9 go konfiguruje: importuje szablon skryptu IVR dostawcy, tworzy zmienne połączenia i wskazuje dostawcę w module **Transfer zewnętrzny** skryptu. ThunderPhone nie znajduje się jeszcze na liście akredytowanych dostawców Five9: przed uwzględnieniem tego w planach skontaktuj się z zespołem obsługi konta Five9 lub pomocą techniczną ThunderPhone.

## 1. Utwórz punkt końcowy SIP

Moduł Transferu zewnętrznego Five9 wybiera numer telefonu, a nie adres SIP, a integracje Five9 innych dostawców uwierzytelniają Five9 według adresu źródłowego, a nie hasła. Utwórz więc punkt końcowy `ip_allowlist` z numerem, który Five9 będzie wybierać, jako numerem do wybierania przychodzącego (zobacz
[Platformy wybierające numer telefonu](/pl/guides/sip-addresses)):

```bash
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 12,
    "name": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: zakresy sygnalizacji SIP centrów danych Five9, uzyskane od Five9. Każdy musi być publicznym zakresem IPv4 o prefiksie `/16` lub węższym (IPv6 `/48` lub węższym).
- `dial_in_numbers`: numer, który będzie wybierał skrypt Five9, zapisany w formie wysyłanej przez Five9. Nie musi być prawdziwym numerem telefonu. Nie może być już używany w ThunderPhone jako numer telefonu ani w innym punkcie końcowym: w takim przypadku zwracany jest kod `409`.

Adresy Five9 są współdzielone przez wszystkich jego klientów, więc każdy inny klient Five9, który wybierze ten numer, połączy się z Twoim agentem. Wybierając numer, użyj długiego numeru, którego nikt nie odgadnie (do 15 cyfr), upewnij się, że Five9 wysyła go do ThunderPhone, a nie do sieci telefonicznej, i nie publikuj go.

## 2. Wysyłaj połączenia z kontekstem

Poproś zespół wdrożeniowy Five9 o:

- Wysyłanie połączeń z modułu **Transfer zewnętrzny** do
  `sip:+14155550188@sip.thunderphone.com`, z numerem zarówno w identyfikatorze URI żądania, jak i nagłówku `To`. Moduł pobiera numer, a domenę SIP dostawcy umieszcza w nagłówku.
- Wysyłanie ich przez TLS (port 5061) lub TCP (port 5060). Punkt końcowy odrzuca UDP, a Five9 nie publikuje informacji o używanym transporcie, więc upewnij się, że nie jest to UDP.
- Włączenie **Powrót po połączeniu zewnętrznym**, aby skrypt był kontynuowany po rozłączeniu przez agenta (Five9 zezwala na maksymalnie 3600 sekund połączenia zewnętrznego).

Przewodnik Five9 wymienia wysyłane wartości (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` i inne), ale nie nazwy ich
nagłówków. Integracje Five9 innych dostawców AI dokumentują je na poziomie protokołu
jako `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
i `X-AgentID`; sprawdź je podczas pierwszego połączenia testowego. Każda z nich trafia do promptu jako zmienna, na przykład
`{{sip_x_callcampaign}}`. `X-CallID` jest przechowywany jako
`external_call_id` połączenia.

## 3. Odbierz połączenie z powrotem

Agent zwraca połączenie: żegna się i rozłącza, a `BYE` zawiera
cztery nagłówki odczytywane przez skrypt Five9. Dodaj ten numer transferu (zobacz
[Dodawanie numeru transferu](/pl/guides/contact-centers/overview)):

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` i `X-RouteValue` informują skrypt, dokąd skierować rozmówcę,
  tutaj do umiejętności Support. Wartości `X-RouteType` dokumentowane przez innych dostawców obejmują
  `SkillTransfer`, `PhoneTransfer`, `Hangup` i `DispositionOnly`; uzgodnij te
  wartości z osobą utrzymującą skrypt. W przypadku kilku miejsc docelowych dodaj po jednym
  wpisie return dla każdego miejsca, z inną nazwą i wartością `X-RouteValue`.
- `X-RouteReason` zawiera etykietę intencji agenta, taką jak `billing_dispute`.
- `X-CustomMetaData` zawiera identyfikator przekazania. `BYE` zawiera go również jako
  `X-TP-Handoff-Id`, którego Five9 nie odczytuje.

Skrypt Five9 mapuje cztery nagłówki na zmienne połączenia. Aby uzyskać
podsumowanie agenta, skonfiguruj skrypt tak, aby wywoływał wyszukiwanie przekazania za pomocą modułu IVR **Zapytanie**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` po którym następuje
`call.call_id`, z profilem autoryzacji wysyłającym
`Authorization: Bearer` i Twój klucz API. Zobacz
[Wyszukiwanie przekazanego połączenia](/api-reference/calls#look-up-a-handed-off-call).

## Przetestuj

Zadzwoń do skryptu IVR, poproś agenta o połączenie z osobą i sprawdź, czy skrypt
kieruje rozmówcę z wypełnionymi zmiennymi połączenia. Jeśli połączenie nigdy nie dociera do
agenta, sprawdź, czy numer w URI żądania i nagłówku `To` odpowiada
numerowi dostępowemu, czy adres źródłowy Five9 znajduje się w `allowed_source_cidrs` oraz
czy połączenie przyszło przez TCP lub TLS. Następnie otwórz połączenie za pomocą
`GET /v1/calls/{call_id}`: `sip_headers` powinno zawierać `x-callid`, a
`external_call_id` powinno odpowiadać `call.call_id` w Five9.

## Ograniczenia

- Przewodnik Five9 dokumentuje dane routingu w `BYE` i nie wspomina o
  akceptowaniu `REFER`, więc przekazanie z powrotem jest transferem bez konsultacji wykonywanym przez skrypt.
- Five9 odczytuje `X-RouteType`, `X-RouteValue`, `X-RouteReason` i
  `X-CustomMetaData`, a nie `User-to-User`. ThunderPhone wysyła każdą wartość nagłówka
  o długości maksymalnie 256 bajtów.
- Five9 zaleca ograniczenie liczby niestandardowych nagłówków do około dziesięciu, aby uniknąć
  fragmentacji pakietów.
