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 નો ટ્રંક ઑડિયો માટે SRTP સાથે
પોર્ટ 5061 પર TLS 1.2 નો ઉપયોગ કરે છે અને પાસવર્ડને બદલે Zoom ના સબનેટ્સ દ્વારા ઍલાઉલિસ્ટ થાય છે.
તેથી કનેક્ટરના નંબરને ડાયલ-ઇન નંબર તરીકે અને 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:required, કારણ કે Zoom નો ટ્રંક હંમેશા SRTP નો ઉપયોગ કરે છે.
Zoom ના સરનામાં તેના બધા ગ્રાહકો વચ્ચે વહેંચાયેલા હોય છે, તેથી નંબર ડાયલ કરનાર કોઈપણ અન્ય Zoom ગ્રાહક તમારા એજન્ટ સુધી પહોંચે છે. Zoom નંબર ફાળવે છે; તેને પ્રકાશિત કરશો નહીં.
2. સંદર્ભ સાથે કૉલ મોકલો
તમારા ફ્લોમાં બોટ વિજેટ ઉમેરો અને તેને કનેક્ટર સાથે બાંધો. Zoom ની ISV
ટીમને ટ્રંકને sip.thunderphone.com પર નિર્દેશિત કરવા કહો, પોર્ટ 5061 પર TLS સાથે, અને
રિક્વેસ્ટ URI તથા To હેડર બંનેમાં કનેક્ટરનો નંબર રાખો. એન્ડપૉઇન્ટ UDP ને નકારે છે,
તેથી ખાતરી કરો કે ટ્રંક તેના પર પાછો ન ફરે.
Zoom મોકલે છે:
X-ZOOM-Call-Sid, જે કૉલનાexternal_call_idતરીકે સંગ્રહિત થાય છે. Zoom ના પોતાના ડેટા મેપિંગ પેજમાં તે સૂચિબદ્ધ નથી; અન્ય AI પ્રદાતાનું Zoom ઇન્ટિગ્રેશન તેને દસ્તાવેજિત કરે છે, તેથી તમારા પ્રથમ પરીક્ષણ કૉલમાં તેને ચકાસો.X-ZOOM-DNIS, કૉલરે ડાયલ કરેલો નંબર,{{sip_x_zoom_dnis}}તરીકે.X-ZOOM-WEBHOOK, કનેક્ટરનું સ્થિર URL.
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 પર પોસ્ટ કરતું નથી. Zoom ની માર્ગદર્શિકા એ જણાવતી નથી કે તે
REFER માંથી મેપ કરેલા હેડર્સ વાંચે છે કે નહીં; જો તમે પ્રયાસ કરવા માંગતા હો, તો
એન્ટ્રીમાં "X-Handoff-Id": "{{handoff_id}}" જેવા headers ઉમેરો અને પરીક્ષણ કૉલમાં તપાસો. ઉપરાંત,
Zoom પાસેથી ખાતરી કરો કે તે પહેલાં કોઈ મેટાડેટા POST વગરનું REFER સ્વીકારે છે.
બંનેમાંથી કોઈ પર આધાર રાખ્યા વિના હેન્ડ-ઓફ મેળવવા માટે, તમારા ફ્લોમાં 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 ટીમ દ્વારા બનાવવામાં આવે છે, તેથી તમે તેને જાતે સેટ અપ અથવા પરીક્ષણ કરી શકતા નથી.