Open in
Povežite iz Genesys Cloud
Pošljite klice Genesys Cloud glasovnemu agentu ThunderPhone prek trunka BYOC Cloud z ID-jem pogovora in UUI ter jih prevzemite nazaj s predajo v UUI.
Vaš tok Architect pošlje klicatelja agentu prek povezave BYOC Cloud, z ID-jem pogovora in vsemi nastavljenimi podatki UUI. Ko klicatelj potrebuje osebo, agent pošlje SIP REFER, Genesys prevzame klic nazaj, ID predaje pa prispe v podatkih UUI klica.
Preden začnete
- Agent ThunderPhone in ključ API organizacije.
- Genesys Cloud z BYOC Cloud in zunanjo povezavo (vrste BYOC Carrier ali
PBX) z omogočenimi naslednjimi nastavitvami
(nastavitve zunanje povezave):
- Glave pogovora, da Genesys pošlje ID pogovora v
x-inin-cnv. Ta možnost je privzeto izklopljena. - Posredovanje UUI, z vrsto glave
User-To-Userin kodiranjem Hex. - Prevzem nazaj in prenos, da Genesys sprejme agentov
REFER.
- Glave pogovora, da Genesys pošlje ID pogovora v
1. Ustvarite končno točko SIP
Genesys odgovori na izziv digest, zato uporabite standardno končno točko:
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"}'Takoj shranite password iz odgovora; prikazan je samo enkrat. Na
povezavi:
| Nastavitev | Vrednost |
|---|---|
| Strežnik SIP | sip.thunderphone.com, vrata 5061 |
| Protokol | TLS |
| Preverjanje pristnosti digest | username in password končne točke |
| Kodeki | PCMU, PCMA ali G.722 |
Povezavo dodajte na izhodno pot vaše lokacije, katere načrt številk zajema naslov, ki ga kliče tok.
2. Pošiljanje klicev s kontekstom
V svojem toku Architect:
- Po želji dodajte dejanje Nastavi podatke UUI s kontekstom za agenta, na
primer
account=12345. Genesys priporoča 128 znakov ali manj. - Dodajte dejanje Prenos na številko z
sip_urikončne točke, na primersip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys pošlje ID pogovora v x-inin-cnv. ThunderPhone ga shrani kot
external_call_id klica. UUI prispe v poziv dekodiran kot
{{sip_uui}}.
Glave po meri povezave so v Genesysu statične, zato vrednosti posameznih klicev
vnesite v UUI. Genesys si zase pridržuje predpone glav x-inin, x-genesys,
x-pcv in x-gcv.
3. Prevzemite klic nazaj
Agent prenese klic z REFER na naslov v Genesysu, z ID-jem predaje kot
šestnajstiškim UUI v tem naslovu. Dodajte to številko za prenos (glejte
Dodajte številko za prenos
in Glave v naslovu za prenos):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Naslov zamenjajte z naslovom, ki usmerja nazaj v čakalno vrsto ali tok, ki mora
prevzeti klicatelja; njegovo obliko potrdite pri Genesysu. REFER je videti
takole:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
Ko je možnost Prevzem nazaj in prenos omogočena, Genesys prevzame klic
nazaj s povezave in ga usmeri na ta naslov. Genesys navaja, da dohodni UUI
prispe v Call.UUIData; tega ne dokumentira za prevzem nazaj, zato pri
Genesysu ali s preskusnim klicem potrdite, da tok, ki prejme klicatelja, tam
najde ID predaje. Za pridobitev povzetka in namena pokličite iskanje predaje z
Dejanjem podatkov klica v integraciji Data Actions spletnih storitev:
- Zahteva:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ki ji sledi ID izCall.UUIData. - Poverilnice: vaš ključ API, poslan kot
Authorization: Bearer sk_live_…. - Izhod: preslikajte
handoff.summaryinhandoff.intentv spremenljivke toka.
Glejte Poiščite predani klic.
Preizkusite
Pokličite številko, ki doseže tok, agenta prosite za osebo in preverite, ali
Genesys klic preusmeri na naslov, ki ste ga nastavili. V tem toku preverite, ali
Call.UUIData vsebuje ID predaje kot besedilo (če prikazuje šestnajstiške števke, preverite, ali je kodiranje UUI v tranku nastavljeno na Hex). Nato odprite klic z GET /v1/calls/{call_id}:
external_call_id mora biti ID pogovora.
Omejitve
- Dejanja Pridobite glave SIP preberejo samo začetni
INVITE, zato ne morejo prebrati ničesar iz agentovegaREFER. Predaja doseže Genesys samo prek UUI. - Genesys zavrže vse UUI, kadar klic vsebuje več kot eno glavo UUI.
- Naslov za prenos je omejen na 254 znakov, zato se dolg UUI skrajša, da ustreza. ID predaje se vedno prilega.