Open in
Savienojiet no Genesys Cloud
Novirziet Genesys Cloud zvanus uz ThunderPhone balss aģentu, izmantojot BYOC Cloud maģistrāli ar sarunas ID un UUI, un novirziet tos atpakaļ, izmantojot UUI pāradresāciju.
Jūsu Architect plūsma nosūta zvanītāju aģentam pa BYOC Cloud maģistrāli kopā ar
sarunas id un jebkādiem jūsu iestatītajiem UUI datiem. Kad zvanītājam ir vajadzīgs cilvēks,
aģents nosūta SIP REFER, Genesys pārņem zvanu atpakaļ, un nodošanas id
nonāk zvana UUI.
Pirms sākat
- ThunderPhone aģents un organizācijas API atslēga.
- Genesys Cloud ar BYOC Cloud un ārējo maģistrāli (tips BYOC Carrier vai
PBX), kurā ir ieslēgti šie iestatījumi
(ārējās maģistrāles iestatījumi):
- Sarunas galvenes, lai Genesys nosūtītu savas sarunas id laukā
x-inin-cnv. Pēc noklusējuma tas ir izslēgts. - UUI pārsūtīšana, ar galvenes tipu
User-To-Userun Hex kodējumu. - Atpakaļpārņemšana un pārsūtīšana, lai Genesys pieņemtu aģenta
REFER.
- Sarunas galvenes, lai Genesys nosūtītu savas sarunas id laukā
1. Izveidojiet SIP galapunktu
Genesys atbild uz digest izaicinājumu, tāpēc izmantojiet standarta galapunktu:
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"}'Nekavējoties saglabājiet atbildē saņemto password; tas tiek parādīts tikai vienreiz. Maģistrālē:
| Iestatījums | Vērtība |
|---|---|
| SIP serveris | sip.thunderphone.com, ports 5061 |
| Protokols | TLS |
| Digest autentifikācija | galapunkta username un password |
| Kodeki | PCMU, PCMA vai G.722 |
Pievienojiet maģistrāli savas vietnes izejošajam maršrutam, kura numuru plāns aptver adresi, uz kuru plūsma zvana.
2. Sūtiet zvanus ar kontekstu
Savā Architect plūsmā:
- Pēc izvēles pievienojiet darbību Iestatīt UUI datus ar aģenta kontekstu,
piemēram,
account=12345. Genesys iesaka izmantot 128 vai mazāk rakstzīmju. - Pievienojiet darbību Pārsūtīt uz numuru ar galapunkta
sip_uri, piemēram,sip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys nosūta sarunas id laukā x-inin-cnv. ThunderPhone to saglabā kā
zvana external_call_id. UUI sasniedz uzvedni atkodētā veidā kā
{{sip_uui}}.
Maģistrāles pielāgotās galvenes Genesys vidē ir statiskas, tāpēc katra zvana vērtības ievietojiet UUI.
Genesys sev rezervē galveņu prefiksus x-inin, x-genesys, x-pcv un x-gcv.
3. Saņemiet zvanu atpakaļ
Aģents pārsūta ar REFER uz Genesys adresi, kuras iekšpusē kā hex UUI ir
nodošanas id. Pievienojiet šo pārsūtīšanas numuru (skatiet
Pievienojiet pārsūtīšanas numuru
un Galvenes pārsūtīšanas adresē):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Aizstājiet adresi ar tādu, kas maršrutē atpakaļ uz rindu vai plūsmu, kurai ir
jāapkalpo zvanītājs; apstipriniet tās formu ar Genesys. REFER izskatās šādi:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
Kad ir ieslēgta Atpakaļpārņemšana un pārsūtīšana, Genesys pārņem zvanu atpakaļ no maģistrāles
un maršrutē to uz šo adresi. Genesys dokumentācijā norādīts, ka ienākošais UUI nonāk
Call.UUIData; tas nav dokumentēts atpakaļpārņemšanas gadījumam, tāpēc apstipriniet ar
Genesys vai testa zvanā, ka plūsma, kas saņem zvanītāju, tur atrod
nodošanas id. Lai iegūtu kopsavilkumu un nolūku, izsauciet nodošanas meklēšanu ar
Zvanu datu darbību Web Services Data Actions integrācijā:
- Pieprasījums:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=kam seko id noCall.UUIData. - Akreditācijas dati: jūsu API atslēga, nosūtīta kā
Authorization: Bearer sk_live_…. - Izvade: kartējiet
handoff.summaryunhandoff.intentuz plūsmas mainīgajiem.
Skatiet Meklējiet nodotu zvanu.
Pārbaudiet to
Piezvaniet uz numuru, kas sasniedz plūsmu, palūdziet aģentam savienot ar personu un pārbaudiet, vai
Genesys pārsūta zvanu uz jūsu iestatīto adresi. Šajā plūsmā pārbaudiet, vai
Call.UUIData satur nodošanas ID kā tekstu (ja tajā redzami heksadecimālie cipari, pārbaudiet, vai maģistrāles UUI kodējums ir Hex). Pēc tam atveriet zvanu ar GET /v1/calls/{call_id}:
external_call_id jābūt sarunas ID.
Ierobežojumi
- Darbība Iegūt SIP galvenes nolasa tikai sākotnējo
INVITE, tāpēc tā nevar nolasīt neko no aģentaREFER. Nodošana sasniedz Genesys tikai caur UUI. - Genesys noņem visus UUI, ja zvanam ir vairāk nekā viena UUI galvene.
- Pārsūtīšanas adrese ir ierobežota līdz 254 rakstzīmēm, tāpēc garš UUI tiek saīsināts, lai ietilptu. Nodošanas ID vienmēr ietilpst.