---
title: "Five9 இலிருந்து இணைக்கவும்"
description: "AI Agent Connect மூலம் Five9 அழைப்புகளை SIP வழியாக ThunderPhone ஏஜென்ட்டுக்கு அனுப்பி, உங்கள் IVR ஸ்கிரிப்ட் படிக்கும் ரூட்டிங் ஹெடர்களுடன் அவற்றை மீண்டும் பெறுங்கள்."
---

உங்கள் Five9 IVR ஸ்கிரிப்ட், Five9-இன் அழைப்பு விவரங்களுடன் அழைப்பாளரை ஏஜென்ட்டிற்கு அனுப்புகிறது. ஏஜென்ட் முடித்ததும், SIP `BYE`-இல் வழிமாற்று தலைப்புகளுடன் அழைப்பை முடிக்கிறது; அழைப்பாளரை வழிமாற்ற ஸ்கிரிப்ட் அவற்றை அழைப்பு மாறிகளாகப் படிக்கிறது.

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

- ஒரு ThunderPhone ஏஜென்ட் மற்றும் ஒரு நிறுவனத்தின் [API விசை](/ta/guides/api-keys).
- Five9-இன் **AI ஏஜென்ட் இணைப்பு** கூடுதல் அம்சம். Five9 இதை அங்கீகரித்த AI வழங்குநர்களுக்கு மட்டுமே வரம்பிடுகிறது, மேலும் Five9-இன் செயல்படுத்தல் குழு இதை அமைக்கிறது: அது வழங்குநரின் IVR ஸ்கிரிப்ட் வார்ப்புருவை இறக்குமதி செய்து, அழைப்பு மாறிகளை உருவாக்கி, ஸ்கிரிப்டின் **மூன்றாம் தரப்பு பரிமாற்றம்** தொகுதியை வழங்குநரை நோக்கி அமைக்கிறது. ThunderPhone இன்னும் Five9-இன் அங்கீகரிக்கப்பட்ட பட்டியலில் இல்லை: இதை அடிப்படையாகக் கொண்டு திட்டமிடுவதற்கு முன் உங்கள் Five9 கணக்குக் குழுவையோ ThunderPhone ஆதரவையோ கேளுங்கள்.

## 1. SIP இறுதிப்புள்ளியை உருவாக்குங்கள்

Five9-இன் மூன்றாம் தரப்பு பரிமாற்றம் தொகுதி SIP முகவரியை அல்ல, ஒரு தொலைபேசி எண்ணை அழைக்கிறது; மேலும் பிற வழங்குநர்களின் Five9 ஒருங்கிணைப்புகள் கடவுச்சொல்லுக்குப் பதிலாக மூல முகவரி மூலம் Five9-ஐ அங்கீகரிக்கின்றன. எனவே, Five9 அழைக்கும் எண்ணை அழைப்பு-உள் எண்ணாகக் கொண்டு ஒரு `ip_allowlist` இறுதிப்புள்ளியை உருவாக்குங்கள் ([தொலைபேசி எண்ணை அழைக்கும் தளங்கள்](/ta/guides/sip-addresses) என்பதைப் பார்க்கவும்):

