---
title: "Conectați din Talkdesk"
description: "Trimiteți apelurile Talkdesk către un agent vocal ThunderPhone cu Connect to Autopilot Voice și escaladați-le înapoi folosind ID-ul de transfer în UUI."
---

Fluxul dvs. Talkdesk Studio trimite apelantul către agent cu ID-ul
interacțiunii și UUI. Când apelantul are nevoie de o persoană, agentul escaladează cu un SIP
`REFER` către Talkdesk, iar ID-ul transferului ajunge într-o variabilă Studio.

## Înainte de a începe

- Un agent ThunderPhone și o [cheie API](/ro/guides/api-keys) a organizației.
- O licență Talkdesk **Orchestrator de conversații**, care acoperă componenta Studio
  **Conectare la vocea Autopilot** în modul **Flux vocal extern**
  ([articolul Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk facturează pe minut cât timp agentul menține apelul.

## 1. Creați endpointul SIP

Talkdesk documentează doar o listă de permisiuni IP, așadar creați un endpoint care acceptă
apeluri după adresa sursă:

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

Articolul Talkdesk precizează că trimite audio prin SRTP, iar `"srtp": "optional"`
răspunde cu SRTP când Talkdesk îl oferă. Articolul nu precizează dacă Talkdesk
necesită SRTP; dacă Talkdesk vă spune că îl necesită, setați `srtp` la `required`, ceea ce
refuză apelurile fără acesta.

Obțineți intervalele de semnalizare SIP ale Talkdesk de la Talkdesk. Fiecare trebuie să fie un interval
IPv4 public de `/16` sau mai restrâns (IPv6 `/48` sau mai restrâns). Consultați
[Platforme care se autentifică după IP-ul sursă](/ro/guides/sip-addresses).
Talkdesk trimite SIP din rețeaua Twilio, ale cărei adrese sunt partajate de fiecare client Twilio,
așadar adresa endpointului este cea care îi ține pe ceilalți apelanți în afară: nu
o publicați.
Păstrați `sip_uri` din răspuns, de exemplu
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Trimiteți apeluri cu context

În fluxul dvs. Studio, adăugați **Conectare la vocea Autopilot** în modul **Flux vocal
extern** și setați-i ținta la `sip_uri` al endpointului cu `;transport=tls` adăugat, de
exemplu `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Endpointul
refuză apelurile prin UDP, pe care SIP-ul Twilio îl utilizează dacă nu este instruit altfel.

Talkdesk trimite:

- `X-Talkdesk-Interaction-Id`, stocat ca `external_call_id` al apelului;
- `User-to-User`, codificat hexazecimal, cum ar fi `business_hours=open`. Ajunge în
  prompt decodificat, ca `{{sip_uui}}`.

Versiunea 2.1 a componentei poate trimite și **Antete definite**. Pagina de
preferințe Talkdesk le descrie ca JSON trimis printr-un WebSocket, așadar confirmați cu
Talkdesk dacă ajung ca antete SIP înainte de a vă baza pe ele.

## 3. Preluați apelul înapoi

Agentul vocal escaladează cu un `REFER` către adresa de escaladare Talkdesk, cu
ID-ul de predare ca UUI hexazecimal în acea adresă, singurul loc din care Talkdesk îl citește.
Adăugați acest număr de transfer (consultați
[Adăugați numărul de transfer](/ro/guides/contact-centers/overview)
și [Antete în interiorul adresei de transfer](/ro/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 este cea din articolul Talkdesk. Versiunea 2.1 a componentei
citește `autopilot_result=`; versiunea 1.7 citește `escalate_to=`, deci utilizați acea cheie în
1.7. `REFER` arată astfel:

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

Talkdesk introduce valoarea într-o variabilă Studio. Pentru a obține rezumatul și intenția,
adăugați un pas **Executați acțiunea** într-o integrare personalizată creată cu
Connections:

- Tip de autentificare **Cheie API**, nume antet `Authorization`, valoare
  `Bearer sk_live_…`.
- Cerere: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  urmat de ID-ul din variabilă. De asemenea, puteți căuta apelul după
  `external_call_id` folosind ID-ul interacțiunii.
- Direcționați în funcție de `handoff.intent` și afișați `handoff.summary` persoanei care
  preia apelul.

Consultați [Căutați un apel predat](/api-reference/calls#look-up-a-handed-off-call).

## Testați

Inițiați un apel prin fluxul Studio, solicitați agentului vocal să vă transfere la o persoană și verificați
că fluxul continuă după componentă cu ID-ul de predare în variabila sa. Apoi deschideți apelul cu `GET /v1/calls/{call_id}`:
`external_call_id` trebuie să fie ID-ul interacțiunii Talkdesk.

## Limite

- Talkdesk citește cel mult 256 de octeți de UUI și nu permite valori separate prin
  `|` sau `;`, deci trimiteți o singură valoare. ID-ul de predare se încadrează.
- API-urile Talkdesk nu pot citi transcrierea agentului vocal. Utilizați în schimb căutarea apelului predat sau
  `GET /v1/calls/{call_id}`.
