ThunderPhone v3 este disponibil.Self-service, de la 2 ¢/min.Citiți anunțul

Contact centers

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.

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:

SetareValoare
Server SIPsip.thunderphone.com, portul 5061
ProtocolTLS
Autentificare digestusername și password ale endpointului
Codec-uriPCMU, 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:

  1. 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.
  2. Adăugați o acțiune Transferați către număr cu sip_uri al endpointului, de exemplu sip: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 din Call.UUIData.
  • Credențiale: cheia dumneavoastră API, trimisă ca Authorization: Bearer sk_live_….
  • Ieșire: mapați handoff.summary și handoff.intent la 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 INVITE inițial, deci nu poate citi nimic din REFER al 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.