```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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: Five9-இலிருந்து பெறப்படும், உங்கள் Five9 தரவு மையங்களின் SIP சிக்னலிங் வரம்புகள். ஒவ்வொன்றும் `/16` அல்லது அதைவிடக் குறுகிய பொதுவான IPv4 வரம்பாக இருக்க வேண்டும் (IPv6-க்கு `/48` அல்லது அதைவிடக் குறுகியது).
- `dial_in_numbers`: Five9-இன் ஸ்கிரிப்ட் அழைக்கும் எண், Five9 அனுப்பும் வடிவிலேயே எழுதப்பட வேண்டும். இது உண்மையான தொலைபேசி எண்ணாக இருக்க வேண்டியதில்லை. ThunderPhone-இல் தொலைபேசி எண்ணாகவோ மற்றொரு இறுதிப்புள்ளியிலோ இது ஏற்கனவே பயன்பாட்டில் இருக்கக் கூடாது: அப்படியானால் `409` திரும்பும்.

Five9-இன் முகவரிகள் அதன் அனைத்து வாடிக்கையாளர்களுக்கும் பகிரப்பட்டவை; எனவே எண்ணை அழைக்கும் வேறு எந்த Five9 வாடிக்கையாளரும் உங்கள் ஏஜென்ட்டை அடைவார். எண்ணைத் தேர்ந்தெடுக்கும்போது, யாரும் ஊகிக்க முடியாத நீளமான ஒன்றைத் தேர்ந்தெடுக்கவும் (அதிகபட்சம் 15 இலக்கங்கள்), Five9 அதை தொலைபேசி நெட்வொர்க்கிற்கு வெளியே அனுப்பாமல் ThunderPhone-க்கு அனுப்புவதை உறுதிப்படுத்தவும், அதை வெளியிட வேண்டாம்.

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

Five9-இன் செயல்படுத்தல் குழுவிடம் பின்வருவனவற்றைக் கேளுங்கள்:

- **மூன்றாம் தரப்பு பரிமாற்றம்** தொகுதியிலிருந்து அழைப்பை `sip:+14155550188@sip.thunderphone.com`-க்கு அனுப்ப வேண்டும்; கோரிக்கை URI மற்றும் `To` தலைப்பு இரண்டிலும் எண் இருக்க வேண்டும். தொகுதி, வழங்குநரின் SIP டொமைனுடன் தலைப்பில் உள்ள எண்ணைப் பயன்படுத்துகிறது.
- TLS (போர்ட் 5061) அல்லது TCP (போர்ட் 5060) வழியாக அனுப்ப வேண்டும். இறுதிப்புள்ளி UDP-ஐ நிராகரிக்கிறது; Five9 தான் பயன்படுத்தும் பரிமாற்ற முறையை வெளியிடுவதில்லை, எனவே அது UDP அல்ல என்பதை உறுதிப்படுத்தவும்.
- ஏஜென்ட் அழைப்பை முடிக்கும்போது ஸ்கிரிப்ட் தொடர்வதற்காக **மூன்றாம் தரப்பு அழைப்புக்குப் பிறகு திரும்புக** என்பதை இயக்க வேண்டும் (Five9 மூன்றாம் தரப்பு அழைப்பில் அதிகபட்சம் 3,600 வினாடிகளை அனுமதிக்கிறது).

Five9-இன் வழிகாட்டி அது அனுப்பும் மதிப்புகளை (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` மற்றும் பிறவற்றை) பட்டியலிடுகிறது; அவற்றின் தலைப்புப் பெயர்களை அல்ல. பிற AI வழங்குநர்களின் Five9 ஒருங்கிணைப்புகள், அவற்றை இணைப்பில் `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
மற்றும் `X-AgentID` என ஆவணப்படுத்துகின்றன; உங்கள் முதல் சோதனை அழைப்பில் அவற்றைச் சரிபார்க்கவும். ஒவ்வொன்றும் `{{sip_x_callcampaign}}` போன்ற ஒரு மாறியாக prompt-ஐ அடைகிறது. `X-CallID` அழைப்பின் `external_call_id` ஆகச் சேமிக்கப்படுகிறது.

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

ஏஜென்ட் அழைப்பைத் திருப்புகிறது: அது விடைபெற்று அழைப்பை முடிக்கிறது, மேலும் `BYE`, Five9-ன் ஸ்கிரிப்ட் படிக்கும்
நான்கு ஹெடர்களைக் கொண்டுள்ளது. இந்த டிரான்ஸ்ஃபர் எண்ணைச் சேர்க்கவும் (பார்க்கவும்
[டிரான்ஸ்ஃபர் எண்ணைச் சேர்க்கவும்](/ta/guides/contact-centers/overview)):

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` மற்றும் `X-RouteValue` அழைப்பாளரை எங்கு அனுப்ப வேண்டும் என்பதை ஸ்கிரிப்ட்டிடம் தெரிவிக்கின்றன,
  இங்கு அது Support திறன். `X-RouteType`-க்கு மற்ற வழங்குநர்கள் ஆவணப்படுத்தும் மதிப்புகளில்
  `SkillTransfer`, `PhoneTransfer`, `Hangup` மற்றும் `DispositionOnly` ஆகியவை அடங்கும்; இந்த
  மதிப்புகளை ஸ்கிரிப்டைப் பராமரிப்பவருடன் ஒப்புக்கொள்ளவும். பல இலக்குகளுக்கு, ஒவ்வொரு இலக்கிற்கும்
  வேறுபட்ட பெயர் மற்றும் `X-RouteValue` உடன் ஒரு return-ஐச் சேர்க்கவும்.
