ThunderPhone v3 jau veikia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą

Contact centers

Prijunkite iš Zoom Contact Center

Nukreipkite Zoom Contact Center skambučius į ThunderPhone agentą naudodami trečiosios šalies balso boto jungtį ir grąžinkite juos žmogaus agentui naudodami SIP REFER.

„Bot“ valdiklis jūsų Zoom kontaktų centro sraute perduoda skambinantį asmenį agentui su Zoom skambučio SID. Kai skambinančiajam reikia žmogaus pagalbos, agentas siunčia SIP REFER į Zoom žmogaus konsultanto adresą, o jūsų srautas gauna perdavimą pagal skambučio SID.

Prieš pradėdami

  • ThunderPhone agentas ir organizacijos API raktas.
  • Zoom Marketplace bendroji programėlė, administruojama jūsų administratoriaus ir prieinama kontaktų centrui, su „Bot“ valdiklio jungtimi (Zoom trečiųjų šalių balso roboto vadovas).
  • SIP magistralė iš Zoom į balso roboto paslaugų teikėją. Zoom ISV komanda ją kuria etapais (poreikių analizė, testavimo magistralė, tada produkcinė magistralė), o programėlės įmonės pavadinimas turi tiksliai sutapti su magistralės įrašu. Ši sąranka pradedama su ThunderPhone palaikymo komanda ir Zoom, ne vien jūsų Zoom paskyroje.

1. Sukurkite SIP galinį tašką

Zoom jungtis surenka 15 skaitmenų numerį, prasidedantį 999, o ne SIP adresą. Išsaugojus jungtį sugeneruojamas šis numeris. Zoom magistralė naudoja TLS 1.2 5061 prievade su SRTP garsui, o prieiga ribojama pagal Zoom potinklius, o ne slaptažodžiu. Todėl sukurkite ip_allowlist galinį tašką su jungties numeriu kaip įeinamuoju numeriu ir privalomu SRTP (žr. Platformos, kurios surenka telefono numerį):

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: Zoom SIP signalizavimo potinkliai, gauti iš Zoom. Kiekvienas turi būti viešas /16 arba siauresnis IPv4 diapazonas (IPv6 /48 arba siauresnis).
  • dial_in_numbers: jungties numeris tiksliai toks, kokį siunčia Zoom, be +.
  • srtp: required, nes Zoom magistralė visada naudoja SRTP.

Zoom adresai bendri visiems jo klientams, todėl bet kuris kitas Zoom klientas, surinkęs numerį, pasieks jūsų agentą. Zoom priskiria numerį; neskelbkite jo.

2. Siųskite skambučius su kontekstu

Pridėkite Bot valdiklį prie savo srauto ir susiekite jį su jungtimi. Paprašykite Zoom ISV komandos nukreipti magistralę į sip.thunderphone.com, naudojant TLS 5061 prievade, su jungties numeriu ir užklausos URI, ir To antraštėje. Galinis taškas atmeta UDP, todėl įsitikinkite, kad magistralė negrįžta prie jo.

Zoom siunčia:

  • X-ZOOM-Call-Sid, saugomą kaip skambučio external_call_id. Zoom duomenų susiejimo puslapyje jis nenurodomas; jį dokumentuoja kito DI paslaugų teikėjo Zoom integracija, todėl patikrinkite jį per pirmąjį bandomąjį skambutį.
  • X-ZOOM-DNIS, skambinančiojo surinktą numerį, kaip {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, jungties statinį URL.

3. Susigrąžinkite skambutį

Agentas siunčia REFER į žmogaus konsultanto adresą Zoom SBC. Pridėkite šį peradresavimo numerį (žr. Pridėkite peradresavimo numerį), nurodydami Zoom pateiktą SBC adresą:

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

Zoom vadove aprašomi du būdai, kaip botas perduoda kontekstą: POST į jungties Static URL prieš REFER (įvykiai voicebot_metadata ir panašūs) bei SIP antraštės, susietos dalyje Įeinantys iš roboto. ThunderPhone nesiunčia duomenų į Static URL. Zoom vadove nenurodyta, ar jis nuskaito susietas antraštes iš REFER; jei norite pabandyti, prie įrašo pridėkite headers, pvz., "X-Handoff-Id": "{{handoff_id}}", ir patikrinkite bandomuoju skambučiu. Taip pat su Zoom patvirtinkite, kad jis priima REFER be metaduomenų POST prieš jį.

Norėdami gauti perdavimą nepasikliaudami nė vienu iš šių būdų, po Bot valdiklio nustatykite, kad srautas jo ieškotų naudodamas HTTP užklausos arba Scenarijaus valdiklį:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ir po jo nurodykite skambučio sid.
  • Antraštė Authorization: Bearer sk_live_….
  • Naudokite handoff.summary ir handoff.intent, kad nukreiptumėte skambinantįjį ir informuotumėte skambutį perimantį asmenį.

Zoom neskelbia išsamios laukų dokumentacijos šiems valdikliams, todėl savo paskyroje patvirtinkite, kad valdiklis gali siųsti Authorization antraštę. Žr. Raskite perduotą skambutį.

Išbandykite

Skambinkite numeriu, kuris nukreipia į Bot valdiklį, paprašykite agento sujungti su žmogumi ir patikrinkite, ar skambinantysis pasiekia žmogaus konsultantą ir ar valdiklis grąžina perdavimą. Tada atidarykite skambutį naudodami GET /v1/calls/{call_id}: sip_headers turėtų nurodyti x-zoom-call-sid, o external_call_id turėtų atitikti skambučio sid, kurį naudoja jūsų srautas.

Ribojimai

  • ThunderPhone nesiunčia duomenų į jungties Static URL, todėl Zoom gauna perdavimą per paiešką arba per susietas antraštes, jei jūsų bandymas rodo, kad Zoom jas nuskaito iš REFER.
  • SIP magistralę kuria Zoom ISV komanda, todėl negalite jos patys sukonfigūruoti ar išbandyti.