---
title: "Savienošana no Talkdesk"
description: "Nosūtiet Talkdesk zvanus ThunderPhone balss aģentam, izmantojot Connect to Autopilot Voice, un eskalējiet tos atpakaļ, izmantojot UUI norādīto pārsūtīšanas ID."
---

Jūsu Talkdesk Studio plūsma nosūta zvanītāju balss aģentam ar mijiedarbības
ID un UUI. Kad zvanītājam nepieciešams cilvēks, balss aģents pāradresē zvanu
uz Talkdesk ar SIP `REFER`, un nodošanas ID nonāk Studio mainīgajā.

## Pirms sākat

- ThunderPhone balss aģents un organizācijas [API atslēga](/lv/guides/api-keys).
- Talkdesk **Conversation Orchestrator** licence, kas ietver Studio komponentu
  **Savienot ar Autopilot Voice** režīmā **Ārējā balss straume**
  ([Talkdesk raksts](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk par to norēķina par minūti, kamēr balss aģents uztur zvanu.

## 1. Izveidojiet SIP galapunktu

Talkdesk dokumentācijā ir norādīts tikai IP atļauju saraksts, tāpēc izveidojiet
galapunktu, kas pieņem zvanus pēc avota adreses:

```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 rakstā teikts, ka tas sūta audio pa SRTP, un `"srtp": "optional"`
atbild ar SRTP, kad Talkdesk to piedāvā. Rakstā nav norādīts, vai Talkdesk
pieprasa SRTP; ja Talkdesk jums norāda, ka tas ir nepieciešams, iestatiet
`srtp` uz `required`, kas noraida zvanus bez tā.

Saņemiet Talkdesk SIP signalizācijas diapazonus no Talkdesk. Katram jābūt
publiskam IPv4 diapazonam ar `/16` vai šaurāku masku (IPv6 — ar `/48` vai
šaurāku masku). Skatiet
[Platformas, kas autentificē pēc avota IP](/lv/guides/sip-addresses).
Talkdesk sūta SIP no Twilio tīkla, kura adreses koplieto visi Twilio klienti,
tāpēc galapunkta adrese ir tas, kas neļauj piekļūt citiem zvanītājiem:
nepublicējiet to.
Saglabājiet atbildes `sip_uri`, piemēram,
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Sūtiet zvanus ar kontekstu

Savā Studio plūsmā pievienojiet **Savienot ar Autopilot Voice** režīmā
**Ārējā balss straume** un iestatiet tā mērķi uz galapunkta `sip_uri`, kam pievienots `;transport=tls`, piemēram,
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Galapunkts
noraida zvanus pa UDP, ko Twilio SIP izmanto, ja nav norādīts citādi.

Talkdesk sūta:

- `X-Talkdesk-Interaction-Id`, kas tiek saglabāts kā zvana `external_call_id`;
- `User-to-User`, heksadecimāli kodētu, piemēram, `business_hours=open`. Tas
  uzvednē nonāk atkodēts kā `{{sip_uui}}`.

Komponenta versija 2.1 var sūtīt arī **Definētās galvenes**. Talkdesk
iestatījumu lapā tās ir aprakstītas kā JSON, kas tiek sūtīts pa WebSocket, tāpēc
pirms paļaujaties uz tām, apstipriniet ar Talkdesk, vai tās tiek saņemtas kā
SIP galvenes.

## 3. Saņemiet zvanu atpakaļ

Aģents eskalē ar `REFER` uz Talkdesk eskalācijas adresi, kurā nodošanas ID ir kā heksadecimāls UUI — tā ir vienīgā vieta, kur Talkdesk to nolasa.
Pievienojiet šo pārsūtīšanas numuru (skatiet
[Pievienojiet pārsūtīšanas numuru](/lv/guides/contact-centers/overview)
un [Galvenes pārsūtīšanas adresē](/lv/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"
}
```

Izmantojiet Talkdesk rakstā norādīto adresi. Komponenta versija 2.1
nolasa `autopilot_result=`; versija 1.7 nolasa `escalate_to=`, tāpēc versijā
1.7 izmantojiet šo atslēgu. `REFER` izskatās šādi:

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

Talkdesk ievieto vērtību Studio mainīgajā. Lai iegūtu kopsavilkumu un nolūku,
pievienojiet darbību **Izpildīt darbību** pielāgotā integrācijā, kas izveidota ar
Savienojumiem:

- Autentifikācijas veids — **API atslēga**, galvenes nosaukums `Authorization`, vērtība
  `Bearer sk_live_…`.
- Pieprasījums: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  un pēc tam ID no mainīgā. Zvanu varat arī uzmeklēt pēc
  `external_call_id`, izmantojot mijiedarbības ID.
- Veidojiet maršrutēšanu pēc `handoff.intent` un rādiet `handoff.summary` personai, kura pārņem
  zvanu.

Skatiet [Uzmeklējiet nodotu zvanu](/api-reference/calls#look-up-a-handed-off-call).

## Pārbaudiet

Sāciet zvanu, izmantojot Studio plūsmu, palūdziet aģentam savienot ar personu un pārbaudiet,
vai plūsma turpinās aiz komponenta, kura mainīgajā ir nodošanas ID. Pēc tam atveriet zvanu ar `GET /v1/calls/{call_id}`:
`external_call_id` jābūt Talkdesk mijiedarbības ID.

## Ierobežojumi

- Talkdesk nolasa ne vairāk kā 256 UUI baitus un neatļauj vērtības, kas atdalītas ar
  `|` vai `;`, tāpēc sūtiet vienu vērtību. Nodošanas ID tajā ietilpst.
- Talkdesk API nevar nolasīt aģenta transkripciju. Tā vietā izmantojiet nodošanas uzmeklēšanu vai
  `GET /v1/calls/{call_id}`.
