---
title: "Five9 నుండి కనెక్ట్ చేయండి"
description: "AI Agent Connect ద్వారా SIP పై Five9 కాల్‌లను ThunderPhone ఏజెంట్‌కు పంపండి మరియు మీ IVR స్క్రిప్ట్ చదివే రూటింగ్ హెడర్‌లతో వాటిని తిరిగి పొందండి."
---

మీ Five9 IVR స్క్రిప్ట్ Five9 కాల్ వివరాలతో కాలర్‌ను ఏజెంట్‌కు పంపుతుంది.
ఏజెంట్ పూర్తయినప్పుడు, అది SIP `BYE`లో రూటింగ్ హెడర్‌లతో కాల్‌ను ముగిస్తుంది,
వాటిని స్క్రిప్ట్ కాలర్‌ను రూట్ చేయడానికి కాల్ వేరియబుల్‌లలోకి చదువుతుంది.

## ప్రారంభించే ముందు

- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ [API కీ](/te/guides/api-keys).
- Five9 యొక్క **AI ఏజెంట్ కనెక్ట్** యాడ్-ఆన్. Five9 దీనిని తాను
  ఆమోదించిన AI ప్రొవైడర్‌లకే పరిమితం చేస్తుంది, మరియు Five9 అమలు బృందం దీన్ని సెటప్
  చేస్తుంది: అది ప్రొవైడర్ IVR స్క్రిప్ట్ టెంప్లేట్‌ను దిగుమతి చేస్తుంది, కాల్
  వేరియబుల్‌లను సృష్టిస్తుంది మరియు స్క్రిప్ట్‌లోని **థర్డ్ పార్టీ ట్రాన్స్‌ఫర్** మాడ్యూల్‌ను
  ప్రొవైడర్‌కు సూచించేలా చేస్తుంది. ThunderPhone ఇంకా Five9 ఆమోదించిన జాబితాలో లేదు:
  దీని ఆధారంగా ప్రణాళిక రూపొందించే ముందు మీ Five9 ఖాతా బృందాన్ని లేదా ThunderPhone
  సపోర్ట్‌ను అడగండి.

## 1. SIP ఎండ్‌పాయింట్‌ను సృష్టించండి

Five9 థర్డ్ పార్టీ ట్రాన్స్‌ఫర్ మాడ్యూల్ SIP చిరునామాను కాకుండా ఫోన్ నంబర్‌ను డయల్
చేస్తుంది, మరియు ఇతర ప్రొవైడర్‌ల Five9 ఇంటిగ్రేషన్‌లు పాస్‌వర్డ్‌కు బదులుగా మూల
చిరునామా ద్వారా Five9ను ప్రామాణీకరిస్తాయి. కాబట్టి Five9 డయల్ చేసే నంబర్‌ను డయల్-ఇన్
నంబర్‌గా ఉంచి `ip_allowlist` ఎండ్‌పాయింట్‌ను సృష్టించండి (చూడండి
[ఫోన్ నంబర్‌ను డయల్ చేసే ప్లాట్‌ఫారమ్‌లు](/te/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 కాదని నిర్ధారించండి.
- **3వ పార్టీ కాల్ తర్వాత తిరిగి వెళ్లండి**ని ప్రారంభించండి, తద్వారా ఏజెంట్ కాల్‌ను
  ముగించినప్పుడు స్క్రిప్ట్ కొనసాగుతుంది (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 స్క్రిప్ట్ చదివే నాలుగు హెడర్‌లు ఉంటాయి. ఈ ట్రాన్స్‌ఫర్ నంబర్‌ను జోడించండి (చూడండి
[ట్రాన్స్‌ఫర్ నంబర్‌ను జోడించండి](/te/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` కాలర్‌ను ఎక్కడికి పంపాలో స్క్రిప్ట్‌కు తెలియజేస్తాయి,
  ఇక్కడ సపోర్ట్ స్కిల్‌కు. ఇతర ప్రొవైడర్‌లు `X-RouteType` కోసం డాక్యుమెంట్ చేసే విలువలలో
  `SkillTransfer`, `PhoneTransfer`, `Hangup` మరియు `DispositionOnly` ఉంటాయి; స్క్రిప్ట్‌ను నిర్వహించే వారితో
  విలువలను నిర్ణయించండి. అనేక గమ్యస్థానాల కోసం, వేర్వేరు పేరు మరియు `X-RouteValue`తో ప్రతి గమ్యస్థానానికి
  ఒక రిటర్న్‌ను జోడించండి.
- `X-RouteReason` ఏజెంట్ ఉద్దేశ్య లేబుల్‌ను కలిగి ఉంటుంది, ఉదాహరణకు `billing_dispute`.
- `X-CustomMetaData` హ్యాండ్-ఆఫ్ ఐడీని కలిగి ఉంటుంది. `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 కీని పంపే ఆథరైజేషన్ ప్రొఫైల్‌తో. చూడండి
[హ్యాండ్-ఆఫ్ చేసిన కాల్‌ను కనుగొనండి](/api-reference/calls#look-up-a-handed-off-call).

## దీన్ని పరీక్షించండి

IVR స్క్రిప్ట్‌కు కాల్ చేసి, ఏజెంట్‌ను ఒక వ్యక్తి కోసం అడగండి, ఆపై కాల్ వేరియబుల్‌లు నింపబడి
స్క్రిప్ట్ కాలర్‌ను రూట్ చేస్తుందో తనిఖీ చేయండి. కాల్ ఏజెంట్‌ను ఎప్పుడూ చేరకపోతే, రిక్వెస్ట్ 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
  సిఫార్సు చేస్తుంది.
