---
title: "Повежите се из Talkdesk-а"
description: "Усмерите Talkdesk позиве ка ThunderPhone агенту помоћу опције Connect to Autopilot Voice и вратите их уз ескалацију помоћу идентификатора за пренос у UUI-ју."
---

Ваш ток у Talkdesk Studio-у шаље позиваоца гласовном агенту са ИД-ом интеракције
и UUI-јем. Када је позиваоцу потребна особа, агент ескалира позив помоћу SIP
`REFER` захтева ка Talkdesk-у, а ИД предаје се смешта у Studio променљиву.

## Пре него што почнете

- ThunderPhone агент и [API кључ](/sr/guides/api-keys) организације.
- Лиценца за Talkdesk **Оркестратор разговора**, која покрива Studio
  компоненту **Повежите са Autopilot Voice** у режиму **Спољни гласовни ток**
  ([чланак компаније Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk је наплаћује по минуту док агент задржава позив.

## 1. Креирајте SIP крајњу тачку

Talkdesk документација наводи само листу дозвољених IP адреса, па креирајте
крајњу тачку која прихвата позиве према изворној адреси:

```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 наводи да шаље звук преко SRTP-а, а `"srtp": "optional"`
прихвата SRTP када га Talkdesk понуди. У чланку се не наводи да ли Talkdesk
захтева SRTP; ако Вам Talkdesk каже да га захтева, поставите `srtp` на `required`,
што одбија позиве без њега.

Опсеге SIP сигнализације за Talkdesk добијте од компаније Talkdesk. Сваки мора
бити јавни IPv4 опсег `/16` или ужи (IPv6 `/48` или ужи). Погледајте
[Платформе које потврђују идентитет према изворној IP адреси](/sr/guides/sip-addresses).
Talkdesk шаље SIP са мреже компаније Twilio, чије адресе деле сви Twilio
корисници, па адреса крајње тачке спречава приступ других позивалаца: немојте
је објављивати.
Сачувајте `sip_uri` из одговора, на пример
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Шаљите позиве са контекстом

У Studio току додајте **Повежите са Autopilot Voice** у режиму **Спољни гласовни
ток** и поставите његов циљ на `sip_uri` крајње тачке са додатим `;transport=tls`, на
пример `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Крајња
тачка одбија позиве преко UDP-а, који SIP услуга компаније Twilio користи ако
није другачије наведено.

Talkdesk шаље:

- `X-Talkdesk-Interaction-Id`, који се чува као `external_call_id` позива;
- `User-to-User`, хексадецимално кодиран, као што је `business_hours=open`. До
  упита стиже декодиран, као `{{sip_uui}}`.

Верзија 2.1 компоненте такође може да шаље **Дефинисана заглавља**. Страница
подешавања компаније Talkdesk описује их као JSON послат преко WebSocket-а, па
потврдите са Talkdesk-ом да ли стижу као SIP заглавља пре него што се ослоните
на њих.

## 3. Преузмите позив назад

Гласовни агент ескалира позив помоћу `REFER` на Talkdesk адресу за ескалацију, са
идентификатором предаје као хексадецималним UUI-јем унутар те адресе, јединог места
на коме га Talkdesk чита. Додајте овај број за пренос (погледајте
[Додавање броја за пренос](/sr/guides/contact-centers/overview)
и [Заглавља унутар адресе за пренос](/sr/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"
}
```

Адреса је она из Talkdesk чланка. Верзија 2.1 компоненте
чита `autopilot_result=`; верзија 1.7 чита `escalate_to=`, па користите тај кључ у
верзији 1.7. `REFER` изгледа овако:

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

Talkdesk смешта вредност у Studio променљиву. Да бисте добили резиме и намеру,
додајте корак **Изврши радњу** у прилагођену интеграцију направљену помоћу
Веза:

- Тип аутентификације **API кључ**, назив заглавља `Authorization`, вредност
  `Bearer sk_live_…`.
- Захтев: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  праћен идентификатором из променљиве. Позив можете да пронађете и по
  `external_call_id` помоћу идентификатора интеракције.
- Усмерите ток на основу `handoff.intent` и прикажите `handoff.summary` особи која
  преузима позив.

Погледајте [Проналажење предатог позива](/api-reference/calls#look-up-a-handed-off-call).

## Тестирајте

Покрените позив кроз Studio ток, затражите од агента да Вас повеже са особом и проверите
да ли се ток наставља после компоненте са идентификатором предаје у својој
променљивој. Затим отворите позив помоћу `GET /v1/calls/{call_id}`:
`external_call_id` треба да буде Talkdesk идентификатор интеракције.

## Ограничења

- Talkdesk чита највише 256 бајтова UUI-ја и не дозвољава вредности раздвојене са
  `|` или `;`, па пошаљите једну вредност. Идентификатор предаје одговара.
- Talkdesk API-ји не могу да прочитају транскрипт гласовног агента. Уместо тога,
  користите претрагу предатог позива или `GET /v1/calls/{call_id}`.
