ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Contact centers

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-User i kodiranjem Hex.
    • Preuzimanje natrag i prijenos, kako bi Genesys prihvatio agentov REFER.

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:

PostavkaVrijednost
SIP poslužiteljsip.thunderphone.com, port 5061
ProtokolTLS
Digest autentikacijausername i password krajnje točke
KodeciPCMU, 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:

  1. Prema potrebi dodajte radnju Postavi UUI podatke s kontekstom za agenta, kao što je account=12345. Genesys preporučuje 128 znakova ili manje.
  2. Dodajte radnju Prijenos na broj s sip_uri krajnje točke, na primjer sip: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 iz Call.UUIData.
  • Vjerodajnice: vaš API ključ, poslan kao Authorization: Bearer sk_live_….
  • Izlaz: mapirajte handoff.summary i handoff.intent na 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 agentova REFER. 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.