---
title: "Talkdesk இலிருந்து இணைக்கவும்"
description: "Autopilot Voice-இன் Connect ஐப் பயன்படுத்தி Talkdesk அழைப்புகளை ThunderPhone ஏஜென்டுக்கு அனுப்பவும்; UUI-யில் உள்ள hand-off id மூலம் அவற்றை மீண்டும் எஸ்கலேட் செய்யவும்."
---

உங்கள் Talkdesk Studio பாய்வு, அழைப்பாளரை interaction id மற்றும் UUI உடன் ஏஜென்ட்டுக்கு அனுப்புகிறது. அழைப்பாளருக்கு ஒரு நபர் தேவைப்படும்போது, ஏஜென்ட் SIP `REFER` மூலம் Talkdesk-க்கு எஸ்கலேட் செய்கிறது; hand-off id ஒரு Studio மாறியில் சேமிக்கப்படுகிறது.

## தொடங்குவதற்கு முன்

- ஒரு ThunderPhone ஏஜென்ட் மற்றும் நிறுவன [API விசை](/ta/guides/api-keys).
- Talkdesk **உரையாடல் ஒருங்கிணைப்பாளர்** உரிமம், இது **வெளிப்புற குரல் ஸ்ட்ரீம்** பயன்முறையில் உள்ள Studio **Autopilot குரலுடன் இணை** கூறை உள்ளடக்கும்
  ([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` ஆக `srtp`-ஐ அமைக்கவும்.

Talkdesk-இலிருந்து Talkdesk-ன் SIP சிக்னலிங் வரம்புகளைப் பெறவும். ஒவ்வொன்றும் `/16`
அல்லது அதைவிடக் குறுகிய பொது IPv4 வரம்பாக இருக்க வேண்டும் (IPv6-க்கு `/48` அல்லது அதைவிடக் குறுகியதாக).
[மூல IP மூலம் அங்கீகரிக்கும் தளங்கள்](/ta/guides/sip-addresses) என்பதைப் பார்க்கவும்.
Talkdesk, ஒவ்வொரு Twilio வாடிக்கையாளரும் பகிரும் Twilio நெட்வொர்க்கிலிருந்து SIP-ஐ அனுப்புகிறது;
எனவே மற்ற அழைப்பாளர்களைத் தடுப்பது எண்ட்பாயிண்ட்டின் முகவரிதான்: அதை
வெளியிடாதீர்கள்.
பதிலில் உள்ள `sip_uri`-ஐ வைத்துக்கொள்ளவும், எடுத்துக்காட்டாக
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. சூழலுடன் அழைப்புகளை அனுப்பவும்

உங்கள் Studio பாய்வில், **வெளிப்புற குரல் ஸ்ட்ரீம்** பயன்முறையில் **Autopilot குரலுடன் இணை** என்பதைச் சேர்த்து, அதன் இலக்கை `;transport=tls` சேர்க்கப்பட்ட எண்ட்பாயிண்ட்டின் `sip_uri` ஆக அமைக்கவும், எடுத்துக்காட்டாக `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. வேறுவிதமாகக் கூறப்படாவிட்டால் Twilio-வின் SIP பயன்படுத்தும் UDP வழியான அழைப்புகளை எண்ட்பாயிண்ட் மறுக்கும்.

Talkdesk அனுப்புவது:

- அழைப்பின் `external_call_id` ஆகச் சேமிக்கப்படும் `X-Talkdesk-Interaction-Id`;
- `business_hours=open` போன்ற ஹெக்ஸ்-குறியிடப்பட்ட `User-to-User`. இது `{{sip_uui}}` ஆகக் குறியீட்டுநீக்கப்பட்ட நிலையில் prompt-ஐ அடைகிறது.

இந்தக் கூறின் பதிப்பு 2.1, **வரையறுக்கப்பட்ட தலைப்புகளையும்** அனுப்ப முடியும். Talkdesk-ன்
விருப்பங்கள் பக்கம் அவற்றை WebSocket வழியாக அனுப்பப்படும் JSON என விவரிக்கிறது; எனவே
அவற்றை நம்புவதற்கு முன் அவை SIP தலைப்புகளாக வருகிறதா என்பதை Talkdesk-இடம் உறுதிப்படுத்தவும்.

## 3. அழைப்பை மீண்டும் பெறுக

ஏஜென்ட், Talkdesk இதைப் படிக்கும் ஒரே இடமான அதன் எஸ்கலேஷன் முகவரிக்கு,
அந்த முகவரிக்குள் hex UUI ஆக ஒப்படைப்பு ஐடியுடன் `REFER` மூலம் மேல்நிலைக்கு அனுப்புகிறது.
இந்த பரிமாற்ற எண்ணைச் சேர்க்கவும் (பார்க்கவும்
[பரிமாற்ற எண்ணைச் சேர்க்கவும்](/ta/guides/contact-centers/overview)
மற்றும் [பரிமாற்ற முகவரிக்குள் உள்ள ஹெடர்கள்](/ta/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 மதிப்பை ஒரு ஸ்டுடியோ மாறியில் வைக்கிறது. சுருக்கத்தையும் நோக்கத்தையும்
பெற, கனெக்ஷன்ஸ் மூலம் உருவாக்கப்பட்ட தனிப்பயன் ஒருங்கிணைப்பில் **செயலை இயக்குக**
படியைச் சேர்க்கவும்:

- அங்கீகார வகை **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) என்பதைப் பார்க்கவும்.

## இதைச் சோதிக்கவும்

ஸ்டுடியோ ஃப்ளோ மூலம் அழைப்பைத் தொடங்கி, ஒரு நபரிடம் இணைக்குமாறு ஏஜென்ட்டிடம் கேட்டு,
அதன் மாறியில் ஒப்படைப்பு ஐடியுடன் காம்பொனென்ட்டைக் கடந்து ஃப்ளோ தொடர்வதைச் சரிபார்க்கவும்.
பின்னர் `GET /v1/calls/{call_id}` மூலம் அழைப்பைத் திறக்கவும்:
`external_call_id` என்பது Talkdesk இன்டராக்ஷன் ஐடியாக இருக்க வேண்டும்.

## வரம்புகள்

- Talkdesk அதிகபட்சம் 256 பைட்டுகள் UUI-ஐப் படிக்கும்; மேலும் `|` அல்லது `;` மூலம்
  பிரிக்கப்பட்ட மதிப்புகளை அனுமதிக்காது, எனவே ஒரு மதிப்பை மட்டும் அனுப்பவும்.
  ஒப்படைப்பு ஐடி இதில் பொருந்தும்.
- Talkdesk API-களால் ஏஜென்ட்டின் உரையாடல் பதிவேட்டைப் படிக்க முடியாது. அதற்குப் பதிலாக
  ஒப்படைப்பு தேடலை அல்லது `GET /v1/calls/{call_id}`-ஐப் பயன்படுத்தவும்.
