ThunderPhone v3 on julkaistu.Ota käyttöön itse – alkaen 2 ¢/min.Lue lisää julkistuksesta

Contact centers

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-User ja koodaus Hex.
    • Takaisinotto ja siirto, jotta Genesys hyväksyy agentin REFER-pyynnön.

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:

AsetusArvo
SIP-palvelinsip.thunderphone.com, portti 5061
ProtokollaTLS
Digest-todennuspäätepisteen username ja password
KoodekitPCMU, 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:

  1. Lisää halutessasi Aseta UUI-tiedot -toiminto, johon määrität agentin kontekstin, esimerkiksi account=12345. Genesys suosittelee enintään 128 merkkiä.
  2. Lisää Siirrä numeroon -toiminto, jonka arvona on päätepisteen sip_uri, esimerkiksi sip: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 kohteesta Call.UUIData.
  • Tunnistetiedot: API-avaimesi, joka lähetetään muodossa Authorization: Bearer sk_live_….
  • Tuloste: yhdistä handoff.summary ja handoff.intent työ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 agentin REFER-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.