Open in
Yhdistä Genesys Cloudista
Ohjaa Genesys Cloud -puhelut ThunderPhone-agentille BYOC Cloud -rungon kautta keskustelutunnuksen ja UUI:n kanssa ja ota ne takaisin UUI:ssa olevan siirron avulla.
Architect-työnkulkusi ohjaa soittajan agentille BYOC Cloud -runkoyhteyden kautta
keskustelutunnuksen ja määrittämiesi UUI-tietojen kanssa. Kun soittaja tarvitsee ihmisen,
agentti lähettää SIP-REFER-pyynnön, Genesys ottaa puhelun takaisin, ja
siirtotunnus saapuu puhelun UUI-tietoihin.
Ennen aloittamista
- ThunderPhone-agentti ja organisaation API-avain.
- Genesys Cloud, jossa on BYOC Cloud, sekä ulkoinen runkoyhteys (tyyppi BYOC Carrier tai
PBX), jossa nämä asetukset ovat käytössä
(ulkoisen runkoyhteyden asetukset):
- Keskusteluotsakkeet, jotta Genesys lähettää keskustelutunnuksensa
kentässä
x-inin-cnv. Asetus on oletusarvoisesti pois käytöstä. - UUI-läpivienti, jossa otsaketyyppi on
User-To-Userja koodaus Hex. - Takaisinotto ja siirto, jotta Genesys hyväksyy agentin
REFER-pyynnön.
- Keskusteluotsakkeet, jotta Genesys lähettää keskustelutunnuksensa
kentässä
1. Luo SIP-päätepiste
Genesys vastaa digest-haasteeseen, joten käytä tavallista päätepistettä:
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"}'Tallenna vastauksen password heti; se näytetään vain kerran. Määritä
runkoyhteyteen:
| Asetus | Arvo |
|---|---|
| SIP-palvelin | sip.thunderphone.com, portti 5061 |
| Protokolla | TLS |
| Digest-todennus | päätepisteen username ja password |
| Koodekit | PCMU, PCMA tai G.722 |
Lisää runkoyhteys sivustosi lähtevälle reitille, jonka numerointisuunnitelma kattaa osoitteen, johon työnkulku soittaa.
2. Lähetä puhelut kontekstin kanssa
Architect-työnkulussasi:
- Lisää halutessasi Aseta UUI-tiedot -toiminto, johon määrität agentin kontekstin,
esimerkiksi
account=12345. Genesys suosittelee enintään 128 merkkiä. - Lisää Siirrä numeroon -toiminto, jonka arvona on päätepisteen
sip_uri, esimerkiksisip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys lähettää keskustelutunnuksen kentässä x-inin-cnv. ThunderPhone tallentaa sen
puhelun external_call_id-tunnuksena. UUI saapuu kehotteeseen purettuna muodossa
{{sip_uui}}.
Runkoyhteyden mukautetut otsakkeet ovat Genesysissä staattisia, joten sijoita puhelukohtaiset
arvot UUI-tietoihin. Genesys varaa x-inin-, x-genesys-, x-pcv- ja x-gcv-otsake-etuliitteet
omaan käyttöönsä.
3. Ota puhelu takaisin
Agentti siirtää puhelun REFER-pyynnöllä Genesysin osoitteeseen, jossa siirtotunnus on
heksadesimaalisena UUI-tietona osoitteen sisällä. Lisää tämä siirtonumero (katso
Lisää siirtonumero
ja Otsakkeet siirto-osoitteen sisällä):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Korvaa osoite osoitteella, joka reitittää takaisin jonoon tai työnkulkuun, jonka tulee
ottaa soittaja vastaan; varmista sen muoto Genesysiltä. REFER näyttää tältä:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
Kun Takaisinotto ja siirto on käytössä, Genesys ottaa puhelun takaisin runkoyhteydestä
ja reitittää sen tähän osoitteeseen. Genesys dokumentoi, että saapuva UUI tallentuu
kohteeseen Call.UUIData; se ei dokumentoi tätä takaisinoton osalta, joten varmista
Genesysiltä tai testipuhelulla, että soittajan vastaanottava työnkulku löytää
siirtotunnuksen sieltä. Saat yhteenvedon ja tarkoituksen hakemalla siirron tiedot
Puheludatatoiminnolla Web Services Data Actions -integraatiossa:
- Pyyntö:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ja sen perään tunnus kohteestaCall.UUIData. - Tunnistetiedot: API-avaimesi, joka lähetetään muodossa
Authorization: Bearer sk_live_…. - Tuloste: yhdistä
handoff.summaryjahandoff.intenttyönkulun muuttujiin.
Katso Siirretyn puhelun tietojen haku.
Testaa
Soita numeroon, joka ohjaa työnkulkuun, pyydä agentilta henkilöä ja tarkista, että
Genesys ohjaa puhelun määrittämääsi osoitteeseen. Tarkista siinä työnkulussa, että
Call.UUIData sisältää siirtotunnuksen tekstinä (jos siinä näkyy heksadesimaalinumeroita, tarkista, että
runkoyhteyden UUI-koodaus on Hex). Avaa sitten puhelu komennolla GET /v1/calls/{call_id}:
external_call_id-kentän pitäisi olla keskustelutunnus.
Rajoitukset
- Get SIP Headers -toiminto lukee vain alkuperäisen
INVITE-pyynnön, joten se ei voi lukea mitään agentinREFER-pyynnöstä. Siirto saavuttaa Genesysin vain UUI:n kautta. - Genesys hylkää kaiken UUI-datan, kun puhelussa on useampi kuin yksi UUI-otsake.
- Siirto-osoite rajoitetaan 254 merkkiin, joten pitkä UUI katkaistaan sopivaksi. Siirtotunnus mahtuu aina.