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. ಸಂದರ್ಭದೊಂದಿಗೆ ಕರೆಗಳನ್ನು ಕಳುಹಿಸಿ
ನಿಮ್ಮ ಫ್ಲೋಗೆ ಬಾಟ್ ವಿಜೆಟ್ ಸೇರಿಸಿ ಮತ್ತು ಅದನ್ನು ಕನೆಕ್ಟರ್ಗೆ ಜೋಡಿಸಿ. ಕನೆಕ್ಟರ್ನ ಸಂಖ್ಯೆಯನ್ನು ವಿನಂತಿ URI ಮತ್ತು To ಹೆಡರ್ ಎರಡರಲ್ಲೂ ಇರಿಸಿ, ಪೋರ್ಟ್ 5061 ರಲ್ಲಿ TLS ಬಳಸಿ ಟ್ರಂಕ್ ಅನ್ನು sip.thunderphone.com ಗೆ ಸೂಚಿಸುವಂತೆ Zoom ನ ISV ತಂಡವನ್ನು ಕೇಳಿ. ಎಂಡ್ಪಾಯಿಂಟ್ 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 ಮತ್ತು ಇದೇ ರೀತಿಯ
ಘಟನೆಗಳು), ಮತ್ತು ಬಾಟ್ನಿಂದ ಒಳಬರುವ ಅಡಿಯಲ್ಲಿ ಮ್ಯಾಪ್ ಮಾಡಲಾದ SIP ಹೆಡರ್ಗಳು. ThunderPhone
ಸ್ಟ್ಯಾಟಿಕ್ URL ಗೆ ಪೋಸ್ಟ್ ಮಾಡುವುದಿಲ್ಲ. Zoom ನ ಮಾರ್ಗದರ್ಶಿಯು REFER ನಿಂದ ಮ್ಯಾಪ್ ಮಾಡಲಾದ
ಹೆಡರ್ಗಳನ್ನು ಓದುತ್ತದೆಯೇ ಎಂದು ಹೇಳುವುದಿಲ್ಲ; ಪ್ರಯತ್ನಿಸಲು ಬಯಸಿದರೆ, ಎಂಟ್ರಿಗೆ
"X-Handoff-Id": "{{handoff_id}}" ನಂತಹ headers ಸೇರಿಸಿ ಮತ್ತು ಪರೀಕ್ಷಾ ಕರೆಯಲ್ಲಿ
ಪರಿಶೀಲಿಸಿ. ಅಲ್ಲದೆ, ಅದರ ಮೊದಲು ಮೆಟಾಡೇಟಾ POST ಇಲ್ಲದ REFER ಅನ್ನು Zoom ಸ್ವೀಕರಿಸುತ್ತದೆ
ಎಂದು Zoom ಜೊತೆಗೆ ದೃಢೀಕರಿಸಿ.
ಇವೆರಡರ ಮೇಲೂ ಅವಲಂಬಿಸದೆ ಹ್ಯಾಂಡ್-ಆಫ್ ಪಡೆಯಲು, ಬಾಟ್ ವಿಜೆಟ್ ನಂತರ ನಿಮ್ಮ ಫ್ಲೋ ಅದನ್ನು HTTP ಕರೆ ಅಥವಾ ಸ್ಕ್ರಿಪ್ಟ್ ವಿಜೆಟ್ ಮೂಲಕ ಹುಡುಕುವಂತೆ ಮಾಡಿ:
- ಕರೆ sid ನಂತರ ಬರುವ
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=. - ಹೆಡರ್
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 ತಂಡ ನಿರ್ಮಿಸುತ್ತದೆ, ಆದ್ದರಿಂದ ನೀವು ಅದನ್ನು ಸ್ವತಃ ಹೊಂದಿಸಲು ಅಥವಾ ಪರೀಕ್ಷಿಸಲು ಸಾಧ್ಯವಿಲ್ಲ.