---
title: "Povežite se iz Talkdesk"
description: "Klice Talkdesk usmerite do agenta ThunderPhone s funkcijo Connect to Autopilot Voice in jih z ID-jem predaje v UUI eskalirajte nazaj."
---

Vaš tok Talkdesk Studio pošlje klicatelja agentu z ID-jem interakcije in UUI. Ko klicatelj potrebuje osebo, agent eskalira s SIP `REFER` v Talkdesk, ID predaje pa se shrani v spremenljivko Studio.

## Preden začnete

- Agent ThunderPhone in organizacijski [ključ API](/sl/guides/api-keys).
- Licenca Talkdesk **Conversation Orchestrator**, ki vključuje komponento Studio
  **Poveži z Autopilot Voice** v načinu **Zunanji glasovni tok**
  ([članek Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk jo zaračunava na minuto, medtem ko agent zadrži klic.

## 1. Ustvarite končno točko SIP

Talkdesk dokumentira le seznam dovoljenih naslovov IP, zato ustvarite končno točko, ki sprejema
klice glede na izvorni naslov:

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

Članek Talkdesk navaja, da zvok pošilja prek SRTP, in `"srtp": "optional"`
odgovori s SRTP, ko ga Talkdesk ponudi. Članek ne navaja, ali Talkdesk
zahteva SRTP; če vam Talkdesk pove, da ga zahteva, nastavite `srtp` na `required`, kar
zavrne klice brez njega.

Obsege SIP-signalizacije Talkdesk pridobite pri Talkdesk. Vsak mora biti javni obseg IPv4
`/16` ali ožji (IPv6 `/48` ali ožji). Oglejte si
[platforme, ki preverjajo pristnost z izvornim IP-jem](/sl/guides/sip-addresses).
Talkdesk pošilja SIP iz omrežja Twilio, katerega naslove uporabljajo vse stranke Twilio,
zato naslov končne točke preprečuje dostop drugim klicateljem: ne
objavite ga.
Shranite `sip_uri` iz odgovora, na primer
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Pošljite klice s kontekstom

V toku Studio dodajte **Poveži z Autopilot Voice** v načinu **Zunanji glasovni
tok** in nastavite njegov cilj na `sip_uri` končne točke z dodanim `;transport=tls`, na
primer `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Končna
točka zavrne klice prek UDP, ki ga SIP Twilio uporablja, če ni določeno drugače.

Talkdesk pošlje:

- `X-Talkdesk-Interaction-Id`, shranjen kot `external_call_id` klica;
- `User-to-User`, šestnajstiško kodiran, na primer `business_hours=open`. Do
  poziva prispe dekodiran kot `{{sip_uui}}`.

Različica 2.1 komponente lahko pošlje tudi **Določene glave**. Stran z
nastavitvami Talkdesk jih opisuje kot JSON, poslan prek WebSocket, zato pri
Talkdesk potrdite, ali prispejo kot glave SIP, preden se nanje zanesete.

## 3. Prejmite klic nazaj

Agent eskalira z `REFER` na Talkdeskov naslov za eskalacijo, pri čemer je ID
predaje kot šestnajstiški UUI v tem naslovu, saj je to edino mesto, kjer ga
Talkdesk prebere. Dodajte to številko za preusmeritev (glejte
[Dodajte številko za preusmeritev](/sl/guides/contact-centers/overview)
in [Glave v naslovu za preusmeritev](/sl/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"
}
```

Naslov je naveden v Talkdeskovem članku. Različica komponente 2.1 prebere
`autopilot_result=`; različica 1.7 prebere `escalate_to=`, zato pri različici
1.7 uporabite ta ključ. `REFER` je videti tako:

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

Talkdesk vrednost shrani v spremenljivko Studio. Če želite pridobiti povzetek
in namen, dodajte korak **Izvedite dejanje** v integracijo po meri, izdelano s
Connections:

- Vrsta preverjanja pristnosti **ključ API**, ime glave `Authorization`,
  vrednost `Bearer sk_live_…`.
- Zahteva: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`,
  ki ji sledi ID iz spremenljivke. Klic lahko poiščete tudi po
  `external_call_id` z ID-jem interakcije.
- Usmerite glede na `handoff.intent` in osebi, ki prevzame klic, prikažite
  `handoff.summary`.

Glejte [Poiščite predani klic](/api-reference/calls#look-up-a-handed-off-call).

## Preizkusite

Začnite klic prek toka Studio, agenta prosite, naj vas poveže z osebo, in
preverite, da se tok nadaljuje mimo komponente z ID-jem predaje v njeni
spremenljivki. Nato odprite klic z `GET /v1/calls/{call_id}`:
`external_call_id` mora biti ID interakcije Talkdesk.

## Omejitve

- Talkdesk prebere največ 256 bajtov UUI-ja in ne dovoljuje vrednosti, ločenih z
  `|` ali `;`, zato pošljite eno vrednost. ID predaje ustreza.
- API-ji Talkdesk ne morejo prebrati prepisa agenta. Namesto tega uporabite
  iskanje predanega klica ali `GET /v1/calls/{call_id}`.
