---
title: "Talkdesk वरून कनेक्ट करा"
description: "Connect to Autopilot Voice वापरून Talkdesk कॉल ThunderPhone एजंटकडे पाठवा आणि UUI मधील hand-off id वापरून ते पुन्हा एस्कलेट करा."
---

तुमचा Talkdesk Studio फ्लो कॉल करणाऱ्या व्यक्तीला इंटरेक्शन
id आणि UUI सह एजंटकडे पाठवतो. कॉल करणाऱ्या व्यक्तीला एखादी व्यक्ती हवी असल्यास, एजंट SIP
`REFER` वापरून Talkdesk कडे एस्कलेट करतो आणि हँड-ऑफ id Studio व्हेरिएबलमध्ये येतो.

## सुरू करण्यापूर्वी

- एक ThunderPhone एजंट आणि संस्थेची [API की](/mr/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 सिग्नलिंग श्रेण्या मिळवा. प्रत्येक श्रेणी सार्वजनिक IPv4
ची `/16` किंवा त्यापेक्षा अरुंद श्रेणी असणे आवश्यक आहे (IPv6 ची `/48` किंवा त्यापेक्षा अरुंद). पहा
[स्रोत IP द्वारे प्रमाणीकरण करणारे प्लॅटफॉर्म](/mr/guides/sip-addresses).
Talkdesk Twilio च्या नेटवर्कवरून SIP पाठवते, ज्याचे पत्ते प्रत्येक Twilio ग्राहक
सामायिक करतो, त्यामुळे इतर कॉल करणाऱ्यांना रोखणारा घटक म्हणजे एंडपॉइंटचा पत्ता आहे: तो
प्रकाशित करू नका.
प्रतिसादातील `sip_uri` जतन करा, उदाहरणार्थ
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. संदर्भासह कॉल पाठवा

तुमच्या Studio फ्लोमध्ये, **बाह्य व्हॉइस
स्ट्रीम** मोडमध्ये **ऑटोपायलट व्हॉइसशी कनेक्ट करा** जोडा आणि त्याचे लक्ष्य एंडपॉइंटच्या `sip_uri` वर सेट करा, त्यात `;transport=tls` जोडा, उदाहरणार्थ
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. एंडपॉइंट
UDP वरील कॉल नाकारतो, जो वेगळे सांगितल्याशिवाय Twilio चा SIP वापरतो.

Talkdesk पाठवते:

- `X-Talkdesk-Interaction-Id`, जो कॉलचा `external_call_id` म्हणून साठवला जातो;
- `User-to-User`, हेक्स-एन्कोड केलेले, जसे की `business_hours=open`. ते
  डीकोड होऊन prompt पर्यंत `{{sip_uui}}` म्हणून पोहोचते.

घटकाची आवृत्ती 2.1 **परिभाषित हेडर्स** देखील पाठवू शकते. Talkdesk चे
प्राधान्ये पृष्ठ त्यांचे वर्णन WebSocket वरून पाठवलेल्या JSON असे करते, त्यामुळे त्यांच्यावर अवलंबून राहण्यापूर्वी
ते SIP हेडर्स म्हणून येतात का याची Talkdesk कडून खात्री करा.

## 3. कॉल परत मिळवा

एजंट Talkdesk च्या एस्कलेशन पत्त्यावर `REFER` सह एस्कलेट करतो, ज्यामध्ये
हस्तांतरण आयडी त्या पत्त्यात हेक्स UUI म्हणून असतो; Talkdesk तो फक्त तिथेच वाचतो.
हा ट्रान्सफर क्रमांक जोडा (पहा
[ट्रान्सफर क्रमांक जोडा](/mr/guides/contact-centers/overview)
आणि [ट्रान्सफर पत्त्यामधील हेडर्स](/mr/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}` वापरा.
