Open in
Five9 నుండి కనెక్ట్ చేయండి
AI Agent Connect ద్వారా SIP పై Five9 కాల్లను ThunderPhone ఏజెంట్కు పంపండి మరియు మీ IVR స్క్రిప్ట్ చదివే రూటింగ్ హెడర్లతో వాటిని తిరిగి పొందండి.
మీ Five9 IVR స్క్రిప్ట్ Five9 కాల్ వివరాలతో కాలర్ను ఏజెంట్కు పంపుతుంది.
ఏజెంట్ పూర్తయినప్పుడు, అది SIP BYEలో రూటింగ్ హెడర్లతో కాల్ను ముగిస్తుంది,
వాటిని స్క్రిప్ట్ కాలర్ను రూట్ చేయడానికి కాల్ వేరియబుల్లలోకి చదువుతుంది.
ప్రారంభించే ముందు
- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ API కీ.
- Five9 యొక్క AI ఏజెంట్ కనెక్ట్ యాడ్-ఆన్. Five9 దీనిని తాను ఆమోదించిన AI ప్రొవైడర్లకే పరిమితం చేస్తుంది, మరియు Five9 అమలు బృందం దీన్ని సెటప్ చేస్తుంది: అది ప్రొవైడర్ IVR స్క్రిప్ట్ టెంప్లేట్ను దిగుమతి చేస్తుంది, కాల్ వేరియబుల్లను సృష్టిస్తుంది మరియు స్క్రిప్ట్లోని థర్డ్ పార్టీ ట్రాన్స్ఫర్ మాడ్యూల్ను ప్రొవైడర్కు సూచించేలా చేస్తుంది. ThunderPhone ఇంకా Five9 ఆమోదించిన జాబితాలో లేదు: దీని ఆధారంగా ప్రణాళిక రూపొందించే ముందు మీ Five9 ఖాతా బృందాన్ని లేదా ThunderPhone సపోర్ట్ను అడగండి.
1. SIP ఎండ్పాయింట్ను సృష్టించండి
Five9 థర్డ్ పార్టీ ట్రాన్స్ఫర్ మాడ్యూల్ SIP చిరునామాను కాకుండా ఫోన్ నంబర్ను డయల్
చేస్తుంది, మరియు ఇతర ప్రొవైడర్ల Five9 ఇంటిగ్రేషన్లు పాస్వర్డ్కు బదులుగా మూల
చిరునామా ద్వారా Five9ను ప్రామాణీకరిస్తాయి. కాబట్టి Five9 డయల్ చేసే నంబర్ను డయల్-ఇన్
నంబర్గా ఉంచి ip_allowlist ఎండ్పాయింట్ను సృష్టించండి (చూడండి
ఫోన్ నంబర్ను డయల్ చేసే ప్లాట్ఫారమ్లు):
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 స్క్రిప్ట్ చదివే నాలుగు హెడర్లు ఉంటాయి. ఈ ట్రాన్స్ఫర్ నంబర్ను జోడించండి (చూడండి
ట్రాన్స్ఫర్ నంబర్ను జోడించండి):
{
"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 కీని పంపే ఆథరైజేషన్ ప్రొఫైల్తో. చూడండి
హ్యాండ్-ఆఫ్ చేసిన కాల్ను కనుగొనండి.
దీన్ని పరీక్షించండి
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 సిఫార్సు చేస్తుంది.