---
title: "Yhdistä Talkdeskistä"
description: "Ohjaa Talkdesk-puhelut ThunderPhone-agentille Connect to Autopilot Voice -toiminnolla ja eskaloi ne takaisin käyttämällä UUI:ssa olevaa siirtotunnusta."
---

Talkdesk Studio -työnkulkusi lähettää soittajan agentille interaktiotunnuksen
ja UUI:n kanssa. Kun soittaja tarvitsee ihmistä, agentti eskaloi SIP
`REFER` -pyynnöllä Talkdeskiin, ja siirtotunnus tallentuu Studio-muuttujaan.

## Ennen aloittamista

- ThunderPhone-agentti ja organisaation [API-avain](/fi/guides/api-keys).
- Talkdesk **Conversation Orchestrator** -lisenssi, joka kattaa Studio-
  komponentin **Yhdistä Autopilot Voiceen** **Ulkoisen äänivirran** tilassa
  ([Talkdeskin artikkeli](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk laskuttaa siitä minuuttiperusteisesti, kun agentti pitää puhelua.

## 1. Luo SIP-päätepiste

Talkdesk dokumentoi vain IP-sallittujen osoitteiden luettelon, joten luo
päätepiste, joka hyväksyy puhelut lähdeosoitteen perusteella:

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

Talkdeskin artikkelin mukaan se lähettää äänen SRTP:n kautta, ja `"srtp": "optional"`
vastaa SRTP:llä, kun Talkdesk tarjoaa sitä. Artikkelissa ei kerrota, vaatiiko Talkdesk
SRTP:tä; jos Talkdesk kertoo, että se vaatii sitä, aseta `srtp` arvoksi `required`, mikä
hylkää puhelut ilman sitä.

Hanki Talkdeskin SIP-signalointialueet Talkdeskiltä. Jokaisen on oltava julkinen IPv4-
alue, jonka koko on `/16` tai pienempi (IPv6 `/48` tai pienempi). Katso
[Alustat, jotka todentavat lähde-IP:n perusteella](/fi/guides/sip-addresses).
Talkdesk lähettää SIP-liikenteen Twilion verkosta, jonka osoitteet ovat kaikkien Twilio-
asiakkaiden yhteisiä, joten päätepisteen osoite estää muut soittajat: älä
julkaise sitä.
Säilytä vastauksen `sip_uri`, esimerkiksi
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Lähetä puhelut kontekstin kanssa

Lisää Studio-työnkulkuusi **Yhdistä Autopilot Voiceen** **Ulkoisen äänivirran**
tilassa ja aseta sen kohteeksi päätepisteen `sip_uri`, johon on lisätty `;transport=tls`,
esimerkiksi `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Päätepiste
hylkää UDP:n kautta tulevat puhelut, jota Twilion SIP käyttää, ellei toisin määritetä.

Talkdesk lähettää:

- `X-Talkdesk-Interaction-Id`, joka tallennetaan puhelun `external_call_id`-arvoksi;
- `User-to-User`, heksakoodattuna, kuten `business_hours=open`. Se saapuu
  kehotteeseen purettuna muodossa `{{sip_uui}}`.

Komponentin versio 2.1 voi lähettää myös **Määritetyt otsakkeet**. Talkdeskin
asetussivulla ne kuvataan WebSocketin kautta lähetettäväksi JSONiksi, joten varmista
Talkdeskiltä, että ne saapuvat SIP-otsakkeina ennen kuin luotat niihin.

## 3. Palauta puhelu

Agentti eskaloi `REFER`-pyynnöllä Talkdeskin eskalointiosoitteeseen siten, että
siirtotunnus on heksamuotoisena UUI-arvona kyseisessä osoitteessa, joka on ainoa
paikka, josta Talkdesk lukee sen. Lisää tämä siirtonumero (katso
[Lisää siirtonumero](/fi/guides/contact-centers/overview)
ja [Otsakkeet siirto-osoitteen sisällä](/fi/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"
}
```

Osoite on sama kuin Talkdeskin artikkelissa. Komponentin versio 2.1
lukee `autopilot_result=`-arvon; versio 1.7 lukee `escalate_to=`-arvon, joten käytä
versiossa 1.7 tätä avainta. `REFER` näyttää tältä:

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

Talkdesk sijoittaa arvon Studio-muuttujaan. Saat yhteenvedon ja tarkoituksen
lisäämällä **Suorita toiminto** -vaiheen Connectionsilla rakennettuun
mukautettuun integraatioon:

- Todennustyyppi **API-avain**, otsakkeen nimi `Authorization`, arvo
  `Bearer sk_live_…`.
- Pyyntö: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ja sen jälkeen muuttujan tunnus. Voit myös hakea puhelun
  `external_call_id`-arvolla interaktion tunnuksen avulla.
- Reititä `handoff.intent`-kentän perusteella ja näytä `handoff.summary`
  puhelun vastaanottavalle henkilölle.

Katso [Siirretyn puhelun haku](/api-reference/calls#look-up-a-handed-off-call).

## Testaa

Aloita puhelu Studio-virran kautta, pyydä agentilta henkilöä ja tarkista,
että virta jatkuu komponentin jälkeen ja että siirtotunnus on sen
muuttujassa. Avaa sitten puhelu pyynnöllä `GET /v1/calls/{call_id}`:
`external_call_id`-arvon tulee olla Talkdeskin interaktion tunnus.

## Rajoitukset

- Talkdesk lukee enintään 256 tavua UUI-dataa eikä salli `|`- tai `;`-merkeillä
  erotettuja arvoja, joten lähetä yksi arvo. Siirtotunnus mahtuu siihen.
- Talkdeskin API:t eivät voi lukea agentin transkriptiota. Käytä sen sijaan
  siirtopuhelun hakua tai `GET /v1/calls/{call_id}`.
