Open in
Genesys Cloud నుండి కనెక్ట్ చేయండి
సంభాషణ ID మరియు UUIతో కూడిన Genesys Cloud కాల్లను BYOC Cloud ట్రంక్ ద్వారా ThunderPhone ఏజెంట్కు పంపి, UUIలోని హ్యాండ్-ఆఫ్తో వాటిని తిరిగి తీసుకురండి.
మీ Architect ఫ్లో కాలర్ను సంభాషణ ID మరియు మీరు సెట్ చేసిన ఏదైనా UUIతో పాటు BYOC Cloud ట్రంక్ ద్వారా ఏజెంట్కు పంపుతుంది. కాలర్కు వ్యక్తి అవసరమైనప్పుడు, ఏజెంట్ SIP REFERను పంపుతుంది, Genesys కాల్ను తిరిగి తీసుకుంటుంది, మరియు హ్యాండ్-ఆఫ్ ID కాల్ యొక్క UUIలో చేరుతుంది.
ప్రారంభించడానికి ముందు
- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ API కీ.
- BYOC Cloudతో కూడిన Genesys Cloud, మరియు ఈ సెట్టింగ్లు ఆన్ చేసి ఉన్న బాహ్య ట్రంక్ (రకం BYOC Carrier లేదా PBX)
(బాహ్య ట్రంక్ సెట్టింగ్లు):
- సంభాషణ హెడర్లు, తద్వారా Genesys తన సంభాషణ IDని
x-inin-cnvలో పంపుతుంది. ఇది డిఫాల్ట్గా ఆఫ్లో ఉంటుంది. - హెడర్ రకం
User-To-Userమరియు ఎన్కోడింగ్ Hexతో UUI పాస్త్రూ. - తిరిగి తీసుకోవడం మరియు బదిలీ, తద్వారా Genesys ఏజెంట్ యొక్క
REFERను అంగీకరిస్తుంది.
- సంభాషణ హెడర్లు, తద్వారా Genesys తన సంభాషణ IDని
1. SIP ఎండ్పాయింట్ను సృష్టించండి
Genesys డైజెస్ట్ ఛాలెంజ్కు సమాధానం ఇస్తుంది, కాబట్టి ప్రామాణిక ఎండ్పాయింట్ను ఉపయోగించండి:
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": "Genesys Cloud"}'ప్రతిస్పందనలోని passwordను వెంటనే నిల్వ చేయండి; అది ఒకసారి మాత్రమే చూపబడుతుంది. ట్రంక్లో:
| సెట్టింగ్ | విలువ |
|---|---|
| SIP సర్వర్ | sip.thunderphone.com, పోర్ట్ 5061 |
| ప్రోటోకాల్ | TLS |
| డైజెస్ట్ ప్రామాణీకరణ | ఎండ్పాయింట్ యొక్క username మరియు password |
| కోడెక్లు | PCMU, PCMA లేదా G.722 |
ఫ్లో డయల్ చేసే చిరునామాను కవర్ చేసే నంబర్ ప్లాన్ ఉన్న మీ సైట్ అవుట్బౌండ్ రూట్లో ట్రంక్ను ఉంచండి.
2. సందర్భంతో కాల్లను పంపండి
మీ Architect ఫ్లోలో:
- ఐచ్ఛికంగా,
account=12345వంటి ఏజెంట్ కోసం సందర్భంతో UUI డేటాను సెట్ చేయండి చర్యను జోడించండి. Genesys 128 అక్షరాలు లేదా అంతకంటే తక్కువ ఉండాలని సిఫార్సు చేస్తుంది. - ఉదాహరణకు
sip:agent-12-jhxmginwjx@sip.thunderphone.comవంటి ఎండ్పాయింట్ యొక్కsip_uriతో నంబర్కు బదిలీ చేయండి చర్యను జోడించండి.
Genesys సంభాషణ IDని x-inin-cnvలో పంపుతుంది. ThunderPhone దాన్ని కాల్ యొక్క external_call_idగా నిల్వ చేస్తుంది. UUI డీకోడ్ చేయబడి, {{sip_uui}}గా promptకు చేరుతుంది.
ట్రంక్ కస్టమ్ హెడర్లు Genesysలో స్థిరంగా ఉంటాయి, కాబట్టి ప్రతి-కాల్ విలువలను UUIలో ఉంచండి. Genesys తన కోసం x-inin, x-genesys, x-pcv మరియు x-gcv హెడర్ ఉపసర్గలను కేటాయించుకుంటుంది.
3. కాల్ను తిరిగి పొందండి
ఏజెంట్ Genesysలోని చిరునామాకు REFERతో బదిలీ చేస్తుంది, ఆ చిరునామాలో హ్యాండ్-ఆఫ్ ID hex UUIగా ఉంటుంది. ఈ బదిలీ నంబర్ను జోడించండి (బదిలీ నంబర్ను జోడించండి
మరియు బదిలీ చిరునామాలోని హెడర్లు చూడండి):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}కాలర్ను స్వీకరించాల్సిన క్యూ లేదా ఫ్లోకు తిరిగి రూట్ చేసే చిరునామాతో ఈ చిరునామాను భర్తీ చేయండి; దాని రూపాన్ని Genesysతో నిర్ధారించండి. REFER ఇలా కనిపిస్తుంది:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
తిరిగి తీసుకోవడం మరియు బదిలీ ఆన్లో ఉన్నప్పుడు, Genesys ట్రంక్ నుండి కాల్ను తిరిగి తీసుకుని ఆ చిరునామాకు రూట్ చేస్తుంది. ఇన్కమింగ్ UUI Call.UUIDataలో చేరుతుందని Genesys డాక్యుమెంట్ చేస్తుంది; తిరిగి తీసుకునే సందర్భంలో దీన్ని డాక్యుమెంట్ చేయదు, కాబట్టి కాలర్ను స్వీకరించే ఫ్లో అక్కడ హ్యాండ్-ఆఫ్ IDని కనుగొంటుందో లేదో Genesysతో లేదా పరీక్షా కాల్లో నిర్ధారించండి. సారాంశం మరియు ఉద్దేశాన్ని పొందడానికి, వెబ్ సర్వీసెస్ డేటా చర్యల ఇంటిగ్రేషన్లో కాల్ డేటా చర్యతో హ్యాండ్-ఆఫ్ లుకప్ను కాల్ చేయండి:
- అభ్యర్థన:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=తరువాతCall.UUIDataనుండి ID. - క్రెడెన్షియల్లు:
Authorization: Bearer sk_live_…గా పంపబడే మీ API కీ. - అవుట్పుట్:
handoff.summaryమరియుhandoff.intentను ఫ్లో వేరియబుల్లకు మ్యాప్ చేయండి.
హ్యాండ్-ఆఫ్ చేయబడిన కాల్ను చూడండి.
పరీక్షించండి
ఫ్లోకు చేరుకునే నంబర్కు కాల్ చేసి, ఏజెంట్ను ఒక వ్యక్తి కోసం అడగండి మరియు మీరు సెట్ చేసిన అడ్రస్కు Genesys కాల్ను తీసుకెళ్తోందో లేదో తనిఖీ చేయండి. ఆ ఫ్లోలో, Call.UUIData హ్యాండ్-ఆఫ్ idని టెక్స్ట్గా కలిగి ఉందో చూడండి (అది హెక్స్ అంకెలను చూపితే, ట్రంక్ యొక్క UUI ఎన్కోడింగ్ Hexగా ఉందో తనిఖీ చేయండి). ఆపై GET /v1/calls/{call_id}తో కాల్ను తెరవండి:
external_call_id సంభాషణ id అయి ఉండాలి.
పరిమితులు
- Get SIP Headers చర్య ప్రారంభ
INVITEను మాత్రమే చదువుతుంది, కాబట్టి ఏజెంట్ యొక్కREFERనుండి ఏదీ చదవలేదు. హ్యాండ్-ఆఫ్ UUI ద్వారా మాత్రమే Genesysకు చేరుతుంది. - ఒక కాల్లో ఒకటి కంటే ఎక్కువ UUI హెడర్లు ఉన్నప్పుడు Genesys అన్ని UUIలను తొలగిస్తుంది.
- బదిలీ అడ్రస్ను 254 అక్షరాలకు పరిమితం చేస్తారు, కాబట్టి పొడవైన UUI సరిపోవడానికి కత్తిరించబడుతుంది. హ్యాండ్-ఆఫ్ id ఎల్లప్పుడూ సరిపోతుంది.