---
title: "Unganisha kutoka Talkdesk"
description: "Tuma simu za Talkdesk kwa ejenti wa ThunderPhone ukitumia Connect to Autopilot Voice, na zirudishe kwa hand-off id katika UUI."
---

Mtiririko wako wa Talkdesk Studio humtuma mpigaji kwa ejenti pamoja na kitambulisho cha mwingiliano na UUI. Mpigaji anapohitaji mtu, ejenti hupeleka kwa SIP `REFER` kwenda Talkdesk, na kitambulisho cha uhamisho huwekwa kwenye kigeu cha Studio.

## Kabla ya kuanza

- Ejenti wa ThunderPhone na [ufunguo wa API](/sw/guides/api-keys) wa shirika.
- Leseni ya Talkdesk **Conversation Orchestrator**, inayojumuisha kipengele cha Studio cha **Connect to Autopilot Voice** katika hali ya **External Voice Stream** ([makala ya Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk hutoza kwa dakika wakati ejenti anashikilia simu.

## 1. Unda endpoint ya SIP

Talkdesk inaandika orodha ya kuruhusu IP pekee, kwa hivyo unda endpoint inayokubali
simu kwa anwani ya chanzo:

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

Makala ya Talkdesk inasema hutuma sauti kupitia SRTP, na `"srtp": "optional"`
hujibu kwa SRTP wakati Talkdesk inapoitoa. Makala haisemi kama Talkdesk
inahitaji SRTP; Talkdesk ikikuambia inahitaji, weka `srtp` kuwa `required`, ambayo
hukataa simu zisizo nayo.

Pata safu za uashiriaji za SIP za Talkdesk kutoka Talkdesk. Kila moja lazima iwe safu ya
umma ya IPv4 ya `/16` au nyembamba zaidi (IPv6 `/48` au nyembamba zaidi). Tazama
[Majukwaa yanayothibitisha kwa IP ya chanzo](/sw/guides/sip-addresses).
Talkdesk hutuma SIP kutoka kwenye mtandao wa Twilio, ambao anwani zake hushirikiwa na kila mteja wa Twilio,
kwa hivyo anwani ya endpoint ndiyo inayowazuia wapigaji wengine: usiichapishe.
Hifadhi `sip_uri` ya jibu, kwa mfano
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Tuma simu pamoja na muktadha

Katika mtiririko wako wa Studio, ongeza **Connect to Autopilot Voice** katika hali ya **External Voice
Stream** na uweke lengo lake kuwa `sip_uri` ya endpoint ukiwa umeongeza `;transport=tls`, kwa
mfano `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Endpoint
hukataa simu kupitia UDP, ambayo SIP ya Twilio hutumia isipokuwa iambiwe vinginevyo.

Talkdesk hutuma:

- `X-Talkdesk-Interaction-Id`, ikihifadhiwa kama `external_call_id` ya simu;
- `User-to-User`, iliyosimbwa kwa heksadesimali, kama vile `business_hours=open`. Hufika kwenye
  prompt ikiwa imesimbuliwa, kama `{{sip_uui}}`.

Toleo la 2.1 la kipengele linaweza pia kutuma **Defined headers**. Ukurasa wa
mapendeleo wa Talkdesk unaeleza hizi kama JSON inayotumwa kupitia WebSocket, kwa hivyo thibitisha na
Talkdesk kama zinawasili kama vichwa vya SIP kabla ya kuzitegemea.

## 3. Pata simu irudi

Ejenti huelekeza simu kwa `REFER` kwenda kwenye anwani ya uelekezaji ya Talkdesk, huku
kitambulisho cha hand-off kikiwa kama UUI ya hex ndani ya anwani hiyo, mahali pekee
ambapo Talkdesk hukisoma. Ongeza nambari hii ya uhamisho (tazama
[Ongeza nambari ya uhamisho](/sw/guides/contact-centers/overview)
na [Vichwa ndani ya anwani ya uhamisho](/sw/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"
}
```

Anwani ni ile iliyo kwenye makala ya Talkdesk. Toleo 2.1 la kipengele hiki
husoma `autopilot_result=`; toleo 1.7 husoma `escalate_to=`, kwa hivyo tumia ufunguo huo kwenye
1.7. `REFER` inaonekana hivi:

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

Talkdesk huweka thamani kwenye kigezo cha Studio. Ili kupata muhtasari na nia,
ongeza hatua ya **Tekeleza Kitendo** kwenye muunganisho maalum ulioundwa kwa kutumia
Connections:

- Aina ya uthibitishaji **ufunguo wa API**, jina la kichwa `Authorization`, thamani
  `Bearer sk_live_…`.
- Ombi: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ikifuatiwa na kitambulisho kutoka kwenye kigezo. Unaweza pia kutafuta simu kwa
  `external_call_id` ukitumia kitambulisho cha mwingiliano.
- Elekeza mtiririko kulingana na `handoff.intent`, na umwonyeshe `handoff.summary` mtu anayepokea
  simu.

Tazama [Tafuta simu iliyokabidhiwa](/api-reference/calls#look-up-a-handed-off-call).

## Ijaribu

Anzisha simu kupitia mtiririko wa Studio, mwombe ejenti akuunganishe na mtu, na uthibitishe
kwamba mtiririko unaendelea baada ya kipengele hicho ukiwa na kitambulisho cha hand-off kwenye
kigezo chake. Kisha fungua simu kwa `GET /v1/calls/{call_id}`:
`external_call_id` inapaswa kuwa kitambulisho cha mwingiliano cha Talkdesk.

## Vikomo

- Talkdesk husoma upeo wa baiti 256 za UUI na hairuhusu thamani zilizotenganishwa kwa
  `|` au `;`, kwa hivyo tuma thamani moja. Kitambulisho cha hand-off kinatoshea.
- API za Talkdesk haziwezi kusoma transkripti ya ejenti. Tumia utafutaji wa hand-off au
  `GET /v1/calls/{call_id}` badala yake.
