Open in
Genesys Cloud ನಿಂದ ಸಂಪರ್ಕಿಸಿ
ಸಂಭಾಷಣೆ ಐಡಿ ಮತ್ತು UUI ಜೊತೆಗೆ Genesys Cloud ಕರೆಗಳನ್ನು BYOC Cloud ಟ್ರಂಕ್ ಮೂಲಕ ThunderPhone ಏಜೆಂಟ್ಗೆ ಕಳುಹಿಸಿ, ಮತ್ತು UUI ಯಲ್ಲಿನ ಹ್ಯಾಂಡ್-ಆಫ್ ಮೂಲಕ ಅವುಗಳನ್ನು ಮರಳಿ ಪಡೆಯಿರಿ.
ನಿಮ್ಮ Architect ಫ್ಲೋ, ನೀವು ಹೊಂದಿಸಿದ ಸಂಭಾಷಣೆ ಐಡಿ ಮತ್ತು ಯಾವುದೇ UUI ಜೊತೆಗೆ, ಕರೆ ಮಾಡುವವರನ್ನು BYOC Cloud ಟ್ರಂಕ್ ಮೂಲಕ ಏಜೆಂಟ್ಗೆ ಕಳುಹಿಸುತ್ತದೆ. ಕರೆ ಮಾಡುವವರಿಗೆ ವ್ಯಕ್ತಿಯ ಅಗತ್ಯವಿದ್ದಾಗ, ಏಜೆಂಟ್ SIP REFER ಕಳುಹಿಸುತ್ತದೆ, Genesys ಕರೆಯನ್ನು ಮರಳಿ ಪಡೆದುಕೊಳ್ಳುತ್ತದೆ ಮತ್ತು ಹ್ಯಾಂಡ್-ಆಫ್ ಐಡಿ ಕರೆಯ UUI ನಲ್ಲಿ ಬರುತ್ತದೆ.
ಪ್ರಾರಂಭಿಸುವ ಮೊದಲು
- ThunderPhone ಏಜೆಂಟ್ ಮತ್ತು ಸಂಸ್ಥೆಯ API ಕೀ.
- BYOC Cloud ಹೊಂದಿರುವ Genesys Cloud, ಮತ್ತು ಈ ಸೆಟ್ಟಿಂಗ್ಗಳನ್ನು ಆನ್ ಮಾಡಿರುವ ಬಾಹ್ಯ ಟ್ರಂಕ್ (ಪ್ರಕಾರ BYOC Carrier ಅಥವಾ PBX)
(ಬಾಹ್ಯ ಟ್ರಂಕ್ ಸೆಟ್ಟಿಂಗ್ಗಳು):
- ಸಂಭಾಷಣೆ ಹೆಡರ್ಗಳು, ಇದರಿಂದ Genesys ತನ್ನ ಸಂಭಾಷಣೆ ಐಡಿಯನ್ನು
x-inin-cnvನಲ್ಲಿ ಕಳುಹಿಸುತ್ತದೆ. ಇದು ಡೀಫಾಲ್ಟ್ ಆಗಿ ಆಫ್ ಆಗಿರುತ್ತದೆ. - UUI ಪಾಸ್ಥ್ರೂ, ಹೆಡರ್ ಪ್ರಕಾರ
User-To-Userಮತ್ತು ಎನ್ಕೋಡಿಂಗ್ Hex ಜೊತೆಗೆ. - ಮರಳಿ ಪಡೆಯುವುದು ಮತ್ತು ವರ್ಗಾವಣೆ, ಇದರಿಂದ Genesys ಏಜೆಂಟ್ನ
REFERಅನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆ.
- ಸಂಭಾಷಣೆ ಹೆಡರ್ಗಳು, ಇದರಿಂದ Genesys ತನ್ನ ಸಂಭಾಷಣೆ ಐಡಿಯನ್ನು
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. Genesys 128 ಅಥವಾ ಕಡಿಮೆ ಅಕ್ಷರಗಳನ್ನು ಶಿಫಾರಸು ಮಾಡುತ್ತದೆ. - ಎಂಡ್ಪಾಯಿಂಟ್ನ
sip_uriಜೊತೆಗೆ ಸಂಖ್ಯೆಗೆ ವರ್ಗಾಯಿಸಿ ಕ್ರಿಯೆಯನ್ನು ಸೇರಿಸಿ, ಉದಾಹರಣೆಗೆsip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys ಸಂಭಾಷಣೆ ಐಡಿಯನ್ನು x-inin-cnv ನಲ್ಲಿ ಕಳುಹಿಸುತ್ತದೆ. ThunderPhone ಅದನ್ನು ಕರೆಯ external_call_id ಆಗಿ ಸಂಗ್ರಹಿಸುತ್ತದೆ. UUI ಡಿಕೋಡ್ ಆಗಿ, {{sip_uui}} ರೂಪದಲ್ಲಿ prompt ಅನ್ನು ತಲುಪುತ್ತದೆ.
ಟ್ರಂಕ್ ಕಸ್ಟಮ್ ಹೆಡರ್ಗಳು Genesys ನಲ್ಲಿ ಸ್ಥಿರವಾಗಿರುತ್ತವೆ, ಆದ್ದರಿಂದ ಪ್ರತಿ-ಕರೆ ಮೌಲ್ಯಗಳನ್ನು UUI ನಲ್ಲಿ ಇರಿಸಿ. Genesys ತನ್ನ ಬಳಕೆಗಾಗಿ x-inin, x-genesys, x-pcv ಮತ್ತು x-gcv ಹೆಡರ್ ಪೂರ್ವಪ್ರತ್ಯಯಗಳನ್ನು ಕಾಯ್ದಿರಿಸಿದೆ.
3. ಕರೆಯನ್ನು ಮರಳಿ ಪಡೆಯಿರಿ
ಏಜೆಂಟ್, ಆ ವಿಳಾಸದ ಒಳಗೆ ಹೆಕ್ಸ್ UUI ಆಗಿ ಹ್ಯಾಂಡ್-ಆಫ್ ಐಡಿ ಇರುವ Genesys ನಲ್ಲಿನ ವಿಳಾಸಕ್ಕೆ REFER ಮೂಲಕ ವರ್ಗಾಯಿಸುತ್ತದೆ. ಈ ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ (ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ
ಮತ್ತು ವರ್ಗಾವಣೆ ವಿಳಾಸದೊಳಗಿನ ಹೆಡರ್ಗಳು ನೋಡಿ):
{
"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>
ಮರಳಿ ಪಡೆಯುವುದು ಮತ್ತು ವರ್ಗಾವಣೆ ಆನ್ ಆಗಿರುವಾಗ, 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 ಹೊಂದುವಂತೆ ಕತ್ತರಿಸಲಾಗುತ್ತದೆ. ಹ್ಯಾಂಡ್-ಆಫ್ ಐಡಿ ಯಾವಾಗಲೂ ಹೊಂದುತ್ತದೆ.