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

Contact centers

Unganisha kutoka Zoom Contact Center

Tuma simu za Zoom Contact Center kwa ejenti wa ThunderPhone ukitumia kiunganishi cha voicebot cha wahusika wengine, kisha zirudishe kwa ejenti wa kibinadamu kwa SIP REFER.

Wijeti ya Bot katika mtiririko wako wa Zoom Contact Center humtuma mpigaji kwa ejenti pamoja na sid ya simu ya Zoom. Mpigaji anapohitaji mtu, ejenti hutuma SIP REFER kwa anwani ya mwakilishi wa kibinadamu wa Zoom, na mtiririko wako hupata uhamishaji kwa sid ya simu.

Kabla ya kuanza

  • Ejenti wa ThunderPhone na ufunguo wa API wa shirika.
  • General App ya Zoom Marketplace, inayosimamiwa na msimamizi wako na kupatikana kwa Contact Center, yenye kiunganishi cha wijeti ya Bot (mwongozo wa Zoom wa voicebot wa wahusika wengine).
  • SIP trunk kutoka Zoom kwenda kwa mtoa huduma wa bot. Timu ya ISV ya Zoom huiunda kwa hatua (ugunduzi, trunk ya majaribio, kisha uzalishaji), na Jina la Kampuni la programu lazima lilingane kabisa na rekodi ya trunk. Usanidi huu huanza na usaidizi wa ThunderPhone na Zoom, si katika akaunti yako ya Zoom pekee.

1. Unda endpoint ya SIP

Kiunganishi cha Zoom hupiga nambari ya tarakimu 15 inayoanza na 999, si anwani ya SIP. Kuhifadhi kiunganishi hutengeneza nambari hiyo. Trunk ya Zoom hutumia TLS 1.2 kwenye porti 5061 pamoja na SRTP kwa sauti, na huruhusiwa kupitia orodha kwa mitandao midogo ya Zoom badala ya nenosiri. Kwa hiyo unda endpoint ya ip_allowlist yenye nambari ya kiunganishi kama nambari ya kupiga na SRTP inayohitajika (tazama Majukwaa yanayopiga nambari ya simu):

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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs: mitandao midogo ya uashiriaji ya SIP ya Zoom, inayotolewa na Zoom. Kila moja lazima iwe safu ya IPv4 ya umma ya /16 au nyembamba zaidi (IPv6 /48 au nyembamba zaidi).
  • dial_in_numbers: nambari ya kiunganishi hasa jinsi Zoom inavyoituma, bila +.
  • srtp: required, kwa kuwa trunk ya Zoom hutumia SRTP kila wakati.

Anwani za Zoom hutumiwa kwa pamoja na wateja wake wote, kwa hiyo mteja mwingine yeyote wa Zoom anayepiga nambari hiyo humfikia ejenti wako. Zoom huweka nambari hiyo; usiichapishe.

2. Tuma simu pamoja na muktadha

Ongeza wijeti ya Bot kwenye mtiririko wako na uiunganishe na kiunganishi. Iombe timu ya ISV ya Zoom ielekeze trunk kwenye sip.thunderphone.com, TLS kwenye porti 5061, pamoja na nambari ya kiunganishi katika URI ya ombi na kichwa cha To. Endpoint inakataa UDP, kwa hiyo hakikisha trunk hairudi kuitumia.

Zoom hutuma:

  • X-ZOOM-Call-Sid, inayohifadhiwa kama external_call_id ya simu. Ukurasa wa Zoom wa upangaji wa data hauiorodheshi; muunganisho wa Zoom wa mtoa huduma mwingine wa AI unaieleza kwenye nyaraka, kwa hiyo iangalie kwenye simu yako ya kwanza ya majaribio.
  • X-ZOOM-DNIS, nambari aliyopiga mpigaji, kama {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, URL Tuli ya kiunganishi.

3. Pokea simu iliyorejeshwa

Ejenti hutuma REFER kwa anwani ya ejenti wa kibinadamu kwenye SBC ya Zoom. Ongeza nambari hii ya uhamisho (tazama Ongeza nambari ya uhamisho), kwa kutumia anwani ya SBC unayopewa na Zoom:

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

Mwongozo wa Zoom unaeleza njia mbili ambazo bot hupitisha muktadha: POST kwa URL tuli ya kiunganishi kabla ya REFER (matukio ya voicebot_metadata na yanayofanana), na vichwa vya SIP vilivyopangwa chini ya Inayoingia kutoka kwa Bot. ThunderPhone haitumi POST kwa URL tuli. Mwongozo wa Zoom hauelezi ikiwa inasoma vichwa vilivyopangwa kutoka kwa REFER; ikiwa unataka kujaribu, ongeza headers kama vile "X-Handoff-Id": "{{handoff_id}}" kwenye ingizo na uangalie kwenye simu ya majaribio. Pia thibitisha na Zoom kwamba inakubali REFER isiyo na POST ya metadata kabla yake.

Ili kupata uhamisho bila kutegemea mojawapo ya njia hizo, fanya mtiririko wako uutafute baada ya wijeti ya Bot, kwa wijeti ya Simu ya HTTP au Hati:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ikifuatiwa na SID ya simu.
  • Kichwa Authorization: Bearer sk_live_….
  • Tumia handoff.summary na handoff.intent kumwelekeza mpigaji simu na kumpa muhtasari mtu anayepokea simu.

Zoom haichapishi hati za kila sehemu za wijeti hizi, kwa hivyo thibitisha kwenye akaunti yako kwamba wijeti inaweza kutuma kichwa cha Authorization. Tazama Tafuta simu iliyohamishwa.

Ijaribu

Piga nambari inayofikia wijeti ya Bot, mwombe ejenti akuhamishe kwa mtu, na hakikisha kwamba mpigaji simu anamfikia ejenti wa kibinadamu na wijeti inarejesha uhamisho. Kisha fungua simu kwa GET /v1/calls/{call_id}: sip_headers inapaswa kuorodhesha x-zoom-call-sid, na external_call_id inapaswa kulingana na SID ya simu inayotumiwa na mtiririko wako.

Vikomo

  • ThunderPhone haitumi POST kwa URL tuli ya kiunganishi, kwa hivyo Zoom hupata uhamisho kupitia utafutaji, au kupitia vichwa vilivyopangwa ikiwa jaribio lako linaonyesha kwamba Zoom huvvisoma kutoka kwa REFER.
  • Tranki imeundwa na timu ya ISV ya Zoom, kwa hivyo huwezi kuisanidi au kuijaribu mwenyewe.