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: Zoom ట్రంక్ ఎల్లప్పుడూ SRTPను ఉపయోగిస్తుంది కాబట్టిrequired.
Zoom చిరునామాలు దాని కస్టమర్లందరికీ భాగస్వామ్యంగా ఉంటాయి, కాబట్టి సంఖ్యకు డయల్ చేసే ఏ ఇతర Zoom కస్టమర్ అయినా మీ ఏజెంట్ను చేరుకుంటారు. Zoom సంఖ్యను కేటాయిస్తుంది; దాన్ని ప్రచురించవద్దు.
2. సందర్భంతో కాల్లను పంపండి
మీ ఫ్లోకు ఒక బాట్ విడ్జెట్ను జోడించి, దానిని కనెక్టర్కు అనుసంధానించండి. ట్రంక్ను sip.thunderphone.com వైపు, పోర్ట్ 5061లో TLSతో, రిక్వెస్ట్ URI మరియు To హెడర్ రెండింటిలోనూ కనెక్టర్ సంఖ్యతో సూచించమని Zoom యొక్క ISV బృందాన్ని అడగండి. ఎండ్పాయింట్ UDPని తిరస్కరిస్తుంది, కాబట్టి ట్రంక్ దానికి తిరిగి మారకుండా నిర్ధారించండి.
Zoom పంపేది:
- కాల్ యొక్క
external_call_idగా నిల్వ చేయబడేX-ZOOM-Call-Sid. 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 మరియు ఇలాంటి
ఈవెంట్లు), అలాగే బాట్ నుండి ఇన్బౌండ్ కింద మ్యాప్ చేసిన SIP హెడర్లు.
ThunderPhone స్టాటిక్ URLకు పోస్ట్ చేయదు. REFER నుండి మ్యాప్ చేసిన హెడర్లను
అది చదువుతుందో లేదో Zoom గైడ్లో చెప్పలేదు; మీరు ప్రయత్నించాలనుకుంటే, ఎంట్రీకి
"X-Handoff-Id": "{{handoff_id}}" వంటి headers జోడించి, టెస్ట్ కాల్లో
తనిఖీ చేయండి. అంతకు ముందు మెటాడేటా POST లేకుండా REFERను అది అంగీకరిస్తుందో
లేదో కూడా Zoomతో నిర్ధారించండి.
వీటిలో దేనిపైనా ఆధారపడకుండా హ్యాండ్-ఆఫ్ పొందడానికి, బాట్ విడ్జెట్ తర్వాత మీ ఫ్లో దానిని HTTP కాల్ లేదా స్క్రిప్ట్ విడ్జెట్తో లుక్ అప్ చేసేలా చేయండి:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=తర్వాత కాల్ SIDను జోడించండి.- హెడర్
Authorization: Bearer sk_live_…. - కాలర్ను రూట్ చేయడానికి మరియు కాల్ తీసుకునే వ్యక్తికి సంక్షిప్త వివరాలు అందించడానికి
handoff.summaryమరియుhandoff.intentఉపయోగించండి.
ఈ విడ్జెట్లకు ఫీల్డ్-స్థాయి డాక్యుమెంటేషన్ను Zoom ప్రచురించదు, కాబట్టి విడ్జెట్
Authorization హెడర్ను పంపగలదని మీ ఖాతాలో నిర్ధారించండి. చూడండి
హ్యాండ్-ఆఫ్ చేసిన కాల్ను లుక్ అప్ చేయండి.
దీన్ని పరీక్షించండి
బాట్ విడ్జెట్కు చేరే నంబర్కు కాల్ చేసి, ఏజెంట్ను ఒక వ్యక్తితో మాట్లాడాలని అడగండి,
ఆపై కాలర్ మానవ ఏజెంట్ను చేరుతున్నారని మరియు విడ్జెట్ హ్యాండ్-ఆఫ్ను తిరిగి
అందిస్తున్నదని తనిఖీ చేయండి. తర్వాత GET /v1/calls/{call_id}తో కాల్ను తెరవండి:
sip_headersలో x-zoom-call-sid జాబితా కావాలి, మరియు external_call_id మీ ఫ్లో
ఉపయోగించే కాల్ SIDతో సరిపోలాలి.
పరిమితులు
- ThunderPhone కనెక్టర్ యొక్క స్టాటిక్ URLకు పోస్ట్ చేయదు, కాబట్టి Zoom హ్యాండ్-ఆఫ్ను
లుక్ అప్ ద్వారా లేదా మీ పరీక్షలో Zoom వాటిని
REFERనుండి చదువుతుందని కనిపిస్తే మ్యాప్ చేసిన హెడర్ల ద్వారా పొందుతుంది. - ట్రంక్ను Zoom యొక్క ISV బృందం నిర్మిస్తుంది, కాబట్టి మీరు దానిని స్వయంగా సెటప్ చేయలేరు లేదా పరీక్షించలేరు.