Open in
Conectați-vă din Genesys Cloud
Trimiteți apelurile Genesys Cloud către un agent ThunderPhone printr-un trunk BYOC Cloud cu ID-ul conversației și UUI, apoi preluați-le înapoi cu transferul în UUI.
Fluxul Architect trimite apelantul către agent printr-un trunchi BYOC Cloud, împreună cu ID-ul conversației și orice UUI setați. Când apelantul are nevoie de o persoană, agentul trimite un REFER SIP, Genesys preia apelul înapoi, iar ID-ul de preluare ajunge în UUI-ul apelului.
Înainte de a începe
- Un agent ThunderPhone și o cheie API pentru organizație.
- Genesys Cloud cu BYOC Cloud și un trunchi extern (de tip BYOC Carrier sau
PBX) cu aceste setări activate
(setări pentru trunchi extern):
- Antete de conversație, pentru ca Genesys să trimită ID-ul conversației în
x-inin-cnv. Este dezactivat implicit. - Transmitere UUI, cu tipul de antet
User-To-Userși codificarea Hex. - Preluare înapoi și transfer, pentru ca Genesys să accepte
REFER-ul agentului.
- Antete de conversație, pentru ca Genesys să trimită ID-ul conversației în
1. Creați endpointul SIP
Genesys răspunde la o solicitare digest, așa că utilizați un endpoint standard:
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"}'Salvați imediat password din răspuns; este afișată o singură dată. Pe
trunchi:
| Setare | Valoare |
|---|---|
| Server SIP | sip.thunderphone.com, portul 5061 |
| Protocol | TLS |
| Autentificare digest | username și password ale endpointului |
| Codec-uri | PCMU, PCMA sau G.722 |
Adăugați trunchiul la o rută de ieșire a site-ului dumneavoastră, al cărei plan de numerotație acoperă adresa apelată de flux.
2. Trimiteți apeluri cu context
În fluxul Architect:
- Opțional, adăugați o acțiune Setați date UUI cu context pentru agent, cum
ar fi
account=12345. Genesys recomandă cel mult 128 de caractere. - Adăugați o acțiune Transferați către număr cu
sip_urial endpointului, de exemplusip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys trimite ID-ul conversației în x-inin-cnv. ThunderPhone îl stochează ca
external_call_id al apelului. UUI-ul ajunge decodificat în prompt, ca
{{sip_uui}}.
Antetele personalizate ale trunchiului sunt statice în Genesys, așa că includeți
valorile pentru fiecare apel în UUI. Genesys rezervă pentru uz propriu prefixele
de antet x-inin, x-genesys, x-pcv și x-gcv.
3. Preluați apelul înapoi
Agentul transferă cu un REFER către o adresă din Genesys, cu ID-ul de preluare
ca UUI hex în acea adresă. Adăugați acest număr de transfer (consultați
Adăugați numărul de transfer
și Antete în adresa de transfer):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Înlocuiți adresa cu una care direcționează înapoi către coada sau fluxul care
trebuie să preia apelantul; confirmați formatul acesteia cu Genesys. REFER
arată astfel:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
Cu Preluare înapoi și transfer activată, Genesys preia apelul înapoi din
trunchi și îl direcționează către acea adresă. Genesys documentează că UUI-ul
primit ajunge în Call.UUIData; nu documentează acest lucru pentru o preluare
înapoi, așa că confirmați cu Genesys sau printr-un apel de test că fluxul care
primește apelantul găsește acolo ID-ul de preluare. Pentru a obține rezumatul și
intenția, apelați căutarea preluării cu o Acțiune de date apel într-o
integrare Web Services Data Actions:
- Cerere:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=urmată de ID-ul dinCall.UUIData. - Credențiale: cheia dumneavoastră API, trimisă ca
Authorization: Bearer sk_live_…. - Ieșire: mapați
handoff.summaryșihandoff.intentla variabilele fluxului.
Consultați Căutați un apel preluat.
Testați
Apelați un număr care ajunge în flux, cereți agentului o persoană și verificați că
Genesys direcționează apelul către adresa setată. În acel flux, verificați că
Call.UUIData conține ID-ul de predare ca text (dacă afișează cifre hexazecimale, verificați dacă codarea UUI a trunkului este Hex). Apoi deschideți apelul cu GET /v1/calls/{call_id}:
external_call_id ar trebui să fie ID-ul conversației.
Limitări
- Acțiunea Obține antetele SIP citește doar
INVITEinițial, deci nu poate citi nimic dinREFERal agentului. Predarea ajunge la Genesys numai prin UUI. - Genesys elimină toate datele UUI atunci când un apel conține mai mult de un antet UUI.
- Adresa de transfer este limitată la 254 de caractere, astfel încât un UUI lung este trunchiat pentru a se încadra. Un ID de predare se încadrează întotdeauna.