---
title: "Talkdesk-ൽ നിന്ന് ബന്ധിപ്പിക്കുക"
description: "Connect to Autopilot Voice ഉപയോഗിച്ച് Talkdesk കോളുകൾ ThunderPhone ഏജന്റിലേക്ക് അയയ്ക്കുക, UUI-യിലെ hand-off id ഉപയോഗിച്ച് അവ തിരിച്ചും എസ്കലേറ്റ് ചെയ്യുക."
---

നിങ്ങളുടെ Talkdesk Studio ഫ്ലോ, ഇന്ററാക്ഷൻ
id-യും UUI-യും സഹിതം കോളറെ ഏജന്റിലേക്ക് അയയ്ക്കുന്നു. കോളർക്ക് ഒരു വ്യക്തിയെ ആവശ്യമുള്ളപ്പോൾ, ഏജന്റ് Talkdesk-ലേക്ക് SIP
`REFER` ഉപയോഗിച്ച് എസ്കലേറ്റ് ചെയ്യുന്നു, തുടർന്ന് ഹാൻഡ്-ഓഫ് id ഒരു Studio വേരിയബിളിൽ എത്തുന്നു.

## ആരംഭിക്കുന്നതിന് മുമ്പ്

- ഒരു ThunderPhone ഏജന്റും ഒരു ഓർഗനൈസേഷൻ [API key](/ml/guides/api-keys)-യും.
- **എക്സ്റ്റേണൽ വോയ്സ് സ്ട്രീം** മോഡിലുള്ള Studio **ഓട്ടോപൈലറ്റ് വോയിസിലേക്ക് കണക്റ്റ് ചെയ്യുക** കോംപോണന്റ് ഉൾക്കൊള്ളുന്ന Talkdesk **Conversation Orchestrator** ലൈസൻസ്
  ([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 വഴി ഓഡിയോ അയയ്ക്കുന്നതായി Talkdesk-ന്റെ ലേഖനം പറയുന്നു, കൂടാതെ Talkdesk അത് വാഗ്ദാനം ചെയ്യുമ്പോൾ `"srtp": "optional"`
SRTP ഉപയോഗിച്ച് മറുപടി നൽകുന്നു. Talkdesk-ന് SRTP ആവശ്യമാണോ എന്ന് ലേഖനം
പറയുന്നില്ല; ആവശ്യമാണെന്ന് Talkdesk നിങ്ങളോട് പറയുകയാണെങ്കിൽ, SRTP ഇല്ലാത്ത
കോളുകൾ നിരസിക്കുന്നതിന് `srtp` `required` ആയി സജ്ജമാക്കുക.

Talkdesk-ന്റെ SIP സിഗ്നലിങ് റേഞ്ചുകൾ Talkdesk-ൽ നിന്ന് നേടുക. ഓരോന്നും `/16` അല്ലെങ്കിൽ അതിലും ഇടുങ്ങിയ ഒരു പബ്ലിക് IPv4
റേഞ്ചായിരിക്കണം (IPv6-ന് `/48` അല്ലെങ്കിൽ അതിലും ഇടുങ്ങിയത്). കാണുക
[ഉറവിട IP ഉപയോഗിച്ച് പ്രാമാണീകരിക്കുന്ന പ്ലാറ്റ്ഫോമുകൾ](/ml/guides/sip-addresses).
Talkdesk, എല്ലാ Twilio ഉപഭോക്താക്കളും പങ്കിടുന്ന Twilio-യുടെ നെറ്റ്വർക്കിൽ നിന്നാണ് SIP അയയ്ക്കുന്നത്,
അതിനാൽ മറ്റ് കോളർമാരെ പുറത്തുനിർത്തുന്നത് എൻഡ്‌പോയിന്റിന്റെ വിലാസമാണ്: അത്
പ്രസിദ്ധീകരിക്കരുത്.
മറുപടിയിലെ `sip_uri` സൂക്ഷിക്കുക, ഉദാഹരണത്തിന്
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. സന്ദർഭത്തോടൊപ്പം കോളുകൾ അയയ്ക്കുക

നിങ്ങളുടെ Studio ഫ്ലോയിൽ, **എക്സ്റ്റേണൽ വോയ്സ്
സ്ട്രീം** മോഡിൽ **ഓട്ടോപൈലറ്റ് വോയിസിലേക്ക് കണക്റ്റ് ചെയ്യുക** ചേർക്കുക, അതിന്റെ ടാർഗെറ്റ് എൻഡ്‌പോയിന്റിന്റെ `sip_uri` ആയി `;transport=tls` ചേർത്ത് സജ്ജമാക്കുക, ഉദാഹരണത്തിന്
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. മറ്റുവിധത്തിൽ നിർദേശിച്ചില്ലെങ്കിൽ Twilio-യുടെ SIP ഉപയോഗിക്കുന്ന UDP വഴിയുള്ള കോളുകൾ
എൻഡ്‌പോയിന്റ് നിരസിക്കുന്നു.

Talkdesk അയയ്ക്കുന്നത്:

- കോളിന്റെ `external_call_id` ആയി സംഭരിക്കുന്ന `X-Talkdesk-Interaction-Id`;
- `business_hours=open` പോലുള്ള, ഹെക്സ്-എൻകോഡ് ചെയ്ത `User-to-User`. ഇത്
  ഡീകോഡ് ചെയ്ത് `{{sip_uui}}` ആയി prompt-ലേക്ക് എത്തുന്നു.

കോംപോണന്റിന്റെ പതിപ്പ് 2.1-ന് **നിർവചിച്ച ഹെഡറുകൾ** അയയ്ക്കാനും കഴിയും. Talkdesk-ന്റെ
മുൻഗണനാ പേജ് അവയെ WebSocket വഴി അയയ്ക്കുന്ന JSON എന്നാണ് വിവരിക്കുന്നത്, അതിനാൽ
അവയെ ആശ്രയിക്കുന്നതിന് മുമ്പ് അവ SIP ഹെഡറുകളായി എത്തുന്നുണ്ടോ എന്ന് Talkdesk-നോട് സ്ഥിരീകരിക്കുക.

## 3. കോൾ തിരികെ ലഭിക്കുക

ഏജന്റ് Talkdesk-ന്റെ എസ്കലേഷൻ വിലാസത്തിലേക്ക് `REFER` ഉപയോഗിച്ച് എസ്കലേറ്റ് ചെയ്യുന്നു. Talkdesk അത് വായിക്കുന്ന ഏക സ്ഥലമായ ആ വിലാസത്തിനുള്ളിൽ ഹാൻഡ്-ഓഫ് ഐഡി ഹെക്സ് UUI ആയി ഉൾപ്പെടുന്നു.
ഈ ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക ([ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക](/ml/guides/contact-centers/overview)
കൂടാതെ [ട്രാൻസ്ഫർ വിലാസത്തിനുള്ളിലെ ഹെഡറുകൾ](/ml/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 വേരിയബിളിൽ ഇടുന്നു. സംഗ്രഹവും ഉദ്ദേശ്യവും ലഭിക്കാൻ,
Connections ഉപയോഗിച്ച് നിർമ്മിച്ച ഇഷ്ടാനുസൃത ഇന്റഗ്രേഷനിൽ ഒരു **പ്രവർത്തനം നിർവഹിക്കുക** ഘട്ടം ചേർക്കുക:

- ഓത്ത് തരം **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}` ഉപയോഗിക്കുക.
