---
title: "Připojení z Talkdesk"
description: "Směrujte hovory z Talkdesk na agenta ThunderPhone pomocí funkce Connect to Autopilot Voice a eskalujte je zpět pomocí ID předání v UUI."
---

Váš tok Talkdesk Studio odesílá volajícího agentovi s ID interakce
a UUI. Když volající potřebuje člověka, agent hovor eskaluje pomocí SIP
`REFER` do Talkdesku a ID předání se uloží do proměnné Studio.

## Než začnete

- Agent ThunderPhone a organizační [klíč API](/cs/guides/api-keys).
- Licence Talkdesk **Conversation Orchestrator**, která zahrnuje komponentu
  Studio **Připojit k hlasovému Autopilotu** v režimu **Externí hlasový stream**
  ([článek Talkdesku](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk ji účtuje za minutu, dokud agent hovor obsluhuje.

## 1. Vytvořte koncový bod SIP

Talkdesk dokumentuje pouze seznam povolených IP adres, proto vytvořte koncový
bod, který přijímá hovory podle zdrojové 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ánek Talkdesku uvádí, že odesílá zvuk přes SRTP, a `"srtp": "optional"`
odpoví pomocí SRTP, když ho Talkdesk nabídne. Článek neuvádí, zda Talkdesk
SRTP vyžaduje; pokud vám Talkdesk sdělí, že ano, nastavte `srtp` na `required`,
čímž odmítnete hovory bez SRTP.

Rozsahy signalizačních IP adres SIP Talkdesku získáte od Talkdesku. Každý musí
být veřejný rozsah IPv4 o velikosti `/16` nebo menší (IPv6 `/48` nebo menší).
Viz [Platformy ověřované podle zdrojové IP adresy](/cs/guides/sip-addresses).
Talkdesk odesílá SIP ze sítě Twilio, jejíž adresy sdílejí všichni zákazníci
Twilio, takže právě adresa koncového bodu brání přístupu ostatních volajících:
nezveřejňujte ji.
Uložte si `sip_uri` z odpovědi, například
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Odesílejte hovory s kontextem

Ve svém toku Studio přidejte **Připojit k hlasovému Autopilotu** v režimu
**Externí hlasový stream** a jako cíl nastavte `sip_uri` koncového bodu s přidaným `;transport=tls`,
například `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Koncový
bod odmítá hovory přes UDP, které SIP Twilio používá, pokud není určeno jinak.

Talkdesk odesílá:

- `X-Talkdesk-Interaction-Id`, uložené jako `external_call_id` hovoru;
- `User-to-User`, kódované hexadecimálně, například `business_hours=open`. Do
  promptu dorazí dekódované jako `{{sip_uui}}`.

Verze 2.1 komponenty může také odesílat **Definované hlavičky**. Stránka
předvoleb Talkdesku je popisuje jako JSON odesílaný přes WebSocket, proto si
u Talkdesku ověřte, zda dorazí jako hlavičky SIP, než se na ně spolehnete.

## 3. Získejte hovor zpět

Agent eskaluje pomocí `REFER` na eskalační adresu Talkdesk, přičemž ID předání
je jako hexadecimální UUI uvnitř této adresy, což je jediné místo, odkud ho
Talkdesk načítá. Přidejte toto číslo pro přenos (viz
[Přidání čísla pro přenos](/cs/guides/contact-centers/overview)
a [Hlavičky uvnitř adresy pro přenos](/cs/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 uvedena v článku Talkdesk. Verze komponenty 2.1 načítá
`autopilot_result=`; verze 1.7 načítá `escalate_to=`, proto u verze 1.7 použijte
tento klíč. `REFER` vypadá takto:

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

Talkdesk uloží hodnotu do proměnné Studio. Chcete-li získat shrnutí a záměr,
přidejte krok **Spustit akci** do vlastní integrace vytvořené pomocí
Připojení:

- Typ ověřování **Klíč API**, název hlavičky `Authorization`, hodnota
  `Bearer sk_live_…`.
- Požadavek: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  následovaný ID z proměnné. Hovor můžete také vyhledat podle
  `external_call_id` pomocí ID interakce.
- Směrujte podle `handoff.intent` a zobrazte `handoff.summary` osobě, která
  hovor převezme.

Viz [Vyhledání předaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte jej

Spusťte hovor prostřednictvím toku Studio, požádejte agenta o spojení s
člověkem a ověřte, že tok pokračuje za komponentou s ID předání ve své
proměnné. Poté otevřete hovor pomocí `GET /v1/calls/{call_id}`:
`external_call_id` by mělo být ID interakce Talkdesk.

## Omezení

- Talkdesk načítá maximálně 256 bajtů UUI a nepovoluje hodnoty oddělené znaky
  `|` ani `;`, proto odešlete jednu hodnotu. ID předání se vejde.
- Rozhraní API Talkdesk nemohou načíst přepis agenta. Místo toho použijte
  vyhledání předaného hovoru nebo `GET /v1/calls/{call_id}`.
