---
title: "Prisijungimas iš Talkdesk"
description: "Nukreipkite Talkdesk skambučius į ThunderPhone agentą naudodami Connect to Autopilot Voice ir peradresuokite juos atgal naudodami perėmimo ID UUI."
---

Jūsų Talkdesk Studio srautas siunčia skambintoją agentui kartu su sąveikos
identifikatoriumi ir UUI. Kai skambintojui reikia žmogaus, agentas perduoda
skambutį Talkdesk naudodamas SIP `REFER`, o perdavimo identifikatorius patenka į
Studio kintamąjį.

## Prieš pradedant

- ThunderPhone agentas ir organizacijos [API raktas](/lt/guides/api-keys).
- Talkdesk **Pokalbių orkestratoriaus** licencija, apimanti Studio komponentą
  **Prisijungti prie Autopilot Voice** režimu **Išorinis balso srautas**
  ([Talkdesk straipsnis](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk už jį skaičiuoja mokestį už minutę, kol agentas palaiko skambutį.

## 1. Sukurkite SIP galinį tašką

Talkdesk nurodo tik IP leidžiamųjų adresų sąrašą, todėl sukurkite galinį tašką,
kuris priima skambučius pagal šaltinio adresą:

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

Talkdesk straipsnyje nurodyta, kad garsas siunčiamas per SRTP, o `"srtp": "optional"`
atsako naudodamas SRTP, kai Talkdesk jį siūlo. Straipsnyje nenurodyta, ar Talkdesk
reikalauja SRTP; jei Talkdesk nurodo, kad reikalauja, nustatykite `srtp` į `required`,
kad būtų atmetami skambučiai be jo.

Gaukite Talkdesk SIP signalizavimo diapazonus iš Talkdesk. Kiekvienas turi būti
viešasis IPv4 diapazonas `/16` arba siauresnis (IPv6 `/48` arba siauresnis). Žr.
[Platformos, kurios autentifikuoja pagal šaltinio IP](/lt/guides/sip-addresses).
Talkdesk siunčia SIP iš Twilio tinklo, kurio adresais dalijasi visi Twilio klientai,
todėl būtent galinio taško adresas neleidžia prisijungti kitiems skambintojams:
neskelbkite jo.
Išsaugokite atsakyme pateiktą `sip_uri`, pavyzdžiui,
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Siųskite skambučius su kontekstu

Studio sraute pridėkite **Prisijungti prie Autopilot Voice** režimu **Išorinis balso
srautas** ir nustatykite jo tikslą į galinio taško `sip_uri`, pridėję `;transport=tls`,
pavyzdžiui, `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Galinis
taškas atmeta skambučius per UDP, kurį Twilio SIP naudoja, jei nenurodyta kitaip.

Talkdesk siunčia:

- `X-Talkdesk-Interaction-Id`, saugomą kaip skambučio `external_call_id`;
- `User-to-User`, užkoduotą šešioliktainiu formatu, pvz., `business_hours=open`.
  Jis patenka į raginimą iškoduotas kaip `{{sip_uui}}`.

Komponento 2.1 versija taip pat gali siųsti **Apibrėžtas antraštes**. Talkdesk
nuostatų puslapyje jos aprašomos kaip JSON, siunčiamas per WebSocket, todėl prieš
jomis pasikliaudami patvirtinkite su Talkdesk, ar jos pateikiamos kaip SIP antraštės.

## 3. Priimkite perduotą skambutį

Agentas eskaluoja skambutį naudodamas `REFER` į Talkdesk eskalavimo adresą, o
perdavimo ID kaip šešioliktainis UUI yra šiame adrese – vienintelėje vietoje,
kur Talkdesk jį nuskaito. Pridėkite šį perdavimo numerį (žr.
[Pridėkite perdavimo numerį](/lt/guides/contact-centers/overview)
ir [Antraštės perdavimo adrese](/lt/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"
}
```

Adresas yra nurodytas Talkdesk straipsnyje. Komponento 2.1 versija
nuskaito `autopilot_result=`; 1.7 versija nuskaito `escalate_to=`, todėl 1.7
versijoje naudokite šį raktą. `REFER` atrodo taip:

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

Talkdesk įrašo reikšmę į Studio kintamąjį. Norėdami gauti suvestinę ir
ketinimą, pridėkite veiksmą **Vykdyti veiksmą** pasirinktinėje integracijoje,
sukurtoje naudojant Connections:

- Autentifikavimo tipas **API raktas**, antraštės pavadinimas `Authorization`,
  reikšmė `Bearer sk_live_…`.
- Užklausa: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ir po jos nurodykite ID iš kintamojo. Skambutį taip pat galite rasti pagal
  `external_call_id`, naudodami sąveikos ID.
- Nukreipkite pagal `handoff.intent` ir parodykite `handoff.summary` skambutį
  perimančiam asmeniui.

Žr. [Perduoto skambučio paieška](/api-reference/calls#look-up-a-handed-off-call).

## Išbandykite

Pradėkite skambutį per Studio srautą, paprašykite agento sujungti su žmogumi ir
patikrinkite, ar srautas tęsiasi už komponento ribų, o jo kintamajame yra
perdavimo ID. Tada atidarykite skambutį naudodami `GET /v1/calls/{call_id}`:
`external_call_id` turėtų būti Talkdesk sąveikos ID.

## Ribojimai

- Talkdesk nuskaito ne daugiau kaip 256 UUI baitus ir neleidžia reikšmių,
  atskirtų `|` arba `;`, todėl siųskite vieną reikšmę. Perdavimo ID telpa.
- Talkdesk API negali nuskaityti agento pokalbio transkripcijos. Vietoje to
  naudokite perduoto skambučio paiešką arba `GET /v1/calls/{call_id}`.
