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

Contact centers

Prijunkite iš Genesys Cloud

Nukreipkite Genesys Cloud skambučius į ThunderPhone agentą per BYOC Cloud magistralę su pokalbio ID ir UUI, o perduodami atgal įtraukite perdavimą į UUI.

Jūsų Architect srautas per BYOC Cloud magistralę nukreipia skambintoją agentui, perduodamas pokalbio ID ir bet kokius jūsų nustatytus UUI duomenis. Kai skambintojui reikia žmogaus, agentas siunčia SIP REFER, Genesys perima skambutį atgal, o perdavimo ID pateikiamas skambučio UUI duomenyse.

Prieš pradedant

  • ThunderPhone agentas ir organizacijos API raktas.
  • Genesys Cloud su BYOC Cloud ir išorine magistrale (tipo BYOC tiekėjas arba PBX), kurioje įjungti šie nustatymai (išorinės magistralės nustatymai):
    • Pokalbio antraštės, kad Genesys siųstų savo pokalbio ID per x-inin-cnv. Pagal numatytuosius nustatymus ši parinktis išjungta.
    • UUI perdavimas, su antraštės tipu User-To-User ir šešioliktainiu kodavimu.
    • Perėmimas atgal ir perdavimas, kad Genesys priimtų agento REFER.

1. Sukurkite SIP galinį tašką

Genesys atsako į santraukos autentifikavimo užklausą, todėl naudokite standartinį galinį tašką:

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": "Genesys Cloud"}'

Iš karto išsaugokite atsakyme pateiktą password; jis rodomas tik vieną kartą. Magistralėje:

NustatymasReikšmė
SIP serverissip.thunderphone.com, prievadas 5061
ProtokolasTLS
Santraukos autentifikavimasgalinio taško username ir password
KodekaiPCMU, PCMA arba G.722

Priskirkite magistralę savo svetainės išeinančiam maršrutui, kurio numeravimo planas apima adresą, kuriuo skambina srautas.

2. Siųskite skambučius su kontekstu

Architect sraute:

  1. Pasirinktinai pridėkite veiksmą Nustatyti UUI duomenis su agentui skirtu kontekstu, pavyzdžiui, account=12345. Genesys rekomenduoja naudoti ne daugiau kaip 128 simbolius.
  2. Pridėkite veiksmą Peradresuoti į numerį su galinio taško sip_uri, pavyzdžiui, sip:agent-12-jhxmginwjx@sip.thunderphone.com.

Genesys siunčia pokalbio ID per x-inin-cnv. ThunderPhone jį išsaugo kaip skambučio external_call_id. UUI duomenys iškoduoti pasiekia raginimą kaip {{sip_uui}}.

Pasirinktinės magistralės antraštės Genesys sistemoje yra statinės, todėl kiekvieno skambučio reikšmes įtraukite į UUI. Genesys sau pasilieka antraščių priešdėlius x-inin, x-genesys, x-pcv ir x-gcv.

3. Perimkite skambutį atgal

Agentas perduoda skambutį su REFER į Genesys adresą, o perdavimo ID tame adrese pateikiamas kaip šešioliktainiai UUI duomenys. Pridėkite šį perdavimo numerį (žr. Pridėti perdavimo numerį ir Antraštės perdavimo adrese):

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Pakeiskite adresą tokiu, kuris nukreipia atgal į eilę arba srautą, turintį priimti skambintoją; jo formatą patvirtinkite su Genesys. REFER atrodo taip:

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

Įjungus Perėmimą atgal ir perdavimą, Genesys perima skambutį atgal iš magistralės ir nukreipia jį į tą adresą. Genesys dokumentacijoje nurodyta, kad gaunami UUI duomenys pateikiami Call.UUIData; tai nėra dokumentuota skambučio perėmimo atgal atveju, todėl patvirtinkite su Genesys arba per bandomąjį skambutį, kad skambintoją priimantis srautas ten randa perdavimo ID. Norėdami gauti santrauką ir ketinimą, atlikite perdavimo paiešką naudodami Skambučio duomenų veiksmą integracijoje Web Services Data Actions:

  • Užklausa: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= ir po jos pridėkite ID iš Call.UUIData.
  • Prisijungimo duomenys: jūsų API raktas, siunčiamas kaip Authorization: Bearer sk_live_….
  • Išvestis: susiekite handoff.summary ir handoff.intent su srauto kintamaisiais.

Žr. Perduoto skambučio paieška.

Išbandykite

Paskambinkite numeriu, kuris pasiekia srautą, paprašykite agento sujungti su asmeniu ir patikrinkite, ar Genesys nukreipia skambutį į jūsų nustatytą adresą. Tame sraute patikrinkite, ar Call.UUIData kaip tekstą saugo perdavimo id (jei rodomi šešioliktainiai skaitmenys, patikrinkite, ar magistralės UUI kodavimas yra Hex). Tada atidarykite skambutį naudodami GET /v1/calls/{call_id}: external_call_id turi būti pokalbio id.

Apribojimai

  • Veiksmas Get SIP Headers nuskaito tik pradinį INVITE, todėl jis negali nuskaityti nieko iš agento REFER. Perdavimas Genesys pasiekia tik per UUI.
  • Genesys atmeta visus UUI, kai skambutyje yra daugiau nei viena UUI antraštė.
  • Perkėlimo adresas ribojamas iki 254 simbolių, todėl ilgas UUI sutrumpinamas, kad tilptų. Perdavimo id visada telpa.