Open in
Unganisha kutoka Talkdesk
Tuma simu za Talkdesk kwa ejenti wa ThunderPhone ukitumia Connect to Autopilot Voice, na zirudishe kwa hand-off id katika UUI.
Mtiririko wako wa Talkdesk Studio humtuma mpigaji kwa ejenti pamoja na kitambulisho cha mwingiliano na UUI. Mpigaji anapohitaji mtu, ejenti hupeleka kwa SIP REFER kwenda Talkdesk, na kitambulisho cha uhamisho huwekwa kwenye kigeu cha Studio.
Kabla ya kuanza
- Ejenti wa ThunderPhone na ufunguo wa API wa shirika.
- Leseni ya Talkdesk Conversation Orchestrator, inayojumuisha kipengele cha Studio cha Connect to Autopilot Voice katika hali ya External Voice Stream (makala ya Talkdesk). Talkdesk hutoza kwa dakika wakati ejenti anashikilia simu.
1. Unda endpoint ya SIP
Talkdesk inaandika orodha ya kuruhusu IP pekee, kwa hivyo unda endpoint inayokubali simu kwa anwani ya chanzo:
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"
}'Makala ya Talkdesk inasema hutuma sauti kupitia SRTP, na "srtp": "optional"
hujibu kwa SRTP wakati Talkdesk inapoitoa. Makala haisemi kama Talkdesk
inahitaji SRTP; Talkdesk ikikuambia inahitaji, weka srtp kuwa required, ambayo
hukataa simu zisizo nayo.
Pata safu za uashiriaji za SIP za Talkdesk kutoka Talkdesk. Kila moja lazima iwe safu ya
umma ya IPv4 ya /16 au nyembamba zaidi (IPv6 /48 au nyembamba zaidi). Tazama
Majukwaa yanayothibitisha kwa IP ya chanzo.
Talkdesk hutuma SIP kutoka kwenye mtandao wa Twilio, ambao anwani zake hushirikiwa na kila mteja wa Twilio,
kwa hivyo anwani ya endpoint ndiyo inayowazuia wapigaji wengine: usiichapishe.
Hifadhi sip_uri ya jibu, kwa mfano
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Tuma simu pamoja na muktadha
Katika mtiririko wako wa Studio, ongeza Connect to Autopilot Voice katika hali ya External Voice
Stream na uweke lengo lake kuwa sip_uri ya endpoint ukiwa umeongeza ;transport=tls, kwa
mfano sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Endpoint
hukataa simu kupitia UDP, ambayo SIP ya Twilio hutumia isipokuwa iambiwe vinginevyo.
Talkdesk hutuma:
X-Talkdesk-Interaction-Id, ikihifadhiwa kamaexternal_call_idya simu;User-to-User, iliyosimbwa kwa heksadesimali, kama vilebusiness_hours=open. Hufika kwenye prompt ikiwa imesimbuliwa, kama{{sip_uui}}.
Toleo la 2.1 la kipengele linaweza pia kutuma Defined headers. Ukurasa wa mapendeleo wa Talkdesk unaeleza hizi kama JSON inayotumwa kupitia WebSocket, kwa hivyo thibitisha na Talkdesk kama zinawasili kama vichwa vya SIP kabla ya kuzitegemea.
3. Pata simu irudi
Ejenti huelekeza simu kwa REFER kwenda kwenye anwani ya uelekezaji ya Talkdesk, huku
kitambulisho cha hand-off kikiwa kama UUI ya hex ndani ya anwani hiyo, mahali pekee
ambapo Talkdesk hukisoma. Ongeza nambari hii ya uhamisho (tazama
Ongeza nambari ya uhamisho
na Vichwa ndani ya anwani ya uhamisho):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Anwani ni ile iliyo kwenye makala ya Talkdesk. Toleo 2.1 la kipengele hiki
husoma autopilot_result=; toleo 1.7 husoma escalate_to=, kwa hivyo tumia ufunguo huo kwenye
1.7. REFER inaonekana hivi:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk huweka thamani kwenye kigezo cha Studio. Ili kupata muhtasari na nia, ongeza hatua ya Tekeleza Kitendo kwenye muunganisho maalum ulioundwa kwa kutumia Connections:
- Aina ya uthibitishaji ufunguo wa API, jina la kichwa
Authorization, thamaniBearer sk_live_…. - Ombi:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ikifuatiwa na kitambulisho kutoka kwenye kigezo. Unaweza pia kutafuta simu kwaexternal_call_idukitumia kitambulisho cha mwingiliano. - Elekeza mtiririko kulingana na
handoff.intent, na umwonyeshehandoff.summarymtu anayepokea simu.
Tazama Tafuta simu iliyokabidhiwa.
Ijaribu
Anzisha simu kupitia mtiririko wa Studio, mwombe ejenti akuunganishe na mtu, na uthibitishe
kwamba mtiririko unaendelea baada ya kipengele hicho ukiwa na kitambulisho cha hand-off kwenye
kigezo chake. Kisha fungua simu kwa GET /v1/calls/{call_id}:
external_call_id inapaswa kuwa kitambulisho cha mwingiliano cha Talkdesk.
Vikomo
- Talkdesk husoma upeo wa baiti 256 za UUI na hairuhusu thamani zilizotenganishwa kwa
|au;, kwa hivyo tuma thamani moja. Kitambulisho cha hand-off kinatoshea. - API za Talkdesk haziwezi kusoma transkripti ya ejenti. Tumia utafutaji wa hand-off au
GET /v1/calls/{call_id}badala yake.