Open in
Talkdesk ನಿಂದ ಸಂಪರ್ಕಿಸಿ
Connect to Autopilot Voice ಮೂಲಕ Talkdesk ಕರೆಗಳನ್ನು ThunderPhone ಏಜೆಂಟ್ಗೆ ಕಳುಹಿಸಿ, ಮತ್ತು UUI ಯಲ್ಲಿನ ಹ್ಯಾಂಡ್-ಆಫ್ ID ಯೊಂದಿಗೆ ಅವುಗಳನ್ನು ಮರಳಿ ಎಸ್ಕಲೇಟ್ ಮಾಡಿ.
ನಿಮ್ಮ Talkdesk Studio ಫ್ಲೋ ಕರೆಮಾಡುವವರನ್ನು ಸಂವಹನ
ID ಮತ್ತು UUI ಜೊತೆಗೆ ಏಜೆಂಟ್ಗೆ ಕಳುಹಿಸುತ್ತದೆ. ಕರೆಮಾಡುವವರಿಗೆ ವ್ಯಕ್ತಿಯ ಅಗತ್ಯವಿದ್ದಾಗ, ಏಜೆಂಟ್ Talkdeskಗೆ SIP
REFER ಮೂಲಕ ಎಸ್ಕಲೇಟ್ ಮಾಡುತ್ತದೆ ಮತ್ತು ಹ್ಯಾಂಡ್-ಆಫ್ ID Studio ವೇರಿಯಬಲ್ನಲ್ಲಿ ಸೇರುತ್ತದೆ.
ಪ್ರಾರಂಭಿಸುವ ಮೊದಲು
- ThunderPhone ಏಜೆಂಟ್ ಮತ್ತು ಸಂಸ್ಥೆಯ API ಕೀ.
- Talkdesk ಸಂಭಾಷಣೆ ಆರ್ಕೆಸ್ಟ್ರೇಟರ್ ಪರವಾನಗಿ, ಇದು ಬಾಹ್ಯ ಧ್ವನಿ ಸ್ಟ್ರೀಮ್ ಮೋಡ್ನಲ್ಲಿರುವ Studio Autopilot Voice ಗೆ ಸಂಪರ್ಕಿಸಿ ಘಟಕವನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ (Talkdesk ಲೇಖನ). ಏಜೆಂಟ್ ಕರೆಯನ್ನು ಹಿಡಿದಿಟ್ಟುಕೊಂಡಿರುವಾಗ Talkdesk ಪ್ರತಿ ನಿಮಿಷಕ್ಕೆ ಶುಲ್ಕ ವಿಧಿಸುತ್ತದೆ.
1. SIP ಎಂಡ್ಪಾಯಿಂಟ್ ರಚಿಸಿ
Talkdesk ಕೇವಲ IP ಅನುಮತಿಪಟ್ಟಿಯನ್ನು ದಾಖಲಿಸುತ್ತದೆ, ಆದ್ದರಿಂದ ಮೂಲ ವಿಳಾಸದ ಮೂಲಕ ಕರೆಗಳನ್ನು ಸ್ವೀಕರಿಸುವ ಎಂಡ್ಪಾಯಿಂಟ್ ರಚಿಸಿ:
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": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'Talkdesk ಲೇಖನವು ಅದು SRTP ಮೂಲಕ ಆಡಿಯೊ ಕಳುಹಿಸುತ್ತದೆ ಎಂದು ಹೇಳುತ್ತದೆ ಮತ್ತು "srtp": "optional"
Talkdesk ಅದನ್ನು ನೀಡಿದಾಗ SRTPಗೆ ಉತ್ತರಿಸುತ್ತದೆ. Talkdesk
SRTP ಅಗತ್ಯವಿದೆಯೇ ಎಂದು ಲೇಖನವು ಹೇಳುವುದಿಲ್ಲ; Talkdesk ಅಗತ್ಯವಿದೆ ಎಂದು ನಿಮಗೆ ತಿಳಿಸಿದರೆ, srtp ಅನ್ನು required ಗೆ ಹೊಂದಿಸಿ, ಇದು
ಅದು ಇಲ್ಲದ ಕರೆಗಳನ್ನು ನಿರಾಕರಿಸುತ್ತದೆ.
Talkdeskನಿಂದ Talkdesk SIP ಸಿಗ್ನಲಿಂಗ್ ಶ್ರೇಣಿಗಳನ್ನು ಪಡೆಯಿರಿ. ಪ್ರತಿಯೊಂದೂ ಸಾರ್ವಜನಿಕ IPv4
ಶ್ರೇಣಿ /16 ಅಥವಾ ಅದಕ್ಕಿಂತ ಕಿರಿದಾಗಿರಬೇಕು (IPv6 /48 ಅಥವಾ ಅದಕ್ಕಿಂತ ಕಿರಿದಾಗಿರಬೇಕು). ನೋಡಿ
ಮೂಲ IP ಮೂಲಕ ದೃಢೀಕರಿಸುವ ಪ್ಲಾಟ್ಫಾರ್ಮ್ಗಳು.
Talkdesk, ಪ್ರತಿಯೊಬ್ಬ Twilio ಗ್ರಾಹಕರು ಹಂಚಿಕೊಳ್ಳುವ Twilio ನೆಟ್ವರ್ಕ್ನಿಂದ SIP ಕಳುಹಿಸುತ್ತದೆ,
ಆದ್ದರಿಂದ ಎಂಡ್ಪಾಯಿಂಟ್ನ ವಿಳಾಸವೇ ಇತರ ಕರೆಮಾಡುವವರನ್ನು ಹೊರಗಿಡುತ್ತದೆ: ಅದನ್ನು
ಪ್ರಕಟಿಸಬೇಡಿ.
ಪ್ರತಿಕ್ರಿಯೆಯ sip_uri ಉಳಿಸಿಕೊಳ್ಳಿ, ಉದಾಹರಣೆಗೆ
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. ಸಂದರ್ಭದೊಂದಿಗೆ ಕರೆಗಳನ್ನು ಕಳುಹಿಸಿ
ನಿಮ್ಮ Studio ಫ್ಲೋದಲ್ಲಿ, ಬಾಹ್ಯ ಧ್ವನಿ
ಸ್ಟ್ರೀಮ್ ಮೋಡ್ನಲ್ಲಿ Autopilot Voice ಗೆ ಸಂಪರ್ಕಿಸಿ ಸೇರಿಸಿ ಮತ್ತು ಅದರ ಗುರಿಯನ್ನು ಎಂಡ್ಪಾಯಿಂಟ್ನ sip_uri ಗೆ ;transport=tls ಸೇರಿಸಿ ಹೊಂದಿಸಿ,
ಉದಾಹರಣೆಗೆ sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. ಬೇರೆ ರೀತಿಯಲ್ಲಿ ಸೂಚಿಸದಿದ್ದರೆ Twilio SIP ಬಳಸುವ UDP ಮೂಲಕದ ಕರೆಗಳನ್ನು
ಎಂಡ್ಪಾಯಿಂಟ್ ನಿರಾಕರಿಸುತ್ತದೆ.
Talkdesk ಕಳುಹಿಸುವುದು:
- ಕರೆಯ
external_call_idಆಗಿ ಸಂಗ್ರಹವಾಗುವX-Talkdesk-Interaction-Id; User-to-User, ಹೆಕ್ಸ್-ಎನ್ಕೋಡ್ ಮಾಡಲ್ಪಟ್ಟಿದ್ದು, ಉದಾಹರಣೆಗೆbusiness_hours=open. ಇದು ಡಿಕೋಡ್ ಆಗಿ{{sip_uui}}ರೂಪದಲ್ಲಿ prompt ತಲುಪುತ್ತದೆ.
ಘಟಕದ ಆವೃತ್ತಿ 2.1 ವ್ಯಾಖ್ಯಾನಿತ ಹೆಡರ್ಗಳನ್ನು ಸಹ ಕಳುಹಿಸಬಹುದು. Talkdeskನ ಆದ್ಯತೆಗಳ ಪುಟವು ಅವುಗಳನ್ನು WebSocket ಮೂಲಕ ಕಳುಹಿಸಲಾದ JSON ಎಂದು ವಿವರಿಸುತ್ತದೆ, ಆದ್ದರಿಂದ ನೀವು ಅವುಗಳ ಮೇಲೆ ಅವಲಂಬಿಸುವ ಮೊದಲು ಅವು SIP ಹೆಡರ್ಗಳಾಗಿ ಬರುತ್ತವೆಯೇ ಎಂದು Talkdesk ಜೊತೆಗೆ ದೃಢೀಕರಿಸಿ.
3. ಕರೆಯನ್ನು ಮರಳಿ ಪಡೆಯಿರಿ
ಏಜೆಂಟ್ Talkdesk ನ ಎಸ್ಕಲೇಷನ್ ವಿಳಾಸಕ್ಕೆ REFER ಮೂಲಕ ಎಸ್ಕಲೇಷನ್ ಮಾಡುತ್ತದೆ, ಆ
ವಿಳಾಸದೊಳಗೆ ಹ್ಯಾಂಡ್-ಆಫ್ ಐಡಿಯನ್ನು ಹೆಕ್ಸ್ UUI ಆಗಿ ಸೇರಿಸಲಾಗುತ್ತದೆ; Talkdesk ಅದನ್ನು
ಓದುವ ಏಕೈಕ ಸ್ಥಳ ಅದೇ ಆಗಿದೆ. ಈ ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ (ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು
ಸೇರಿಸಿ
ಮತ್ತು ವರ್ಗಾವಣೆ ವಿಳಾಸದೊಳಗಿನ ಹೆಡರ್ಗಳು ನೋಡಿ):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}ವಿಳಾಸವು Talkdesk ನ ಲೇಖನದಲ್ಲಿರುವುದೇ ಆಗಿದೆ. ಘಟಕದ ಆವೃತ್ತಿ 2.1
autopilot_result= ಅನ್ನು ಓದುತ್ತದೆ; ಆವೃತ್ತಿ 1.7 escalate_to= ಅನ್ನು ಓದುತ್ತದೆ,
ಆದ್ದರಿಂದ 1.7 ನಲ್ಲಿ ಆ ಕೀಲಿಯನ್ನು ಬಳಸಿ. REFER ಹೀಗೆ ಕಾಣುತ್ತದೆ:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk ಮೌಲ್ಯವನ್ನು Studio ವೇರಿಯಬಲ್ನಲ್ಲಿ ಇರಿಸುತ್ತದೆ. ಸಾರಾಂಶ ಮತ್ತು ಉದ್ದೇಶವನ್ನು ಪಡೆಯಲು, Connections ನೊಂದಿಗೆ ನಿರ್ಮಿಸಿದ ಕಸ್ಟಮ್ ಇಂಟಿಗ್ರೇಶನ್ನಲ್ಲಿ ಕ್ರಿಯೆ ನಿರ್ವಹಿಸಿ ಹಂತವನ್ನು ಸೇರಿಸಿ:
- ದೃಢೀಕರಣ ಪ್ರಕಾರ API ಕೀ, ಹೆಡರ್ ಹೆಸರು
Authorization, ಮೌಲ್ಯBearer sk_live_…. - ವಿನಂತಿ:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ನಂತರ ವೇರಿಯಬಲ್ನಲ್ಲಿರುವ ಐಡಿ. ಇಂಟರ್ಯಾಕ್ಷನ್ ಐಡಿಯೊಂದಿಗೆexternal_call_idಬಳಸಿ ಕರೆಯನ್ನು ಹುಡುಕಬಹುದು. handoff.intentಆಧರಿಸಿ ಮಾರ್ಗನಿರ್ದೇಶಿಸಿ, ಮತ್ತು ಕರೆಯನ್ನು ಸ್ವೀಕರಿಸುವ ವ್ಯಕ್ತಿಗೆhandoff.summaryತೋರಿಸಿ.
ಹ್ಯಾಂಡ್-ಆಫ್ ಮಾಡಿದ ಕರೆಯನ್ನು ಹುಡುಕಿ ನೋಡಿ.
ಇದನ್ನು ಪರೀಕ್ಷಿಸಿ
Studio ಫ್ಲೋ ಮೂಲಕ ಕರೆಯನ್ನು ಪ್ರಾರಂಭಿಸಿ, ಏಜೆಂಟ್ಗೆ ಒಬ್ಬ ವ್ಯಕ್ತಿಯೊಂದಿಗೆ ಮಾತನಾಡಲು
ಕೇಳಿ, ಮತ್ತು ಫ್ಲೋ ತನ್ನ ವೇರಿಯಬಲ್ನಲ್ಲಿ ಹ್ಯಾಂಡ್-ಆಫ್ ಐಡಿಯೊಂದಿಗೆ ಘಟಕವನ್ನು ದಾಟಿ
ಮುಂದುವರಿಯುವುದನ್ನು ಪರಿಶೀಲಿಸಿ. ನಂತರ GET /v1/calls/{call_id} ಮೂಲಕ ಕರೆಯನ್ನು
ತೆರೆಯಿರಿ: external_call_id Talkdesk ಇಂಟರ್ಯಾಕ್ಷನ್ ಐಡಿಯಾಗಿರಬೇಕು.
ಮಿತಿಗಳು
- Talkdesk ಗರಿಷ್ಠ 256 ಬೈಟ್ಗಳ UUI ಮಾತ್ರ ಓದುತ್ತದೆ ಮತ್ತು
|ಅಥವಾ;ನಿಂದ ಪ್ರತ್ಯೇಕಿಸಲಾದ ಮೌಲ್ಯಗಳನ್ನು ಅನುಮತಿಸುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ಒಂದೇ ಮೌಲ್ಯವನ್ನು ಕಳುಹಿಸಿ. ಹ್ಯಾಂಡ್-ಆಫ್ ಐಡಿ ಹೊಂದುತ್ತದೆ. - Talkdesk ನ API ಗಳು ಏಜೆಂಟ್ನ ಟ್ರಾನ್ಸ್ಕ್ರಿಪ್ಟ್ ಅನ್ನು ಓದಲು ಸಾಧ್ಯವಿಲ್ಲ. ಬದಲಿಗೆ
ಹ್ಯಾಂಡ್-ಆಫ್ ಹುಡುಕಾಟ ಅಥವಾ
GET /v1/calls/{call_id}ಬಳಸಿ.