---
title: "Talkdesk నుండి కనెక్ట్ చేయండి"
description: "Autopilot Voiceకు కనెక్ట్ చేయడం ద్వారా Talkdesk కాల్‌లను ThunderPhone ఏజెంట్‌కు పంపండి మరియు UUIలోని హ్యాండ్-ఆఫ్ IDతో వాటిని తిరిగి ఎస్కలేట్ చేయండి."
---

మీ Talkdesk Studio ఫ్లో కాలర్‌ను ఇంటరాక్షన్
ID మరియు UUIతో ఏజెంట్‌కు పంపుతుంది. కాలర్‌కు ఒక వ్యక్తి అవసరమైనప్పుడు, ఏజెంట్ SIP
`REFER` ద్వారా Talkdeskకు ఎస్కలేట్ చేస్తుంది, మరియు హ్యాండ్-ఆఫ్ ID ఒక Studio వేరియబుల్‌లోకి వస్తుంది.

## ప్రారంభించడానికి ముందు

- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ [API కీ](/te/guides/api-keys).
- ఒక Talkdesk **కన్వర్సేషన్ ఆర్కెస్ట్రేటర్** లైసెన్స్, ఇది **ఎక్స్‌టర్నల్ వాయిస్ స్ట్రీమ్** మోడ్‌లోని Studio
  **ఆటోపైలట్ వాయిస్‌కు కనెక్ట్ చేయండి** కాంపొనెంట్‌ను కవర్ చేస్తుంది
  ([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"`
Talkdesk అందించినప్పుడు SRTPతో ప్రతిస్పందిస్తుంది. Talkdeskకు SRTP అవసరమా అనే విషయాన్ని కథనం
చెప్పదు; అవసరమని Talkdesk మీకు చెబితే, `srtp`ను `required`గా సెట్ చేయండి, ఇది అది లేని
కాల్‌లను తిరస్కరిస్తుంది.

Talkdesk నుండి Talkdesk యొక్క SIP సిగ్నలింగ్ శ్రేణులను పొందండి. ప్రతి శ్రేణి `/16` లేదా మరింత
సంకుచితమైన పబ్లిక్ IPv4 శ్రేణి అయి ఉండాలి (IPv6లో `/48` లేదా మరింత సంకుచితం). చూడండి
[సోర్స్ IP ద్వారా ప్రామాణీకరించే ప్లాట్‌ఫారమ్‌లు](/te/guides/sip-addresses).
Talkdesk ప్రతి Twilio కస్టమర్ పంచుకునే Twilio నెట్‌వర్క్ నుండి SIPను పంపుతుంది, కాబట్టి ఇతర
కాలర్‌లను నిరోధించేది ఎండ్‌పాయింట్ చిరునామానే: దానిని ప్రచురించవద్దు.
ప్రతిస్పందనలోని `sip_uri`ను ఉంచుకోండి, ఉదాహరణకు
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. సందర్భంతో కాల్‌లను పంపండి

మీ Studio ఫ్లోలో, **ఎక్స్‌టర్నల్ వాయిస్
స్ట్రీమ్** మోడ్‌లో **ఆటోపైలట్ వాయిస్‌కు కనెక్ట్ చేయండి**ని జోడించి, దాని లక్ష్యాన్ని `;transport=tls` జోడించిన ఎండ్‌పాయింట్
`sip_uri`గా సెట్ చేయండి, ఉదాహరణకు `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Twilio యొక్క SIPకు వేరే విధంగా
చెప్పకపోతే UDPని ఉపయోగిస్తుంది, కాబట్టి ఎండ్‌పాయింట్ UDP ద్వారా వచ్చే కాల్‌లను తిరస్కరిస్తుంది.

Talkdesk పంపేవి:

- `X-Talkdesk-Interaction-Id`, ఇది కాల్ యొక్క `external_call_id`గా నిల్వ అవుతుంది;
- `User-to-User`, హెక్స్-ఎన్‌కోడ్ చేసినది, ఉదాహరణకు `business_hours=open`. ఇది
  డీకోడ్ అయి `{{sip_uui}}`గా promptకు చేరుతుంది.

కాంపొనెంట్ వెర్షన్ 2.1 **నిర్వచించిన హెడర్‌లు**ను కూడా పంపగలదు. Talkdesk యొక్క
ప్రాధాన్యతల పేజీ వాటిని WebSocket ద్వారా పంపే JSONగా వివరిస్తుంది, కాబట్టి వాటిపై ఆధారపడే ముందు
అవి SIP హెడర్‌లుగా వస్తాయో లేదో Talkdeskతో నిర్ధారించండి.

## 3. కాల్‌ను తిరిగి పొందండి

ఏజెంట్ Talkdesk ఎస్కలేషన్ చిరునామాకు `REFER` ద్వారా ఎస్కలేట్ చేస్తుంది. ఆ
చిరునామాలో hex UUIగా ఉన్న హ్యాండ్-ఆఫ్ IDని మాత్రమే Talkdesk చదువుతుంది.
ఈ బదిలీ నంబర్‌ను జోడించండి (చూడండి
[బదిలీ నంబర్‌ను జోడించండి](/te/guides/contact-centers/overview)
మరియు [బదిలీ చిరునామాలోని హెడర్‌లు](/te/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=`
  తర్వాత వేరియబుల్‌లోని IDని జోడించండి. ఇంటరాక్షన్ IDతో
  `external_call_id` ద్వారా కూడా కాల్‌ను చూడవచ్చు.
- `handoff.intent` ఆధారంగా రూట్ చేయండి, కాల్ తీసుకునే వ్యక్తికి
  `handoff.summary`ను చూపించండి.

చూడండి [హ్యాండ్-ఆఫ్ చేసిన కాల్‌ను చూడండి](/api-reference/calls#look-up-a-handed-off-call).

## దీన్ని పరీక్షించండి

Studio ఫ్లో ద్వారా కాల్ ప్రారంభించి, ఏజెంట్‌ను ఒక వ్యక్తికి బదిలీ చేయమని అడగండి,
ఆపై హ్యాండ్-ఆఫ్ ID దాని వేరియబుల్‌లో ఉండగా ఫ్లో కాంపొనెంట్‌ను దాటి
కొనసాగుతుందో తనిఖీ చేయండి. తర్వాత `GET /v1/calls/{call_id}`తో కాల్‌ను తెరవండి:
`external_call_id` అనేది Talkdesk ఇంటరాక్షన్ ID అయి ఉండాలి.

## పరిమితులు

- Talkdesk గరిష్ఠంగా 256 బైట్‌ల UUIని మాత్రమే చదువుతుంది మరియు `|` లేదా `;`తో
  వేరు చేసిన విలువలను అనుమతించదు, కాబట్టి ఒకే విలువను పంపండి. హ్యాండ్-ఆఫ్ ID
  సరిపోతుంది.
- Talkdesk APIలు ఏజెంట్ ట్రాన్స్‌క్రిప్ట్‌ను చదవలేవు. బదులుగా హ్యాండ్-ఆఫ్ లుకప్
  లేదా `GET /v1/calls/{call_id}`ను ఉపయోగించండి.
