Open in
Zoom Contact Center-ൽ നിന്ന് കണക്റ്റ് ചെയ്യുക
ഒരു മൂന്നാം കക്ഷി വോയ്സ്ബോട്ട് കണക്റ്റർ ഉപയോഗിച്ച് Zoom Contact Center കോളുകൾ ഒരു ThunderPhone ഏജന്റിലേക്ക് അയയ്ക്കുക, SIP REFER ഉപയോഗിച്ച് അവയെ വീണ്ടും ഒരു മനുഷ്യ ഏജന്റിലേക്ക് തിരിച്ചെടുക്കുക.
നിങ്ങളുടെ Zoom Contact Center പ്രവാഹത്തിലെ ഒരു ബോട്ട് വിജറ്റ്, Zoom-ന്റെ കോൾ sid സഹിതം വിളിക്കുന്നയാളെ ഏജന്റിലേക്ക് അയയ്ക്കുന്നു. വിളിക്കുന്നയാൾക്ക് ഒരു മനുഷ്യ പ്രതിനിധിയെ ആവശ്യമാകുമ്പോൾ, ഏജന്റ് Zoom-ന്റെ മനുഷ്യ-ഏജന്റ് വിലാസത്തിലേക്ക് ഒരു SIP REFER അയയ്ക്കുകയും നിങ്ങളുടെ പ്രവാഹം കോൾ sid ഉപയോഗിച്ച് കൈമാറ്റം ലഭ്യമാക്കുകയും ചെയ്യുന്നു.
ആരംഭിക്കുന്നതിന് മുമ്പ്
- ഒരു ThunderPhone ഏജന്റും സ്ഥാപനത്തിന്റെ API കീയും.
- നിങ്ങളുടെ അഡ്മിൻ നിയന്ത്രിക്കുകയും Contact Center-ന് ലഭ്യമാക്കുകയും ചെയ്യുന്ന, ബോട്ട് വിജറ്റിനായുള്ള കണക്റ്ററോടുകൂടിയ ഒരു Zoom Marketplace ജനറൽ ആപ്പ് (Zoom-ന്റെ മൂന്നാം കക്ഷി വോയ്സ്ബോട്ട് മാർഗ്ഗനിർദേശം).
- Zoom-ൽ നിന്ന് ബോട്ട് ദാതാവിലേക്കുള്ള ഒരു SIP ട്രങ്ക്. Zoom-ന്റെ ISV ടീം ഇത് ഘട്ടങ്ങളായി നിർമ്മിക്കുന്നു (കണ്ടെത്തൽ, ഒരു സ്റ്റേജിംഗ് ട്രങ്ക്, തുടർന്ന് പ്രൊഡക്ഷൻ), കൂടാതെ ആപ്പിന്റെ കമ്പനി നാമം ട്രങ്ക് റെക്കോർഡുമായി കൃത്യമായി പൊരുത്തപ്പെടണം. ഈ സജ്ജീകരണം നിങ്ങളുടെ Zoom അക്കൗണ്ടിൽ മാത്രം അല്ലാതെ ThunderPhone പിന്തുണയും Zoom-വും ചേർന്നാണ് ആരംഭിക്കുന്നത്.
1. SIP എൻഡ്പോയിന്റ് സൃഷ്ടിക്കുക
Zoom-ന്റെ കണക്റ്റർ ഒരു SIP വിലാസമല്ല, 999-ൽ ആരംഭിക്കുന്ന 15-അക്ക നമ്പറാണ് ഡയൽ ചെയ്യുന്നത്. കണക്റ്റർ സേവ് ചെയ്യുമ്പോൾ ആ നമ്പർ സൃഷ്ടിക്കപ്പെടുന്നു. Zoom-ന്റെ ട്രങ്ക് പോർട്ട് 5061-ൽ TLS 1.2-ഉം ഓഡിയോയ്ക്കായി SRTP-ഉം ഉപയോഗിക്കുന്നു, പാസ്വേഡിന് പകരം Zoom-ന്റെ സബ്നെറ്റുകൾ ഉപയോഗിച്ച് allowlist ചെയ്യപ്പെടുന്നു. അതിനാൽ കണക്റ്ററിന്റെ നമ്പർ ഡയൽ-ഇൻ നമ്പറായി നൽകി SRTP നിർബന്ധമാക്കിയുള്ള ഒരു 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": "Zoom Contact Center",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["999123456789012"],
"srtp": "required"
}'allowed_source_cidrs: Zoom നൽകുന്ന Zoom-ന്റെ SIP സിഗ്നലിംഗ് സബ്നെറ്റുകൾ. ഓരോന്നും/16അല്ലെങ്കിൽ അതിലും ഇടുങ്ങിയ ഒരു പൊതുവായ IPv4 ശ്രേണിയായിരിക്കണം (IPv6-ന്/48അല്ലെങ്കിൽ അതിലും ഇടുങ്ങിയത്).dial_in_numbers:+ഇല്ലാതെ, Zoom അയയ്ക്കുന്നതുപോലെതന്നെയുള്ള കണക്റ്ററിന്റെ നമ്പർ.srtp: Zoom-ന്റെ ട്രങ്ക് എപ്പോഴും SRTP ഉപയോഗിക്കുന്നതിനാൽrequired.
Zoom-ന്റെ വിലാസങ്ങൾ അതിന്റെ എല്ലാ ഉപഭോക്താക്കളും പങ്കിടുന്നതാണ്, അതിനാൽ നമ്പർ ഡയൽ ചെയ്യുന്ന മറ്റേതെങ്കിലും Zoom ഉപഭോക്താവും നിങ്ങളുടെ ഏജന്റിലെത്തും. Zoom ആണ് നമ്പർ നിയോഗിക്കുന്നത്; അത് പ്രസിദ്ധീകരിക്കരുത്.
2. സന്ദർഭത്തോടൊപ്പം കോളുകൾ അയയ്ക്കുക
നിങ്ങളുടെ പ്രവാഹത്തിലേക്ക് ഒരു ബോട്ട് വിജറ്റ് ചേർത്ത് അത് കണക്റ്ററുമായി ബന്ധിപ്പിക്കുക. ട്രങ്ക് sip.thunderphone.com-ലേക്ക് ചൂണ്ടിക്കാണിക്കാൻ Zoom-ന്റെ ISV ടീമിനോട് ആവശ്യപ്പെടുക: പോർട്ട് 5061-ൽ TLS ഉപയോഗിച്ചും, അഭ്യർത്ഥന URI-യിലും To ഹെഡറിലും കണക്റ്ററിന്റെ നമ്പർ ഉൾപ്പെടുത്തിയും. എൻഡ്പോയിന്റ് UDP നിരസിക്കുന്നതിനാൽ, ട്രങ്ക് അതിലേക്ക് മടങ്ങിവീഴുന്നില്ലെന്ന് ഉറപ്പാക്കുക.
Zoom അയയ്ക്കുന്നത്:
X-ZOOM-Call-Sid, കോളിന്റെexternal_call_idആയി സംഭരിക്കുന്നു. Zoom-ന്റെ സ്വന്തം ഡാറ്റ മാപ്പിംഗ് പേജിൽ ഇത് പട്ടികപ്പെടുത്തിയിട്ടില്ല; മറ്റൊരു AI ദാതാവിന്റെ Zoom ഇന്റഗ്രേഷൻ ഇത് രേഖപ്പെടുത്തുന്നുണ്ട്, അതിനാൽ നിങ്ങളുടെ ആദ്യ പരീക്ഷണ കോളിൽ ഇത് പരിശോധിക്കുക.- വിളിക്കുന്നയാൾ ഡയൽ ചെയ്ത നമ്പറായ
X-ZOOM-DNIS,{{sip_x_zoom_dnis}}ആയി. - കണക്റ്ററിന്റെ സ്റ്റാറ്റിക് URL ആയ
X-ZOOM-WEBHOOK.
3. കോൾ തിരികെ നേടുക
ഏജന്റ് Zoom-ന്റെ SBC-യിലെ മനുഷ്യ-ഏജന്റ് വിലാസത്തിലേക്ക് ഒരു REFER അയയ്ക്കുന്നു. Zoom നിങ്ങൾക്ക് നൽകുന്ന SBC വിലാസം ഉപയോഗിച്ച് ഈ
കൈമാറ്റ നമ്പർ ചേർക്കുക (കാണുക
കൈമാറ്റ നമ്പർ ചേർക്കുക):
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}ഒരു ബോട്ട് കോൺടെക്സ്റ്റ് കൈമാറുന്നതിനുള്ള രണ്ട് മാർഗങ്ങൾ Zoom-ന്റെ ഗൈഡ് വിവരിക്കുന്നു: REFER-ന് മുമ്പ്
കണക്റ്ററിന്റെ സ്റ്റാറ്റിക് URL-ലേക്കുള്ള ഒരു POST (voicebot_metadata പോലുള്ള
ഇവന്റുകൾ), കൂടാതെ Bot-ൽ നിന്ന് ഇൻബൗണ്ട് എന്നതിന് കീഴിൽ മാപ്പ് ചെയ്ത SIP ഹെഡറുകൾ. ThunderPhone
സ്റ്റാറ്റിക് URL-ലേക്ക് പോസ്റ്റ് ചെയ്യുന്നില്ല. ഒരു REFER-ൽ നിന്ന് മാപ്പ് ചെയ്ത
ഹെഡറുകൾ വായിക്കുന്നുണ്ടോ എന്ന് Zoom-ന്റെ ഗൈഡ് പറയുന്നില്ല; പരീക്ഷിക്കാൻ ആഗ്രഹിക്കുന്നുവെങ്കിൽ, എൻട്രിയിലേക്ക്
"X-Handoff-Id": "{{handoff_id}}" പോലുള്ള headers ചേർത്ത് ഒരു ടെസ്റ്റ് കോളിൽ പരിശോധിക്കുക. കൂടാതെ,
മെറ്റാഡാറ്റ POST ഇല്ലാതെ ഒരു REFER സ്വീകരിക്കുന്നുവെന്ന് Zoom-നോട് സ്ഥിരീകരിക്കുക.
ഇവയിലൊന്നിനെയും ആശ്രയിക്കാതെ കൈമാറ്റം ലഭിക്കാൻ, Bot വിഡ്ജറ്റിന് ശേഷം നിങ്ങളുടെ ഫ്ലോ അത് തിരയുന്ന രീതിയിൽ HTTP കോൾ അല്ലെങ്കിൽ സ്ക്രിപ്റ്റ് വിഡ്ജറ്റ് ഉപയോഗിച്ച് ക്രമീകരിക്കുക:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=എന്നതിന് ശേഷം കോൾ sid ചേർക്കുക.Authorization: Bearer sk_live_…ഹെഡർ ഉപയോഗിക്കുക.- കോളറെ റൂട്ട് ചെയ്യാനും കോൾ എടുക്കുന്ന വ്യക്തിക്ക് സംക്ഷിപ്ത വിവരങ്ങൾ നൽകാനും
handoff.summary,handoff.intentഎന്നിവ ഉപയോഗിക്കുക.
ഈ വിഡ്ജറ്റുകൾക്കുള്ള ഫീൽഡ്-തല ഡോക്യുമെന്റേഷൻ Zoom പ്രസിദ്ധീകരിക്കുന്നില്ല, അതിനാൽ
വിഡ്ജറ്റിന് Authorization ഹെഡർ അയയ്ക്കാനാകുമെന്ന് നിങ്ങളുടെ അക്കൗണ്ടിൽ സ്ഥിരീകരിക്കുക. കാണുക
കൈമാറിയ കോൾ തിരയുക.
ഇത് പരിശോധിക്കുക
Bot വിഡ്ജറ്റിലെത്തുന്ന ഒരു നമ്പറിലേക്ക് കോൾ ചെയ്യുക, ഏജന്റിനോട് ഒരു വ്യക്തിയെ ആവശ്യപ്പെടുക, കോളർ
ഒരു മനുഷ്യ ഏജന്റിലെത്തുന്നുണ്ടെന്നും വിഡ്ജറ്റ് കൈമാറ്റം തിരികെ നൽകുന്നുണ്ടെന്നും പരിശോധിക്കുക. തുടർന്ന്
GET /v1/calls/{call_id} ഉപയോഗിച്ച് കോൾ തുറക്കുക: sip_headers-ൽ
x-zoom-call-sid ഉണ്ടായിരിക്കണം, കൂടാതെ external_call_id നിങ്ങളുടെ ഫ്ലോ
ഉപയോഗിക്കുന്ന കോൾ sid-യുമായി പൊരുത്തപ്പെടണം.
പരിമിതികൾ
- ThunderPhone കണക്റ്ററിന്റെ സ്റ്റാറ്റിക് URL-ലേക്ക് പോസ്റ്റ് ചെയ്യുന്നില്ല, അതിനാൽ Zoom-ന്
ലുക്കപ്പിലൂടെയോ, നിങ്ങളുടെ പരിശോധന Zoom അവയെ
REFER-ൽ നിന്ന് വായിക്കുന്നുവെന്ന് കാണിക്കുന്നുവെങ്കിൽ മാപ്പ് ചെയ്ത ഹെഡറുകളിലൂടെയോ കൈമാറ്റം ലഭിക്കുന്നു. - ട്രങ്ക് Zoom-ന്റെ ISV ടീമാണ് നിർമ്മിച്ചിരിക്കുന്നത്, അതിനാൽ നിങ്ങൾക്ക് അത് സ്വയം സജ്ജീകരിക്കാനോ പരിശോധിക്കാനോ കഴിയില്ല.