ThunderPhone v3 లైవ్‌లోకి వచ్చింది.మీరే ప్రారంభించవచ్చు—నిమిషానికి 2¢ నుంచి.ప్రకటనను చదవండి

Contact centers

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ను అంగీకరిస్తుంది.

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 ఫ్లోలో:

  1. ఐచ్ఛికంగా, account=12345 వంటి ఏజెంట్ కోసం సందర్భంతో UUI డేటాను సెట్ చేయండి చర్యను జోడించండి. Genesys 128 అక్షరాలు లేదా అంతకంటే తక్కువ ఉండాలని సిఫార్సు చేస్తుంది.
  2. ఉదాహరణకు 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 ఎల్లప్పుడూ సరిపోతుంది.