Open in
Talkdesk-ൽ നിന്ന് ബന്ധിപ്പിക്കുക
Connect to Autopilot Voice ഉപയോഗിച്ച് Talkdesk കോളുകൾ ThunderPhone ഏജന്റിലേക്ക് അയയ്ക്കുക, UUI-യിലെ hand-off id ഉപയോഗിച്ച് അവ തിരിച്ചും എസ്കലേറ്റ് ചെയ്യുക.
നിങ്ങളുടെ Talkdesk Studio ഫ്ലോ, ഇന്ററാക്ഷൻ
id-യും UUI-യും സഹിതം കോളറെ ഏജന്റിലേക്ക് അയയ്ക്കുന്നു. കോളർക്ക് ഒരു വ്യക്തിയെ ആവശ്യമുള്ളപ്പോൾ, ഏജന്റ് Talkdesk-ലേക്ക് SIP
REFER ഉപയോഗിച്ച് എസ്കലേറ്റ് ചെയ്യുന്നു, തുടർന്ന് ഹാൻഡ്-ഓഫ് id ഒരു Studio വേരിയബിളിൽ എത്തുന്നു.
ആരംഭിക്കുന്നതിന് മുമ്പ്
- ഒരു ThunderPhone ഏജന്റും ഒരു ഓർഗനൈസേഷൻ API key-യും.
- എക്സ്റ്റേണൽ വോയ്സ് സ്ട്രീം മോഡിലുള്ള Studio ഓട്ടോപൈലറ്റ് വോയിസിലേക്ക് കണക്റ്റ് ചെയ്യുക കോംപോണന്റ് ഉൾക്കൊള്ളുന്ന Talkdesk Conversation Orchestrator ലൈസൻസ് (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 വഴി ഓഡിയോ അയയ്ക്കുന്നതായി Talkdesk-ന്റെ ലേഖനം പറയുന്നു, കൂടാതെ Talkdesk അത് വാഗ്ദാനം ചെയ്യുമ്പോൾ "srtp": "optional"
SRTP ഉപയോഗിച്ച് മറുപടി നൽകുന്നു. Talkdesk-ന് SRTP ആവശ്യമാണോ എന്ന് ലേഖനം
പറയുന്നില്ല; ആവശ്യമാണെന്ന് Talkdesk നിങ്ങളോട് പറയുകയാണെങ്കിൽ, SRTP ഇല്ലാത്ത
കോളുകൾ നിരസിക്കുന്നതിന് srtp required ആയി സജ്ജമാക്കുക.
Talkdesk-ന്റെ SIP സിഗ്നലിങ് റേഞ്ചുകൾ Talkdesk-ൽ നിന്ന് നേടുക. ഓരോന്നും /16 അല്ലെങ്കിൽ അതിലും ഇടുങ്ങിയ ഒരു പബ്ലിക് IPv4
റേഞ്ചായിരിക്കണം (IPv6-ന് /48 അല്ലെങ്കിൽ അതിലും ഇടുങ്ങിയത്). കാണുക
ഉറവിട IP ഉപയോഗിച്ച് പ്രാമാണീകരിക്കുന്ന പ്ലാറ്റ്ഫോമുകൾ.
Talkdesk, എല്ലാ Twilio ഉപഭോക്താക്കളും പങ്കിടുന്ന Twilio-യുടെ നെറ്റ്വർക്കിൽ നിന്നാണ് SIP അയയ്ക്കുന്നത്,
അതിനാൽ മറ്റ് കോളർമാരെ പുറത്തുനിർത്തുന്നത് എൻഡ്പോയിന്റിന്റെ വിലാസമാണ്: അത്
പ്രസിദ്ധീകരിക്കരുത്.
മറുപടിയിലെ sip_uri സൂക്ഷിക്കുക, ഉദാഹരണത്തിന്
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. സന്ദർഭത്തോടൊപ്പം കോളുകൾ അയയ്ക്കുക
നിങ്ങളുടെ Studio ഫ്ലോയിൽ, എക്സ്റ്റേണൽ വോയ്സ്
സ്ട്രീം മോഡിൽ ഓട്ടോപൈലറ്റ് വോയിസിലേക്ക് കണക്റ്റ് ചെയ്യുക ചേർക്കുക, അതിന്റെ ടാർഗെറ്റ് എൻഡ്പോയിന്റിന്റെ sip_uri ആയി ;transport=tls ചേർത്ത് സജ്ജമാക്കുക, ഉദാഹരണത്തിന്
sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. മറ്റുവിധത്തിൽ നിർദേശിച്ചില്ലെങ്കിൽ Twilio-യുടെ SIP ഉപയോഗിക്കുന്ന UDP വഴിയുള്ള കോളുകൾ
എൻഡ്പോയിന്റ് നിരസിക്കുന്നു.
Talkdesk അയയ്ക്കുന്നത്:
- കോളിന്റെ
external_call_idആയി സംഭരിക്കുന്നX-Talkdesk-Interaction-Id; business_hours=openപോലുള്ള, ഹെക്സ്-എൻകോഡ് ചെയ്തUser-to-User. ഇത് ഡീകോഡ് ചെയ്ത്{{sip_uui}}ആയി prompt-ലേക്ക് എത്തുന്നു.
കോംപോണന്റിന്റെ പതിപ്പ് 2.1-ന് നിർവചിച്ച ഹെഡറുകൾ അയയ്ക്കാനും കഴിയും. Talkdesk-ന്റെ മുൻഗണനാ പേജ് അവയെ WebSocket വഴി അയയ്ക്കുന്ന JSON എന്നാണ് വിവരിക്കുന്നത്, അതിനാൽ അവയെ ആശ്രയിക്കുന്നതിന് മുമ്പ് അവ SIP ഹെഡറുകളായി എത്തുന്നുണ്ടോ എന്ന് Talkdesk-നോട് സ്ഥിരീകരിക്കുക.
3. കോൾ തിരികെ ലഭിക്കുക
ഏജന്റ് Talkdesk-ന്റെ എസ്കലേഷൻ വിലാസത്തിലേക്ക് REFER ഉപയോഗിച്ച് എസ്കലേറ്റ് ചെയ്യുന്നു. Talkdesk അത് വായിക്കുന്ന ഏക സ്ഥലമായ ആ വിലാസത്തിനുള്ളിൽ ഹാൻഡ്-ഓഫ് ഐഡി ഹെക്സ് UUI ആയി ഉൾപ്പെടുന്നു.
ഈ ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക (ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക
കൂടാതെ ട്രാൻസ്ഫർ വിലാസത്തിനുള്ളിലെ ഹെഡറുകൾ കാണുക):
{
"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}ഉപയോഗിക്കുക.