---
title: "Połącz z Talkdesk"
description: "Przekierowuj połączenia z Talkdesk do agenta ThunderPhone za pomocą Connect to Autopilot Voice i eskaluj je z powrotem, używając identyfikatora przekazania w UUI."
---

Przepływ Talkdesk Studio wysyła rozmówcę do agenta wraz z identyfikatorem
interakcji i UUI. Gdy rozmówca potrzebuje człowieka, agent eskaluje połączenie
za pomocą SIP `REFER` do Talkdesk, a identyfikator przekazania trafia do zmiennej Studio.

## Przed rozpoczęciem

- Agent ThunderPhone i organizacyjny [klucz API](/pl/guides/api-keys).
- Licencja Talkdesk **Conversation Orchestrator**, która obejmuje komponent Studio
  **Connect to Autopilot Voice** w trybie **External Voice Stream**
  ([artykuł Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk nalicza opłatę za minutę, gdy agent obsługuje połączenie.

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

Talkdesk dokumentuje wyłącznie listę dozwolonych adresów IP, dlatego utwórz punkt końcowy, który akceptuje
połączenia według adresu źródłowego:

```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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'
```

Artykuł Talkdesk podaje, że wysyła ono dźwięk przez SRTP, a `"srtp": "optional"`
odpowiada przez SRTP, gdy Talkdesk je oferuje. Artykuł nie określa, czy Talkdesk
wymaga SRTP; jeśli Talkdesk poinformuje Cię, że tak jest, ustaw `srtp` na `required`, co
odrzuca połączenia bez niego.

Uzyskaj zakresy sygnalizacji SIP Talkdesk od Talkdesk. Każdy z nich musi być publicznym zakresem IPv4
o masce `/16` lub węższej (IPv6 `/48` lub węższej). Zobacz
[Platformy uwierzytelniające według źródłowego adresu IP](/pl/guides/sip-addresses).
Talkdesk wysyła SIP z sieci Twilio, której adresy są współdzielone przez każdego klienta Twilio,
dlatego adres punktu końcowego uniemożliwia dostęp innym rozmówcom: nie
publikuj go.
Zachowaj `sip_uri` z odpowiedzi, na przykład
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

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

W przepływie Studio dodaj **Connect to Autopilot Voice** w trybie **External Voice
Stream** i ustaw jego cel na `sip_uri` punktu końcowego z dodanym `;transport=tls`, na
przykład `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Punkt
końcowy odrzuca połączenia przez UDP, którego SIP Twilio używa, jeśli nie zostanie wskazane inaczej.

Talkdesk wysyła:

- `X-Talkdesk-Interaction-Id`, przechowywany jako `external_call_id` połączenia;
- `User-to-User`, zakodowany szesnastkowo, na przykład `business_hours=open`. Dociera do
  promptu po zdekodowaniu jako `{{sip_uui}}`.

Wersja 2.1 komponentu może również wysyłać **Defined headers**. Strona preferencji Talkdesk
opisuje je jako JSON wysyłany przez WebSocket, dlatego potwierdź w Talkdesk,
czy docierają jako nagłówki SIP, zanim na nich polegasz.

## 3. Odbierz połączenie

Agent przekazuje połączenie za pomocą `REFER` na adres eskalacji Talkdesk, z
identyfikatorem przekazania jako szesnastkowym UUI w tym adresie — jedynym miejscu,
z którego Talkdesk go odczytuje. Dodaj ten numer przekierowania (zobacz
[Dodawanie numeru przekierowania](/pl/guides/contact-centers/overview)
oraz [Nagłówki w adresie przekierowania](/pl/guides/call-transfers)):

```json
{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

Adres jest zgodny z artykułem Talkdesk. Wersja 2.1 komponentu
odczytuje `autopilot_result=`; wersja 1.7 odczytuje `escalate_to=`, więc w
wersji 1.7 użyj tego klucza. `REFER` wygląda tak:

```
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
```

Talkdesk umieszcza wartość w zmiennej Studio. Aby uzyskać podsumowanie i intencję,
dodaj krok **Wykonaj działanie** w niestandardowej integracji utworzonej za pomocą
Connections:

- Typ uwierzytelniania: **Klucz API**, nazwa nagłówka `Authorization`, wartość
  `Bearer sk_live_…`.
- Żądanie: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`,
  po którym podaj identyfikator ze zmiennej. Możesz też wyszukać połączenie po
  `external_call_id`, używając identyfikatora interakcji.
- Skieruj przepływ na podstawie `handoff.intent` i pokaż `handoff.summary`
  osobie odbierającej połączenie.

Zobacz [Wyszukiwanie przekazanego połączenia](/api-reference/calls#look-up-a-handed-off-call).

## Testowanie

Rozpocznij połączenie w przepływie Studio, poproś agenta o połączenie z osobą i sprawdź,
czy przepływ kontynuuje działanie po komponencie, a identyfikator przekazania znajduje się
w jego zmiennej. Następnie otwórz połączenie za pomocą `GET /v1/calls/{call_id}`:
`external_call_id` powinien być identyfikatorem interakcji Talkdesk.

## Ograniczenia

- Talkdesk odczytuje maksymalnie 256 bajtów UUI i nie zezwala na wartości rozdzielane
  przez `|` ani `;`, dlatego wysyłaj jedną wartość. Identyfikator przekazania się mieści.
- Interfejsy API Talkdesk nie mogą odczytać transkrypcji agenta. Zamiast tego użyj wyszukiwania
  przekazania lub `GET /v1/calls/{call_id}`.
