---
title: "Ühenda Talkdeskist"
description: "Suuna Talkdeski kõned funktsiooniga Connect to Autopilot Voice ThunderPhone'i häälagendile ja eskaleeri need tagasi, kasutades UUI-s üleandmise ID-d."
---

Sinu Talkdesk Studio voog suunab helistaja häälagendi juurde koos interaktsiooni ID ja UUI-ga. Kui helistaja vajab inimest, eskaleerib häälagent SIP-i `REFER`-iga Talkdeski ning üleandmise ID jõuab Studio muutujasse.

## Enne alustamist

- ThunderPhone'i häälagent ja organisatsiooni [API-võti](/et/guides/api-keys).
- Talkdeski **Vestluse orkestreerija** litsents, mis hõlmab Studio komponenti **Ühenda Autopilot Voice'iga** režiimis **Väline häälvoog** ([Talkdeski artikkel](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk esitab selle eest arve minuti kaupa, kuni häälagent kõnet hoiab.

## 1. Loo SIP-lõpp-punkt

Talkdesk dokumenteerib ainult IP-lubatud loendi, seega loo lõpp-punkt, mis võtab kõnesid vastu lähteaadressi alusel:

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

Talkdeski artiklis on kirjas, et see saadab heli SRTP kaudu, ning `"srtp": "optional"`
vastab SRTP-ga, kui Talkdesk seda pakub. Artikkel ei ütle, kas Talkdesk
nõuab SRTP-d; kui Talkdesk ütleb, et nõuab, määra `srtp` väärtuseks `required`, mis
keeldub ilma selleta kõnedest.

Hangi Talkdeski SIP-signalisatsiooni vahemikud Talkdeskilt. Igaüks peab olema avalik IPv4
vahemik `/16` või kitsam (IPv6 `/48` või kitsam). Vaata
[Platvormid, mis autentivad lähte-IP alusel](/et/guides/sip-addresses).
Talkdesk saadab SIP-i Twilio võrgust, mille aadresse jagab iga Twilio klient,
seega hoiab teised helistajad eemal lõpp-punkti aadress: ära seda
avalda.
Säilita vastuse `sip_uri`, näiteks
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Saada kõned koos kontekstiga

Lisa oma Studio voogu **Ühenda Autopilot Voice'iga** režiimis **Väline häälvoog**
ja määra selle sihtmärgiks lõpp-punkti `sip_uri`, millele on lisatud `;transport=tls`, näiteks
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Lõpp-punkt
keeldub UDP kaudu tulevatest kõnedest, mida Twilio SIP kasutab, kui ei ole teisiti määratud.

Talkdesk saadab:

- `X-Talkdesk-Interaction-Id`, mis salvestatakse kõne `external_call_id`-na;
- `User-to-User`, kuueteistkümnendsüsteemis kodeerituna, näiteks `business_hours=open`. See jõuab
  viipesse dekodeeritult kui `{{sip_uui}}`.

Komponendi versioon 2.1 saab saata ka **Määratletud päiseid**. Talkdeski
eelistuste leht kirjeldab neid JSON-ina, mis saadetakse WebSocketi kaudu, seega kinnita
Talkdeskiga, kas need jõuavad SIP-päistena enne, kui neile tuginema hakkad.

## 3. Too kõne tagasi

Agent eskaleerib `REFER`-iga Talkdeski eskaleerimisaadressile, kus üleandmise ID on
selles aadressis kuueteistkümnendsüsteemi UUI-na — see on ainus koht, kust Talkdesk seda loeb.
Lisa see edastusnumber (vaata
[Edastusnumbri lisamine](/et/guides/contact-centers/overview)
ja [Päised edastusaadressis](/et/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"
}
```

Aadress on sama, mis Talkdeski artiklis. Komponendi versioon 2.1
loeb `autopilot_result=`; versioon 1.7 loeb `escalate_to=`, seega kasuta
versioonis 1.7 seda võtit. `REFER` näeb välja järgmine:

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

Talkdesk salvestab väärtuse Studio muutujasse. Kokkuvõtte ja kavatsuse
saamiseks lisa Connectionsiga loodud kohandatud integratsiooni juurde samm
**Käivita toiming**:

- Autentimise tüüp **API-võti**, päise nimi `Authorization`, väärtus
  `Bearer sk_live_…`.
- Päring: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`,
  millele järgneb muutuja ID. Kõne saad otsida ka `external_call_id` järgi,
  kasutades interaktsiooni ID-d.
- Suuna vastavalt väärtusele `handoff.intent` ja kuva `handoff.summary` kõne
  vastu võtvale inimesele.

Vaata [Üle antud kõne otsimine](/api-reference/calls#look-up-a-handed-off-call).

## Testi seda

Alusta kõnet Studio voo kaudu, palu agendilt inimest ja kontrolli, et voog
jätkub komponendist edasi ning selle muutujas on üleandmise ID. Seejärel ava kõne
päringuga `GET /v1/calls/{call_id}`: `external_call_id` peab olema Talkdeski
interaktsiooni ID.

## Piirangud

- Talkdesk loeb kuni 256 baiti UUI-d ega luba väärtusi, mis on eraldatud
  märkidega `|` või `;`, seega saada üks väärtus. Üleandmise ID mahub ära.
- Talkdeski API-d ei saa lugeda agendi transkriptsiooni. Kasuta selle asemel
  üle antud kõne otsingut või `GET /v1/calls/{call_id}`.