---
title: "Talkdesk থেকে সংযোগ করুন"
description: "Connect to Autopilot Voice ব্যবহার করে Talkdesk কল একটি ThunderPhone এজেন্টের কাছে পাঠান এবং UUI-তে hand-off id দিয়ে সেগুলো আবার এসকেলেট করুন।"
---

আপনার Talkdesk Studio ফ্লো কলারকে interaction id এবং UUI সহ এজেন্টের কাছে পাঠায়। কলারের একজন ব্যক্তির প্রয়োজন হলে, এজেন্ট Talkdesk-এ একটি SIP `REFER` দিয়ে এসকেলেট করে এবং hand-off id একটি Studio ভেরিয়েবলে সংরক্ষিত হয়।

## শুরু করার আগে

- একটি ThunderPhone এজেন্ট এবং একটি সংস্থা [API key](/bn/guides/api-keys)।
- একটি Talkdesk **Conversation Orchestrator** লাইসেন্স, যা **External Voice Stream** মোডে Studio-এর **Connect to Autopilot Voice** কম্পোনেন্ট কভার করে
  ([Talkdesk-এর নিবন্ধ](https://support.talkdesk.com/hc/en-us/articles/48921776047259))।
  এজেন্ট কল ধরে রাখার সময় Talkdesk প্রতি মিনিটে বিল করে।

## 1. SIP এন্ডপয়েন্ট তৈরি করুন

Talkdesk শুধু একটি IP allowlist নথিভুক্ত করে, তাই উৎস ঠিকানা থেকে কল গ্রহণ করে এমন একটি এন্ডপয়েন্ট তৈরি করুন:

```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 signalling range সংগ্রহ করুন। প্রতিটি অবশ্যই একটি পাবলিক IPv4
রেঞ্জ `/16` বা তার চেয়ে সংকীর্ণ হতে হবে (IPv6 `/48` বা তার চেয়ে সংকীর্ণ)। দেখুন
[উৎস IP দিয়ে প্রমাণীকরণ করা প্ল্যাটফর্ম](/bn/guides/sip-addresses)।
Talkdesk Twilio-এর নেটওয়ার্ক থেকে SIP পাঠায়, যার ঠিকানা সব Twilio গ্রাহক
ভাগ করে ব্যবহার করে, তাই এন্ডপয়েন্টের ঠিকানাই অন্য কলারদের বাইরে রাখে: এটি
প্রকাশ করবেন না।
প্রতিক্রিয়ার `sip_uri` সংরক্ষণ করুন, যেমন
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`।

## 2. কনটেক্সটসহ কল পাঠান

আপনার Studio ফ্লোতে **External Voice
Stream** মোডে **Connect to Autopilot Voice** যোগ করুন এবং এর লক্ষ্য হিসেবে এন্ডপয়েন্টের `sip_uri`-তে `;transport=tls` যুক্ত করে সেট করুন, যেমন
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`। এন্ডপয়েন্ট UDP-এর মাধ্যমে কল প্রত্যাখ্যান করে, কারণ অন্যথা না বললে Twilio-এর SIP UDP ব্যবহার করে।

Talkdesk পাঠায়:

- `X-Talkdesk-Interaction-Id`, যা কলের `external_call_id` হিসেবে সংরক্ষিত হয়;
- `User-to-User`, হেক্স-এনকোড করা, যেমন `business_hours=open`। এটি ডিকোড হয়ে
  `{{sip_uui}}` হিসেবে prompt-এ পৌঁছায়।

কম্পোনেন্টের সংস্করণ 2.1 **Defined headers**-ও পাঠাতে পারে। Talkdesk-এর
পছন্দসমূহের পৃষ্ঠায় এগুলোকে WebSocket-এর মাধ্যমে পাঠানো JSON হিসেবে বর্ণনা করা হয়েছে, তাই এগুলোর ওপর নির্ভর করার আগে Talkdesk-এর সঙ্গে নিশ্চিত করুন যে সেগুলো SIP header হিসেবে আসে কি না।

## 3. কলটি ফিরে পান

এজেন্ট Talkdesk-এর এসকেলেশন ঠিকানায় একটি `REFER` দিয়ে এসকেলেট করে, যেখানে
হ্যান্ড-অফ আইডিটি সেই ঠিকানার ভিতরে হেক্স UUI হিসেবে থাকে—Talkdesk শুধুমাত্র সেখান থেকেই এটি পড়ে।
এই ট্রান্সফার নম্বরটি যোগ করুন (দেখুন
[ট্রান্সফার নম্বর যোগ করুন](/bn/guides/contact-centers/overview)
এবং [ট্রান্সফার ঠিকানার ভিতরের হেডার](/bn/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}` ব্যবহার করুন।
