---
title: "Свързване от Talkdesk"
description: "Изпращайте обаждания от Talkdesk към агент на ThunderPhone чрез „Свързване с Autopilot Voice“ и ги ескалирайте обратно с идентификатора за прехвърляне в UUI."
---

Вашият поток в Talkdesk Studio изпраща обаждащия се към агента с
идентификатора на взаимодействието и UUI. Когато обаждащият се се нуждае от човек, агентът ескалира със SIP
`REFER` към Talkdesk, а идентификаторът на прехвърлянето се записва в променлива на Studio.

## Преди да започнете

- Агент на ThunderPhone и организационен [API ключ](/bg/guides/api-keys).
- Лиценз за Talkdesk **Conversation Orchestrator**, който покрива компонента на 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 адрес на източника](/bg/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 го прочита.
Добавете този номер за прехвърляне (вижте
[Добавяне на номера за прехвърляне](/bg/guides/contact-centers/overview)
и [Заглавки в адреса за прехвърляне](/bg/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 и не допуска стойности, разделени с
  `|` или `;`, затова изпращайте една стойност. Идентификаторът на прехвърлянето се побира.
- API интерфейсите на Talkdesk не могат да прочетат транскрипцията на агента. Вместо това използвайте търсенето на прехвърляне или
  `GET /v1/calls/{call_id}`.
