Open in
Genesys Cloud இலிருந்து இணைக்கவும்
உரையாடல் id மற்றும் UUI உடன் BYOC Cloud trunk வழியாக Genesys Cloud அழைப்புகளை ThunderPhone ஏஜென்ட்டுக்கு அனுப்பி, UUI-யில் hand-off உடன் அவற்றை மீண்டும் பெறுங்கள்.
உங்கள் Architect ஃப்ளோ, நீங்கள் அமைக்கும் உரையாடல் ஐடி மற்றும் எந்த UUI-யுடனும், அழைப்பாளரை BYOC Cloud டிரங்க் வழியாக ஏஜென்ட்டுக்கு அனுப்புகிறது. அழைப்பாளருக்கு ஒரு நபர் தேவைப்படும்போது, ஏஜென்ட் ஒரு SIP REFER அனுப்புகிறது, Genesys அழைப்பைத் திரும்பப் பெறுகிறது, மேலும் கையளிப்பு ஐடி அழைப்பின் UUI-யில் வருகிறது.
தொடங்குவதற்கு முன்
- ஒரு ThunderPhone ஏஜென்ட் மற்றும் ஒரு அமைப்பு API விசை.
- BYOC Cloud கொண்ட Genesys Cloud மற்றும் பின்வரும் அமைப்புகள் இயக்கப்பட்ட வெளிப்புற டிரங்க் (வகை BYOC Carrier அல்லது PBX)
(வெளிப்புற டிரங்க் அமைப்புகள்):
- உரையாடல் ஹெடர்கள், இதனால் Genesys தனது உரையாடல் ஐடியை
x-inin-cnv-இல் அனுப்பும். இது இயல்பாக முடக்கப்பட்டிருக்கும். - ஹெடர் வகை
User-To-Userமற்றும் ஹெக்ஸ் குறியாக்கத்துடன் UUI கடத்தல். - ஏஜென்ட்டின்
REFER-ஐ Genesys ஏற்கும் வகையில் திரும்பப் பெறுதல் மற்றும் மாற்றல்.
- உரையாடல் ஹெடர்கள், இதனால் Genesys தனது உரையாடல் ஐடியை
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 தரவை அமை செயலைச் சேர்க்கவும். 128 அல்லது அதற்குக் குறைவான எழுத்துகளைப் பயன்படுத்த Genesys பரிந்துரைக்கிறது. - எண்ட்பாயிண்ட்டின்
sip_uri-யுடன், உதாரணமாகsip:agent-12-jhxmginwjx@sip.thunderphone.com, ஒரு எண்ணுக்கு மாற்று செயலைச் சேர்க்கவும்.
Genesys உரையாடல் ஐடியை x-inin-cnv-இல் அனுப்புகிறது. ThunderPhone அதை அழைப்பின் external_call_id ஆகச் சேமிக்கிறது. UUI, டிகோட் செய்யப்பட்ட நிலையில், {{sip_uui}} ஆக prompt-ஐ அடைகிறது.
டிரங்க் தனிப்பயன் ஹெடர்கள் Genesys-இல் நிலையானவை; எனவே ஒவ்வொரு அழைப்பிற்குமான மதிப்புகளை UUI-யில் வைக்கவும். x-inin, x-genesys, x-pcv, மற்றும் x-gcv ஹெடர் முன்னொட்டுகளை Genesys தனக்காக ஒதுக்கியுள்ளது.
3. அழைப்பைத் திரும்பப் பெறவும்
ஏஜென்ட், அந்த முகவரிக்குள் ஹெக்ஸ் UUI ஆக கையளிப்பு ஐடியுடன், Genesys-இலுள்ள ஒரு முகவரிக்கு REFER மூலம் மாற்றுகிறது. இந்த மாற்றல் எண்ணைச் சேர்க்கவும் (மாற்றல் எண்ணைச் சேர்க்கவும்
மற்றும் மாற்றல் முகவரிக்குள் உள்ள ஹெடர்கள் என்பவற்றைப் பார்க்கவும்):
{
"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 ஆவணப்படுத்துகிறது; திரும்பப் பெறுதலுக்காக இதை ஆவணப்படுத்தவில்லை. எனவே, அழைப்பாளரைப் பெறும் ஃப்ளோ அங்கு கையளிப்பு ஐடியைக் கண்டுபிடிக்கிறதா என்பதை Genesys-உடன் அல்லது ஒரு சோதனை அழைப்பில் உறுதிப்படுத்தவும். சுருக்கம் மற்றும் இன்டெண்ட்டைப் பெற, Web Services Data Actions ஒருங்கிணைப்பில் ஒரு அழைப்பு தரவு செயல் மூலம் கையளிப்பு தேடலை அழைக்கவும்:
- கோரிக்கை:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=என்பதைத் தொடர்ந்துCall.UUIData-இலுள்ள ஐடி. - நற்சான்றுகள்:
Authorization: Bearer sk_live_…ஆக அனுப்பப்படும் உங்கள் API விசை. - வெளியீடு:
handoff.summaryமற்றும்handoff.intentஆகியவற்றை ஃப்ளோ மாறிகளுக்கு மேப் செய்யவும்.
கையளிக்கப்பட்ட அழைப்பைத் தேடவும் என்பதைப் பார்க்கவும்.
சோதிக்கவும்
ஃப்ளோவை அடையும் எண்ணுக்கு அழைக்கவும், ஏஜென்டிடம் ஒரு நபரை கேட்கவும், பின்னர் நீங்கள் அமைத்த முகவரிக்கு Genesys அழைப்பை எடுத்துச் செல்கிறதா என்பதைச் சரிபார்க்கவும். அந்த ஃப்ளோவில், Call.UUIData ஹேண்ட்-ஆஃப் id-ஐ உரையாக வைத்திருக்கிறதா என்பதைச் சரிபார்க்கவும் (அது hex இலக்கங்களைக் காட்டினால், டிரங்கின் UUI குறியாக்கம் Hex ஆக உள்ளதா என்பதைச் சரிபார்க்கவும்). பின்னர் GET /v1/calls/{call_id} மூலம் அழைப்பைத் திறக்கவும்:
external_call_id உரையாடல் id ஆக இருக்க வேண்டும்.
வரம்புகள்
- SIP தலைப்புகளைப் பெறு செயல் ஆரம்ப
INVITE-ஐ மட்டும் படிக்கும்; எனவே ஏஜென்டின்REFER-இலிருந்து எதையும் படிக்க முடியாது. ஹேண்ட்-ஆஃப் UUI மூலம் மட்டுமே Genesys-ஐ அடையும். - ஒரு அழைப்பில் ஒன்றுக்கு மேற்பட்ட UUI தலைப்புகள் இருந்தால் Genesys அனைத்து UUI-யையும் நீக்கிவிடும்.
- பரிமாற்ற முகவரி 254 எழுத்துகளுக்கு மட்டுமே வைக்கப்படுகிறது; எனவே நீண்ட UUI பொருந்தும் வகையில் வெட்டப்படும். ஹேண்ட்-ஆஃப் id எப்போதும் பொருந்தும்.