---
title: "Povezivanje iz Talkdeska"
description: "Usmjerite Talkdesk pozive glasovnom agentu ThunderPhonea putem opcije Poveži s Autopilot Voiceom, a zatim ih eskalirajte natrag s ID-om prijenosa u UUI-ju."
---

Vaš Talkdesk Studio tijek šalje pozivatelja glasovnom agentu s ID-jem
interakcije i UUI-jem. Kada pozivatelj treba osobu, glasovni agent eskalira s SIP
`REFER` porukom prema Talkdesku, a ID predaje završava u varijabli Studija.

## Prije početka

- Glasovni agent ThunderPhone i organizacijski [API ključ](/hr/guides/api-keys).
- Licenca Talkdesk **Orkestrator razgovora**, koja obuhvaća komponentu Studija
  **Povezivanje s Autopilot Voiceom** u načinu rada **Vanjski glasovni tok**
  ([članak Talkdeska](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk je naplaćuje po minuti dok glasovni agent drži poziv.

## 1. Izradite SIP krajnju točku

Talkdesk dokumentira samo popis dopuštenih IP adresa, stoga izradite krajnju točku koja prihvaća
pozive prema izvornoj adresi:

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

U članku Talkdeska navodi se da zvuk šalje putem SRTP-a, a `"srtp": "optional"`
odgovara SRTP-om kada ga Talkdesk ponudi. U članku se ne navodi zahtijeva li Talkdesk
SRTP; ako Vam Talkdesk kaže da ga zahtijeva, postavite `srtp` na `required`, što
odbija pozive bez njega.

Dohvatite SIP signalizacijske raspone Talkdeska od Talkdeska. Svaki mora biti javni raspon
IPv4 adresa od `/16` ili uži (IPv6 `/48` ili uži). Pogledajte
[Platforme koje se autentificiraju prema izvornoj IP adresi](/hr/guides/sip-addresses).
Talkdesk šalje SIP iz Twilio mreže, čije adrese dijele svi korisnici Twilija,
stoga je adresa krajnje točke ono što sprječava druge pozivatelje: nemojte je
objaviti.
Sačuvajte `sip_uri` iz odgovora, na primjer
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Šaljite pozive s kontekstom

U svom Studio tijeku dodajte **Povezivanje s Autopilot Voiceom** u načinu rada **Vanjski glasovni
tok** i postavite njegovo odredište na `sip_uri` krajnje točke s dodanim `;transport=tls`, na
primjer `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Krajnja
točka odbija pozive putem UDP-a, koji Twiliojev SIP koristi ako nije drukčije navedeno.

Talkdesk šalje:

- `X-Talkdesk-Interaction-Id`, pohranjen kao `external_call_id` poziva;
- `User-to-User`, heksadekodiran, kao što je `business_hours=open`. Do
  prompta stiže dekodiran, kao `{{sip_uui}}`.

Verzija 2.1 komponente može slati i **Definirana zaglavlja**. Stranica s
postavkama Talkdeska opisuje ih kao JSON poslan putem WebSocketa, stoga potvrdite s
Talkdeskom stižu li kao SIP zaglavlja prije nego što se na njih oslonite.

## 3. Preuzmite poziv natrag

Agent prosljeđuje eskalaciju pomoću `REFER` zahtjeva na Talkdeskovu adresu za
eskalaciju, s ID-jem preusmjeravanja kao heksadekadskim UUI-jem unutar te
adrese, jedinog mjesta na kojem ga Talkdesk čita. Dodajte ovaj broj za prijenos
(pogledajte
[Dodajte broj za prijenos](/hr/guides/contact-centers/overview)
i [Zaglavlja unutar adrese za prijenos](/hr/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 ona iz Talkdeskova članka. Verzija 2.1 komponente
čita `autopilot_result=`; verzija 1.7 čita `escalate_to=`, stoga na verziji 1.7
upotrijebite taj ključ. `REFER` izgleda ovako:

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

Talkdesk stavlja vrijednost u varijablu Studio. Da biste dohvatili sažetak i namjeru,
dodajte korak **Izvrši radnju** u prilagođenu integraciju izrađenu pomoću
Connections:

- Vrsta autentikacije **API ključ**, naziv zaglavlja `Authorization`, vrijednost
  `Bearer sk_live_…`.
- Zahtjev: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  nakon kojeg slijedi ID iz varijable. Poziv možete potražiti i prema
  `external_call_id` pomoću ID-ja interakcije.
- Usmjerite tijek prema `handoff.intent` i prikažite `handoff.summary` osobi
  koja preuzima poziv.

Pogledajte [Potražite preusmjereni poziv](/api-reference/calls#look-up-a-handed-off-call).

## Testirajte

Pokrenite poziv putem tijeka Studio, zatražite od agenta razgovor s osobom i provjerite
nastavlja li se tijek nakon komponente s ID-jem preusmjeravanja u svojoj
varijabli. Zatim otvorite poziv pomoću `GET /v1/calls/{call_id}`:
`external_call_id` trebao bi biti ID Talkdesk interakcije.

## Ograničenja

- Talkdesk čita najviše 256 bajtova UUI-ja i ne dopušta vrijednosti odvojene
  znakovima `|` ili `;`, stoga pošaljite jednu vrijednost. ID preusmjeravanja stane.
- Talkdeskovi API-ji ne mogu pročitati transkript agenta. Umjesto toga upotrijebite
  pretraživanje preusmjerenog poziva ili `GET /v1/calls/{call_id}`.
