Open in
Genesys Cloud-ൽ നിന്ന് കണക്റ്റ് ചെയ്യുക
conversation id, UUI എന്നിവ ഉപയോഗിച്ച് BYOC Cloud ട്രങ്കിലൂടെ Genesys Cloud കോളുകൾ ഒരു ThunderPhone ഏജന്റിലേക്ക് അയയ്ക്കുക. hand-off UUI-യിൽ ഉൾപ്പെടുത്തി അവ തിരിച്ചെടുക്കുക.
നിങ്ങളുടെ Architect ഫ്ലോ, നിങ്ങൾ സജ്ജമാക്കുന്ന conversation id യും ഏതെങ്കിലും UUI യും സഹിതം, ഒരു BYOC Cloud ട്രങ്കിലൂടെ കോളറെ ഏജന്റിലേക്ക് അയയ്ക്കുന്നു. കോളർക്ക് ഒരു വ്യക്തിയുമായി സംസാരിക്കേണ്ടിവരുമ്പോൾ, ഏജന്റ് ഒരു SIP REFER അയയ്ക്കുന്നു, Genesys കോൾ തിരികെ എടുക്കുന്നു, കൈമാറ്റ ഐഡി കോളിന്റെ UUI-യിൽ എത്തുന്നു.
ആരംഭിക്കുന്നതിന് മുമ്പ്
- ഒരു ThunderPhone ഏജന്റും ഒരു ഓർഗനൈസേഷൻ API കീയും.
- BYOC Cloud ഉള്ള Genesys Cloud, കൂടാതെ ഈ ക്രമീകരണങ്ങൾ ഓണാക്കിയിട്ടുള്ള ഒരു ബാഹ്യ ട്രങ്ക് (തരം BYOC Carrier അല്ലെങ്കിൽ PBX)
(ബാഹ്യ ട്രങ്ക് ക്രമീകരണങ്ങൾ):
- Conversation Headers, അതുവഴി Genesys അതിന്റെ conversation id
x-inin-cnv-ൽ അയയ്ക്കും. ഇത് ഡിഫോൾട്ടായി ഓഫാണ്. User-To-Userഎന്ന ഹെഡർ തരവും ഹെക്സ് എൻകോഡിംഗും ഉള്ള UUI Passthrough.- ഏജന്റിന്റെ
REFERGenesys സ്വീകരിക്കുന്നതിനായി Take Back and Transfer.
- Conversation Headers, അതുവഴി Genesys അതിന്റെ conversation 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 ഫ്ലോയിൽ:
- ഐച്ഛികമായി, ഏജന്റിനായുള്ള സന്ദർഭത്തോടൊപ്പം ഒരു UUI ഡാറ്റ സജ്ജമാക്കുക ആക്ഷൻ ചേർക്കുക, ഉദാഹരണത്തിന്
account=12345. 128 അക്ഷരങ്ങളോ അതിൽ കുറവോ ഉപയോഗിക്കാൻ Genesys ശുപാർശ ചെയ്യുന്നു. - എൻഡ്പോയിന്റിന്റെ
sip_uriഉപയോഗിച്ച് ഒരു നമ്പറിലേക്ക് ട്രാൻസ്ഫർ ചെയ്യുക ആക്ഷൻ ചേർക്കുക, ഉദാഹരണത്തിന്sip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys conversation id x-inin-cnv-ൽ അയയ്ക്കുന്നു. ThunderPhone അത് കോളിന്റെ external_call_id ആയി സംഭരിക്കുന്നു. UUI ഡീകോഡ് ചെയ്ത നിലയിൽ {{sip_uui}} ആയി prompt-ലെത്തും.
ട്രങ്ക് കസ്റ്റം ഹെഡറുകൾ Genesys-ൽ സ്റ്റാറ്റിക്കാണ്, അതിനാൽ ഓരോ കോളിലുമുള്ള മൂല്യങ്ങൾ UUI-യിൽ ചേർക്കുക. x-inin, x-genesys, x-pcv, x-gcv എന്നീ ഹെഡർ പ്രിഫിക്സുകൾ Genesys അതിനായി സംവരണം ചെയ്തിരിക്കുന്നു.
3. കോൾ തിരികെ നേടുക
ഏജന്റ് Genesys-ലെ ഒരു വിലാസത്തിലേക്ക് REFER ഉപയോഗിച്ച് ട്രാൻസ്ഫർ ചെയ്യുന്നു; ആ വിലാസത്തിനുള്ളിൽ ഹെക്സ് 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>
Take Back and Transfer ഓണായിരിക്കുമ്പോൾ, 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 കൈമാറ്റ ഐഡി ടെക്സ്റ്റായി സൂക്ഷിക്കുന്നുണ്ടെന്ന് പരിശോധിക്കുക (അതിൽ ഹെക്സ് അക്കങ്ങൾ കാണുന്നുവെങ്കിൽ, ട്രങ്കിന്റെ UUI എൻകോഡിംഗ് Hex ആണെന്ന് പരിശോധിക്കുക). തുടർന്ന് GET /v1/calls/{call_id} ഉപയോഗിച്ച് കോൾ തുറക്കുക:
external_call_id സംഭാഷണ ഐഡി ആയിരിക്കണം.
പരിധികൾ
- SIP ഹെഡറുകൾ നേടുക പ്രവർത്തനം പ്രാരംഭ
INVITEമാത്രമേ വായിക്കൂ, അതിനാൽ ഏജന്റിന്റെREFER-ൽ നിന്ന് അതിന് ഒന്നും വായിക്കാൻ കഴിയില്ല. UUI വഴിയിലൂടെ മാത്രമാണ് കൈമാറ്റം Genesys-ലേക്ക് എത്തുന്നത്. - ഒരു കോളിൽ ഒന്നിലധികം UUI ഹെഡറുകൾ ഉണ്ടെങ്കിൽ Genesys എല്ലാ UUI-യും ഒഴിവാക്കും.
- കൈമാറ്റ വിലാസം 254 പ്രതീകങ്ങളായി പരിമിതപ്പെടുത്തിയിരിക്കുന്നു, അതിനാൽ ദൈർഘ്യമേറിയ UUI അനുയോജ്യമാക്കാൻ വെട്ടിച്ചുരുക്കപ്പെടും. ഒരു കൈമാറ്റ ഐഡി എപ്പോഴും ഉൾക്കൊള്ളും.