---
title: "Five9-ൽ നിന്ന് കണക്റ്റ് ചെയ്യുക"
description: "AI Agent Connect ഉപയോഗിച്ച് Five9 കോളുകൾ SIP വഴി ഒരു ThunderPhone ഏജന്റിലേക്ക് അയയ്ക്കുക. തുടർന്ന് നിങ്ങളുടെ IVR സ്ക്രിപ്റ്റ് വായിക്കുന്ന റൂട്ടിംഗ് ഹെഡറുകളോടെ അവ തിരികെ ലഭിക്കും."
---

നിങ്ങളുടെ Five9 IVR സ്ക്രിപ്റ്റ് Five9-ന്റെ കോൾ വിശദാംശങ്ങളോടെ കോളറെ ഏജന്റിലേക്ക് അയയ്ക്കുന്നു. ഏജന്റ് പൂർത്തിയാകുമ്പോൾ, SIP `BYE`-യിൽ റൂട്ടിംഗ് ഹെഡറുകളോടെ കോൾ അവസാനിപ്പിക്കുന്നു; കോളറെ റൂട്ട് ചെയ്യുന്നതിനായി സ്ക്രിപ്റ്റ് അവ കോൾ വേരിയബിളുകളിലേക്ക് വായിക്കുന്നു.

## ആരംഭിക്കുന്നതിന് മുമ്പ്

- ഒരു ThunderPhone ഏജന്റും ഒരു ഓർഗനൈസേഷൻ [API കീ](/ml/guides/api-keys)യും.
- Five9-ന്റെ **AI ഏജന്റ് കണക്റ്റ്** ആഡ്-ഓൺ. Five9 അംഗീകാരം നൽകിയിട്ടുള്ള AI ദാതാക്കൾക്ക് മാത്രമായി ഇത് പരിമിതപ്പെടുത്തുന്നു, കൂടാതെ Five9-ന്റെ ഇംപ്ലിമെന്റേഷൻ ടീം ഇത് സജ്ജീകരിക്കുന്നു: ദാതാവിന്റെ IVR സ്ക്രിപ്റ്റ് ടെംപ്ലേറ്റ് ഇംപോർട്ട് ചെയ്യുകയും, കോൾ വേരിയബിളുകൾ സൃഷ്ടിക്കുകയും, സ്ക്രിപ്റ്റിന്റെ **മൂന്നാം കക്ഷി ട്രാൻസ്ഫർ** മോഡ്യൂളിനെ ദാതാവിലേക്ക് ചൂണ്ടിക്കാണിക്കുകയും ചെയ്യുന്നു. ThunderPhone ഇതുവരെ Five9-ന്റെ അംഗീകൃത പട്ടികയിൽ ഇല്ല: ഇതിനെ അടിസ്ഥാനമാക്കി പദ്ധതിയിടുന്നതിന് മുമ്പ് നിങ്ങളുടെ Five9 അക്കൗണ്ട് ടീമിനോടോ ThunderPhone പിന്തുണയോടോ ചോദിക്കുക.

## 1. SIP എൻഡ്‌പോയിന്റ് സൃഷ്ടിക്കുക

Five9-ന്റെ മൂന്നാം കക്ഷി ട്രാൻസ്ഫർ മോഡ്യൂൾ SIP വിലാസമല്ല, ഒരു ഫോൺ നമ്പറാണ് ഡയൽ ചെയ്യുന്നത്; മറ്റ് ദാതാക്കളുടെ Five9 ഇന്റഗ്രേഷനുകൾ പാസ്‌വേഡിന് പകരം ഉറവിട വിലാസം ഉപയോഗിച്ച് Five9-നെ ഓതന്റിക്കേറ്റ് ചെയ്യുന്നു. അതിനാൽ Five9 ഡയൽ ചെയ്യുന്ന നമ്പർ ഒരു ഡയൽ-ഇൻ നമ്പറായി നൽകി `ip_allowlist` എൻഡ്‌പോയിന്റ് സൃഷ്ടിക്കുക ([ഫോൺ നമ്പർ ഡയൽ ചെയ്യുന്ന പ്ലാറ്റ്‌ഫോമുകൾ](/ml/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-ന്റെ സ്ക്രിപ്റ്റ് വായിക്കുന്ന നാല് ഹെഡറുകൾ വഹിക്കുന്നു. ഈ ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക ([ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക](/ml/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-ന്റെ സ്ക്രിപ്റ്റ് നാല് ഹെഡറുകളെയും കോൾ വേരിയബിളുകളിലേക്ക് മാപ്പ് ചെയ്യുന്നു. ഏജന്റിന്റെ
സംഗ്രഹത്തിനായി, `Authorization: Bearer` ഉം നിങ്ങളുടെ API കീയും അയയ്ക്കുന്ന ഒരു Authorization Profile സഹിതം
IVR **ക്വറി** മൊഡ്യൂൾ ഉപയോഗിച്ച് സ്ക്രിപ്റ്റ് കൈമാറ്റ ലുക്കപ്പ് വിളിക്കണം:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` എന്നതിന് ശേഷം
`call.call_id`. [കൈമാറിയ കോൾ ലുക്കപ്പ് ചെയ്യുക](/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` സ്വീകരിക്കുന്നതിനെക്കുറിച്ച്
  പരാമർശിക്കുന്നില്ല; അതിനാൽ തിരികെ കൈമാറ്റം സ്ക്രിപ്റ്റ് നടത്തുന്ന ഒരു കോൾഡ് ട്രാൻസ്ഫറാണ്.
- Five9, `User-to-User` അല്ല, `X-RouteType`, `X-RouteValue`, `X-RouteReason`,
  `X-CustomMetaData` എന്നിവയാണ് വായിക്കുന്നത്. ThunderPhone ഓരോ ഹെഡർ മൂല്യവും
  പരമാവധി 256 ബൈറ്റുകൾ മാത്രം ദൈർഘ്യമുള്ളതായി അയയ്ക്കുന്നു.
- പാക്കറ്റ് ഫ്രാഗ്മെന്റേഷൻ ഒഴിവാക്കാൻ കസ്റ്റം ഹെഡറുകൾ ഏകദേശം പത്തിൽ നിലനിർത്താൻ Five9 ശുപാർശ ചെയ്യുന്നു.
