ThunderPhone v3 sasa inapatikana.Anza mwenyewe, kuanzia 2¢/dakika.Soma tangazo

Contact centers

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 kama external_call_id ya simu;
  • User-to-User, iliyosimbwa kwa heksadesimali, kama vile business_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, thamani Bearer sk_live_….
  • Ombi: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= ikifuatiwa na kitambulisho kutoka kwenye kigezo. Unaweza pia kutafuta simu kwa external_call_id ukitumia kitambulisho cha mwingiliano.
  • Elekeza mtiririko kulingana na handoff.intent, na umwonyeshe handoff.summary mtu 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.