---
title: "Forbind fra Talkdesk"
description: "Send Talkdesk-opkald til en ThunderPhone-agent med Connect to Autopilot Voice, og eskaler dem tilbage med overdragelses-id'et i UUI."
---

Dit Talkdesk Studio-flow sender opkalderen til agenten med interaktions-id'et
og UUI. Når opkalderen har brug for en person, eskalerer agenten med en SIP-
`REFER` til Talkdesk, og overdragelses-id'et ender i en Studio-variabel.

## Før du starter

- En ThunderPhone-agent og en organisations-[API-nøgle](/da/guides/api-keys).
- En Talkdesk-licens til **Samtaleorkestrering**, som dækker Studio-
  komponenten **Forbind til Autopilot Voice** i tilstanden **Ekstern stemmestrøm**
  ([Talkdesks artikel](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk fakturerer pr. minut, mens agenten har opkaldet.

## 1. Opret SIP-slutpunktet

Talkdesk angiver kun en IP-tilladelsesliste, så opret et slutpunkt, der accepterer
opkald efter kildeadresse:

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

Talkdesks artikel angiver, at den sender lyd over SRTP, og `"srtp": "optional"`
bruger SRTP, når Talkdesk tilbyder det. Artiklen angiver ikke, om Talkdesk
kræver SRTP. Hvis Talkdesk oplyser, at det gør, skal du sætte `srtp` til `required`,
hvilket afviser opkald uden det.

Få Talkdesks SIP-signalområder fra Talkdesk. Hvert område skal være et offentligt IPv4-
område på `/16` eller smallere (IPv6 `/48` eller smallere). Se
[Platforme, der godkender efter kilde-IP](/da/guides/sip-addresses).
Talkdesk sender SIP fra Twilios netværk, hvis adresser deles af alle Twilio-kunder,
så slutpunktets adresse er det, der holder andre opkaldere ude: publicer den
ikke.
Gem svarets `sip_uri`, for eksempel
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Send opkald med kontekst

Tilføj **Forbind til Autopilot Voice** i tilstanden **Ekstern stemmestrøm** i dit
Studio-flow, og sæt målet til slutpunktets `sip_uri` med `;transport=tls` tilføjet, for
eksempel `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Slutpunktet
afviser opkald via UDP, som Twilios SIP bruger, medmindre andet angives.

Talkdesk sender:

- `X-Talkdesk-Interaction-Id`, som gemmes som opkaldets `external_call_id`;
- `User-to-User`, hex-kodet, for eksempel `business_hours=open`. Det når
  prompten afkodet som `{{sip_uui}}`.

Version 2.1 af komponenten kan også sende **Definerede headere**. Talkdesks
indstillingsside beskriver dem som JSON sendt over en WebSocket, så bekræft med
Talkdesk, om de ankommer som SIP-headere, før du er afhængig af dem.

## 3. Få opkaldet tilbage

Agenten eskalerer med en `REFER` til Talkdesks eskaleringsadresse med
overdragelses-id'et som hex-UUI i adressen, det eneste sted Talkdesk læser det.
Tilføj dette overførselsnummer (se
[Tilføj overførselsnummeret](/da/guides/contact-centers/overview)
og [Headers i overførselsadressen](/da/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"
}
```

Adressen er den, der bruges i Talkdesks artikel. Version 2.1 af komponenten
læser `autopilot_result=`; version 1.7 læser `escalate_to=`, så brug den nøgle i
1.7. `REFER` ser sådan ud:

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

Talkdesk placerer værdien i en Studio-variabel. For at hente resuméet og
hensigten skal du tilføje et trin med **Udfør handling** i en brugerdefineret
integration bygget med Connections:

- Godkendelsestype **API-nøgle**, headernavn `Authorization`, værdi
  `Bearer sk_live_…`.
- Anmodning: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  efterfulgt af id'et fra variablen. Du kan også slå opkaldet op via
  `external_call_id` med interaktions-id'et.
- Rout efter `handoff.intent`, og vis `handoff.summary` til den person, der
  overtager opkaldet.

Se [Slå et overdraget opkald op](/api-reference/calls#look-up-a-handed-off-call).

## Test det

Start et opkald gennem Studio-flowet, bed agenten om en person, og kontrollér,
at flowet fortsætter forbi komponenten med overdragelses-id'et i variablen.
Åbn derefter opkaldet med `GET /v1/calls/{call_id}`:
`external_call_id` skal være Talkdesk-interaktions-id'et.

## Begrænsninger

- Talkdesk læser højst 256 byte UUI og tillader ikke værdier adskilt med
  `|` eller `;`, så send én enkelt værdi. Overdragelses-id'et passer.
- Talkdesks API'er kan ikke læse agentens transskription. Brug i stedet opslaget
  af overdragelsen eller `GET /v1/calls/{call_id}`.
