Ühenda Genesys Cloudist

Suuna Genesys Cloudi kõned ThunderPhone

Sinu Architecti voog saadab helistaja agendile BYOC Cloudi trunki kaudu koos vestluse ID ja sinu määratud UUI-ga. Kui helistaja vajab inimest, saadab agent SIP-i REFER, Genesys võtab kõne tagasi ja üleandmise ID jõuab kõne UUI-sse.

Enne alustamist#

• ThunderPhone'i agent ja organisatsiooni API-võti.
• Genesys Cloud koos BYOC Cloudiga ning väline trunk (tüüp BYOC Carrier või PBX), kus on sisse lülitatud järgmised seaded (välise trunki seaded):
  • Vestluse päised, et Genesys saadaks oma vestluse ID väljal x-inin-cnv. See on vaikimisi välja lülitatud.
  • UUI edastamine, päisetüübiga User-To-User ja Hex-kodeeringuga.
  • Tagasivõtmine ja edastamine, et Genesys aktsepteeriks agendi REFER-i.

1. Loo SIP-lõpp-punkt#

Genesys vastab Digest-kutsele, seega kasuta standardset lõpp-punkti:

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"}'

Salvesta vastusest saadud password kohe; seda kuvatakse ainult ühe korra. Trunkis:

Lisa trunk oma saidi väljaminevale marsruudile, mille numeratsiooniplaan katab aadressi, millele voog helistab.

2. Saada kõned koos kontekstiga#

Oma Architecti voos:

1. Soovi korral lisa agendi jaoks kontekstiga Määra UUI-andmed toiming, näiteks account=12345. Genesys soovitab kasutada kuni 128 tähemärki.
2. Lisa Edasta numbrile toiming lõpp-punkti sip_uri-ga, näiteks sip:agent-12-jhxmginwjx@sip.thunderphone.com.

Genesys saadab vestluse ID väljal x-inin-cnv. ThunderPhone salvestab selle kõne external_call_id-na. UUI jõuab viibani dekodeeritult väljana {{sip_uui}}.

Trunki kohandatud päised on Genesyses staatilised, seega paiguta kõnepõhised väärtused UUI-sse. Genesys reserveerib endale päiseliited x-inin, x-genesys, x-pcv ja x-gcv.

3. Võta kõne tagasi#

Agent edastab kõne REFER-iga Genesyses olevale aadressile, mille sees on üleandmise ID kuueteistkümnendkoodis UUI-na. Lisa see edastusnumber (vaata Edastusnumbri lisamine ja Päised edastusaadressis):

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

Asenda aadress sellisega, mis suunab tagasi järjekorda või voogu, mis peab helistaja vastu võtma; kinnita selle vorm Genesysega. REFER näeb välja selline:

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

Kui Tagasivõtmine ja edastamine on sisse lülitatud, võtab Genesys kõne trunkilt tagasi ja suunab selle sellele aadressile. Genesys dokumenteerib, et sissetulev UUI jõuab väljale Call.UUIData; tagasivõtmise kohta seda ei dokumenteerita, seega kinnita Genesysega või testkõnes, et helistaja vastu võttev voog leiab sealt üleandmise ID. Kokkuvõtte ja kavatsuse saamiseks kutsu üleandmise otsingut Kõne andmetoimingu abil integratsioonis Web Services Data Actions:

• Päring: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=, millele järgneb Call.UUIData ID.
• Tuvastamisandmed: sinu API-võti, saadetud kujul Authorization: Bearer sk_live_….
• Väljund: seo handoff.summary ja handoff.intent voo muutujatega.

Vaata Üle antud kõne otsimine.

Testi#

Helista numbrile, mis suunab kõne voogu, palu agendilt inimest ja kontrolli, et Genesys suunab kõne sinu määratud aadressile. Selles voos kontrolli, et Call.UUIData sisaldab üleandmise ID-d tekstina (kui kuvatakse kuueteistkümnendsüsteemi numbrid, kontrolli, et trunk'i UUI kodeering on Hex). Seejärel ava kõne käsuga GET /v1/calls/{call_id}: external_call_id peaks olema vestluse ID.

Piirangud#

• Toiming Hangi SIP-päised loeb ainult algset INVITE-i, seega ei saa see agendi REFER-ist midagi lugeda. Üleandmine jõuab Genesysesse ainult UUI kaudu.
• Genesys eemaldab kogu UUI, kui kõnel on rohkem kui üks UUI-päis.
• Edastusaadress on piiratud 254 tähemärgiga, seega pikk UUI kärbitakse sobivaks. Üleandmise ID mahub alati ära.