Open in
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-Userir šešioliktainiu kodavimu. - Perėmimas atgal ir perdavimas, kad Genesys priimtų agento
REFER.
- Pokalbio antraštės, kad Genesys siųstų savo pokalbio ID per
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:
| Nustatymas | Reikšmė |
|---|---|
| SIP serveris | sip.thunderphone.com, prievadas 5061 |
| Protokolas | TLS |
| Santraukos autentifikavimas | galinio taško username ir password |
| Kodekai | PCMU, 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:
- Pasirinktinai pridėkite veiksmą Nustatyti UUI duomenis su agentui skirtu kontekstu, pavyzdžiui,
account=12345. Genesys rekomenduoja naudoti ne daugiau kaip 128 simbolius. - 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.summaryirhandoff.intentsu 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š agentoREFER. 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.