---
title: "Talkdesk ਤੋਂ ਕਨੈਕਟ ਕਰੋ"
description: "Connect to Autopilot Voice ਨਾਲ Talkdesk ਕਾਲਾਂ ਨੂੰ ThunderPhone ਏਜੰਟ ਕੋਲ ਭੇਜੋ, ਅਤੇ UUI ਵਿੱਚ hand-off id ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਉਹਨਾਂ ਨੂੰ ਵਾਪਸ ਐਸਕਲੇਟ ਕਰੋ।"
---

ਤੁਹਾਡਾ Talkdesk Studio ਫਲੋ ਕਾਲਰ ਨੂੰ interaction
id ਅਤੇ UUI ਦੇ ਨਾਲ ਏਜੰਟ ਕੋਲ ਭੇਜਦਾ ਹੈ। ਜਦੋਂ ਕਾਲਰ ਨੂੰ ਕਿਸੇ ਵਿਅਕਤੀ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ, ਏਜੰਟ SIP
`REFER` ਰਾਹੀਂ Talkdesk ਨੂੰ ਐਸਕੇਲੇਟ ਕਰਦਾ ਹੈ, ਅਤੇ ਹੈਂਡ-ਆਫ id ਇੱਕ Studio ਵੇਰੀਏਬਲ ਵਿੱਚ ਆ ਜਾਂਦੀ ਹੈ।

## ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ

- ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ [API ਕੁੰਜੀ](/pa/guides/api-keys)।
- Talkdesk ਦਾ **ਕਨਵਰਸੇਸ਼ਨ ਆਰਕੇਸਟ੍ਰੇਟਰ** ਲਾਇਸੈਂਸ, ਜੋ **ਬਾਹਰੀ ਵੌਇਸ ਸਟ੍ਰੀਮ** ਮੋਡ ਵਿੱਚ Studio
  ਦੇ **ਆਟੋਪਾਇਲਟ ਵੌਇਸ ਨਾਲ ਕਨੈਕਟ ਕਰੋ** ਕੰਪੋਨੈਂਟ ਨੂੰ ਕਵਰ ਕਰਦਾ ਹੈ
  ([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 ਸਿਗਨਲਿੰਗ ਰੇਂਜਾਂ ਪ੍ਰਾਪਤ ਕਰੋ। ਹਰ ਇੱਕ ਜਨਤਕ IPv4
ਰੇਂਜ `/16` ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ (IPv6 `/48` ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ)। ਵੇਖੋ
[ਉਹ ਪਲੇਟਫਾਰਮ ਜੋ ਸਰੋਤ IP ਰਾਹੀਂ ਪ੍ਰਮਾਣਿਤ ਹੁੰਦੇ ਹਨ](/pa/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 ਵਜੋਂ ਦਰਸਾਉਂਦਾ ਹੈ, ਇਸ ਲਈ ਉਹਨਾਂ 'ਤੇ ਨਿਰਭਰ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ
Talkdesk ਨਾਲ ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ ਕੀ ਉਹ SIP ਹੈਡਰਾਂ ਵਜੋਂ ਪਹੁੰਚਦੇ ਹਨ।

## 3. ਕਾਲ ਵਾਪਸ ਪ੍ਰਾਪਤ ਕਰੋ

ਏਜੰਟ Talkdesk ਦੇ ਐਸਕੇਲੇਸ਼ਨ ਪਤੇ ਲਈ `REFER` ਨਾਲ ਐਸਕੇਲੇਟ ਕਰਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ
ਹੈਂਡ-ਆਫ਼ ID ਉਸ ਪਤੇ ਦੇ ਅੰਦਰ hex UUI ਵਜੋਂ ਹੁੰਦੀ ਹੈ, ਅਤੇ Talkdesk ਇਸਨੂੰ ਸਿਰਫ਼ ਉੱਥੇ ਹੀ ਪੜ੍ਹਦਾ ਹੈ।
ਇਹ ਟ੍ਰਾਂਸਫ਼ਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ (ਵੇਖੋ
[ਟ੍ਰਾਂਸਫ਼ਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ](/pa/guides/contact-centers/overview)
ਅਤੇ [ਟ੍ਰਾਂਸਫ਼ਰ ਪਤੇ ਦੇ ਅੰਦਰ ਹੈਡਰ](/pa/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}` ਵਰਤੋ।