- `X-RouteReason`, `billing_dispute` போன்ற ஏஜென்ட்டின் நோக்க லேபிளைக் கொண்டுள்ளது.
- `X-CustomMetaData`, ஒப்படைப்பு id-ஐக் கொண்டுள்ளது. `BYE` இதை
  `X-TP-Handoff-Id` ஆகவும் கொண்டுள்ளது; இதை Five9 படிப்பதில்லை.

Five9-ன் ஸ்கிரிப்ட் இந்த நான்கு ஹெடர்களை அழைப்பு மாறிகளாக மேப் செய்கிறது. ஏஜென்ட்டின்
சுருக்கத்திற்காக, IVR **வினவல்** மாட்யூலைப் பயன்படுத்தி ஒப்படைப்பு தேடலை ஸ்கிரிப்ட் அழைக்கச் செய்யவும்:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` என்பதற்குப் பின்
`call.call_id`, மேலும் `Authorization: Bearer` மற்றும் உங்கள் API விசையை அனுப்பும்
Authorization Profile உடன். பார்க்கவும்
[ஒப்படைக்கப்பட்ட அழைப்பைத் தேடுக](/api-reference/calls#look-up-a-handed-off-call).

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

IVR ஸ்கிரிப்ட்டிற்கு அழைக்கவும், ஏஜென்ட்டிடம் ஒரு நபருடன் பேசக் கேட்கவும், அழைப்பு மாறிகள் நிரப்பப்பட்ட நிலையில்
ஸ்கிரிப்ட் அழைப்பாளரை வழிமாற்றுவதைச் சரிபார்க்கவும். அழைப்பு ஏஜென்ட்டை ஒருபோதும் அடையவில்லை என்றால்,
request URI மற்றும் `To` ஹெடரில் உள்ள எண் டயல்-இன் எண்ணுடன் பொருந்துகிறதா, Five9-ன் மூல முகவரி
`allowed_source_cidrs`-இல் உள்ளதா, மற்றும் அழைப்பு TCP அல்லது TLS வழியாக வந்ததா என்பதைச் சரிபார்க்கவும்.
பிறகு `GET /v1/calls/{call_id}` மூலம் அழைப்பைத் திறக்கவும்: `sip_headers`, `x-callid`-ஐப் பட்டியலிட வேண்டும்,
மேலும் `external_call_id`, Five9-இல் உள்ள `call.call_id`-உடன் பொருந்த வேண்டும்.

## வரம்புகள்

- Five9-ன் வழிகாட்டி `BYE`-இல் வழிமாற்றத் தரவை ஆவணப்படுத்துகிறது; `REFER`-ஐ ஏற்றுக்கொள்வதைக் குறிப்பிடவில்லை,
  எனவே மீண்டும் ஒப்படைப்பது ஸ்கிரிப்ட் செய்யும் cold transfer ஆகும்.
- Five9, `User-to-User` அல்லாமல் `X-RouteType`, `X-RouteValue`, `X-RouteReason` மற்றும்
  `X-CustomMetaData` ஆகியவற்றைப் படிக்கிறது. ThunderPhone ஒவ்வொரு ஹெடர் மதிப்பையும் அதிகபட்சம்
  256 பைட் நீளத்தில் அனுப்புகிறது.
- பாக்கெட் துண்டாக்கலைத் தவிர்க்க, தனிப்பயன் ஹெடர்களை சுமார் பத்தாக வைத்திருக்க Five9 பரிந்துரைக்கிறது.
