Open in
Povežite se iz Genesys Clouda
Šaljite pozive iz Genesys Clouda glasovnom agentu ThunderPhone putem BYOC Cloud trunka s ID-jem razgovora i UUI-jem te ih preuzmite natrag s predajom u UUI-ju.
Vaš Architect tok šalje pozivatelja agentu preko BYOC Cloud trunka, zajedno s ID-jem razgovora i svim UUI podacima koje postavite. Kada pozivatelj treba osobu, agent šalje SIP REFER, Genesys preuzima poziv natrag, a ID predaje stiže u UUI podacima poziva.
Prije početka
- ThunderPhone agent i organizacijski API ključ.
- Genesys Cloud s BYOC Cloudom i vanjskim trunkom (vrsta BYOC Carrier ili
PBX) s uključenim sljedećim postavkama
(postavke vanjskog trunka):
- Zaglavlja razgovora, kako bi Genesys slao svoj ID razgovora u
x-inin-cnv. Ta je postavka prema zadanim postavkama isključena. - Prosljeđivanje UUI podataka, s vrstom zaglavlja
User-To-Useri kodiranjem Hex. - Preuzimanje natrag i prijenos, kako bi Genesys prihvatio agentov
REFER.
- Zaglavlja razgovora, kako bi Genesys slao svoj ID razgovora u
1. Izradite SIP krajnju točku
Genesys odgovara na digest izazov, stoga upotrijebite standardnu krajnju točku:
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"}'Odmah spremite password iz odgovora; prikazuje se samo jednom. Na trunku:
| Postavka | Vrijednost |
|---|---|
| SIP poslužitelj | sip.thunderphone.com, port 5061 |
| Protokol | TLS |
| Digest autentikacija | username i password krajnje točke |
| Kodeci | PCMU, PCMA ili G.722 |
Postavite trunk na odlaznu rutu svoje lokacije čiji plan brojeva obuhvaća adresu koju tok bira.
2. Šaljite pozive s kontekstom
U svom Architect toku:
- Prema potrebi dodajte radnju Postavi UUI podatke s kontekstom za agenta,
kao što je
account=12345. Genesys preporučuje 128 znakova ili manje. - Dodajte radnju Prijenos na broj s
sip_urikrajnje točke, na primjersip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys šalje ID razgovora u x-inin-cnv. ThunderPhone ga pohranjuje kao
external_call_id poziva. UUI podaci stižu u prompt dekodirani, kao
{{sip_uui}}.
Prilagođena zaglavlja trunka statična su u Genesysu, stoga vrijednosti po pozivu
stavite u UUI podatke. Genesys za sebe rezervira prefikse zaglavlja x-inin,
x-genesys, x-pcv i x-gcv.
3. Preuzmite poziv natrag
Agent prenosi poziv pomoću REFER na adresu u Genesysu, s ID-jem predaje kao
heksadekadskim UUI podacima unutar te adrese. Dodajte ovaj broj za prijenos
(pogledajte Dodajte broj za prijenos
i Zaglavlja unutar adrese za prijenos):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Zamijenite adresu onom koja usmjerava natrag na red čekanja ili tok koji treba
preuzeti pozivatelja; potvrdite njezin oblik s Genesysom. REFER izgleda ovako:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
Uz uključenu postavku Preuzimanje natrag i prijenos, Genesys preuzima poziv
natrag s trunka i usmjerava ga na tu adresu. Genesys navodi da se dolazni UUI
podaci nalaze u Call.UUIData; to ne navodi za preuzimanje natrag, stoga s
Genesysom ili na testnom pozivu potvrdite da tok koji prima pozivatelja ondje
pronalazi ID predaje. Za dohvaćanje sažetka i namjere pozovite pretraživanje
predaje pomoću radnje Podaci poziva u integraciji Web Services Data Actions:
- Zahtjev:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=nakon čega slijedi ID izCall.UUIData. - Vjerodajnice: vaš API ključ, poslan kao
Authorization: Bearer sk_live_…. - Izlaz: mapirajte
handoff.summaryihandoff.intentna varijable toka.
Pogledajte Potražite predani poziv.
Testirajte
Nazovite broj koji vodi do toka, zatražite od agenta osobu i provjerite prenosi li
Genesys poziv na adresu koju ste postavili. U tom toku provjerite sadrži li
Call.UUIData ID predaje kao tekst (ako prikazuje heksadecimalne znamenke, provjerite je li UUI kodiranje trunk veze postavljeno na Hex). Zatim otvorite poziv pomoću GET /v1/calls/{call_id}:
external_call_id trebao bi biti ID razgovora.
Ograničenja
- Radnja Dohvaćanje SIP zaglavlja čita samo početni
INVITE, stoga ne može pročitati ništa iz agentovaREFER. Predaja stiže do Genesysa samo putem UUI-ja. - Genesys odbacuje sav UUI kada poziv sadrži više od jednog UUI zaglavlja.
- Adresa za prijenos ograničena je na 254 znaka, pa se dugi UUI skraćuje da bi stao. ID predaje uvijek stane.