---
title: "Pripojenie z Talkdesk"
description: "Odosielajte hovory z Talkdesk hlasovému agentovi ThunderPhone pomocou funkcie Connect to Autopilot Voice a eskalujte ich späť pomocou ID odovzdania v UUI."
---

Váš tok Talkdesk Studio odošle volajúceho agentovi s ID interakcie
a UUI. Keď volajúci potrebuje človeka, agent hovor eskaluje pomocou SIP
`REFER` do Talkdesk a ID odovzdania sa uloží do premennej Studio.

## Skôr než začnete

- Agent ThunderPhone a [kľúč API](/sk/guides/api-keys) organizácie.
- Licenciu Talkdesk **Conversation Orchestrator**, ktorá zahŕňa komponent Studio
  **Pripojiť k Autopilot Voice** v režime **Externý hlasový prúd**
  ([článok Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk ju účtuje za minútu, počas ktorej agent vedie hovor.

## 1. Vytvorte koncový bod SIP

Talkdesk dokumentuje iba zoznam povolených IP adries, preto vytvorte koncový bod,
ktorý prijíma hovory podľa zdrojovej adresy:

```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"
  }'
```

Článok Talkdesk uvádza, že zvuk odosiela cez SRTP, a `"srtp": "optional"`
odpovie cez SRTP, keď ho Talkdesk ponúkne. Článok neuvádza, či Talkdesk
vyžaduje SRTP; ak vám Talkdesk oznámi, že áno, nastavte `srtp` na `required`,
čím odmietnete hovory bez SRTP.

Rozsahy signalizačných SIP adries Talkdesk získate od Talkdesk. Každý musí byť
verejný rozsah IPv4 s maskou `/16` alebo užšou (IPv6 `/48` alebo užšou). Pozrite si
[platformy overujúce podľa zdrojovej IP adresy](/sk/guides/sip-addresses).
Talkdesk odosiela SIP zo siete Twilio, ktorej adresy zdieľa každý zákazník Twilio,
preto je adresa koncového bodu tým, čo zabraňuje prístupu iných volajúcich: nezverejňujte ju.
Uschovajte si hodnotu `sip_uri` z odpovede, napríklad
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Odosielajte hovory s kontextom

Do toku Studio pridajte **Pripojiť k Autopilot Voice** v režime **Externý hlasový
prúd** a nastavte jeho cieľ na `sip_uri` koncového bodu s pridaným `;transport=tls`, napríklad
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Koncový bod
odmieta hovory cez UDP, ktoré SIP Twilio používa, ak nie je uvedené inak.

Talkdesk odosiela:

- `X-Talkdesk-Interaction-Id`, uložené ako `external_call_id` hovoru;
- `User-to-User`, kódované hexadecimálne, napríklad `business_hours=open`. Do
  výzvy sa dostane dekódované ako `{{sip_uui}}`.

Verzia 2.1 komponentu môže odosielať aj **Definované hlavičky**. Stránka
nastavení Talkdesk ich opisuje ako JSON odosielaný cez WebSocket, preto si pred
ich použitím overte u Talkdesk, či prichádzajú ako hlavičky SIP.

## 3. Získanie hovoru späť

Agent eskaluje pomocou `REFER` na eskalačnú adresu Talkdesk, pričom ID
odovzdania je vo forme hexadecimálneho UUI v tejto adrese, čo je jediné miesto,
kde ho Talkdesk číta. Pridajte toto číslo na prenos (pozrite si
[Pridanie čísla na prenos](/sk/guides/contact-centers/overview)
a [Hlavičky v adrese na prenos](/sk/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"
}
```

Adresa je tá, ktorá je uvedená v článku Talkdesk. Komponent vo verzii 2.1
číta `autopilot_result=`; verzia 1.7 číta `escalate_to=`, preto vo verzii 1.7
použite tento kľúč. `REFER` vyzerá takto:

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

Talkdesk uloží hodnotu do premennej Studio. Ak chcete získať súhrn a zámer,
pridajte krok **Spustiť akciu** do vlastnej integrácie vytvorenej pomocou
Pripojení:

- Typ overenia **Kľúč API**, názov hlavičky `Authorization`, hodnota
  `Bearer sk_live_…`.
- Požiadavka: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  nasledovaná ID z premennej. Hovor môžete vyhľadať aj podľa
  `external_call_id` pomocou ID interakcie.
- Smerujte podľa `handoff.intent` a zobrazte `handoff.summary` osobe, ktorá
  hovor prevezme.

Pozrite si [Vyhľadanie odovzdaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte to

Spustite hovor prostredníctvom toku Studio, požiadajte agenta o spojenie s
osobou a overte, že tok pokračuje za komponentom s ID odovzdania v jeho
premennej. Potom otvorte hovor pomocou `GET /v1/calls/{call_id}`:
`external_call_id` by malo byť ID interakcie Talkdesk.

## Limity

- Talkdesk prečíta najviac 256 bajtov UUI a nepovoľuje hodnoty oddelené
  znakom `|` ani `;`, preto odošlite jednu hodnotu. ID odovzdania sa zmestí.
- Rozhrania API Talkdesk nedokážu čítať prepis agenta. Použite namiesto toho
  vyhľadanie odovzdaného hovoru alebo `GET /v1/calls/{call_id}`.
