---
title: "Talkdesk માંથી કનેક્ટ કરો"
description: "Connect to Autopilot Voice સાથે Talkdesk કૉલ્સને ThunderPhone એજન્ટ પાસે મોકલો અને UUI માં hand-off id સાથે તેમને પાછા એસ્કેલેટ કરો."
---

તમારો Talkdesk Studio ફ્લો કૉલરને ઇન્ટરૅક્શન
id અને UUI સાથે એજન્ટ સુધી મોકલે છે. જ્યારે કૉલરને વ્યક્તિની જરૂર હોય, ત્યારે
એજન્ટ Talkdesk પર SIP `REFER` વડે એસ્કેલેટ કરે છે અને હેન્ડ-ઑફ id Studio વેરિએબલમાં આવે છે.

## શરૂ કરતા પહેલાં

- ThunderPhone એજન્ટ અને સંસ્થાની [API કી](/gu/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 દ્વારા પ્રમાણીકરણ કરતા પ્લેટફોર્મ્સ](/gu/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`. તે
  `{{sip_uui}}` તરીકે ડીકોડ થઈને prompt સુધી પહોંચે છે.

કમ્પોનન્ટનું વર્ઝન 2.1 **નિર્ધારિત હેડર્સ** પણ મોકલી શકે છે. Talkdeskનું
પસંદગીઓ પૃષ્ઠ તેમને WebSocket મારફતે મોકલાતા JSON તરીકે વર્ણવે છે, તેથી તેના પર
આધાર રાખતા પહેલાં Talkdesk સાથે પુષ્ટિ કરો કે તેઓ SIP હેડર્સ તરીકે પહોંચે છે કે નહીં.

## 3. કૉલ પાછો મેળવો

એજન્ટ Talkdeskના એસ્કેલેશન સરનામા પર `REFER` સાથે એસ્કેલેટ કરે છે, જેમાં
હસ્તાંતરણ ID તે સરનામાની અંદર હેક્સ UUI તરીકે હોય છે, જે એકમાત્ર સ્થાન છે જ્યાં Talkdesk તેને વાંચે છે.
આ ટ્રાન્સફર નંબર ઉમેરો (જુઓ
[ટ્રાન્સફર નંબર ઉમેરો](/gu/guides/contact-centers/overview)
અને [ટ્રાન્સફર સરનામાની અંદરના હેડર્સ](/gu/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ના APIs એજન્ટનો ટ્રાન્સક્રિપ્ટ વાંચી શકતા નથી. તેના બદલે હસ્તાંતરણ લુકઅપ અથવા
  `GET /v1/calls/{call_id}` વાપરો.
