ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Contact centers

Pripojenie z Genesys Cloud

Odosielajte hovory z Genesys Cloud hlasovému agentovi ThunderPhone cez trunk BYOC Cloud s ID konverzácie a UUI a prevezmite ich späť s odovzdaním v UUI.

Váš tok Architect odošle volajúceho hlasovému agentovi cez trunk BYOC Cloud spolu s ID konverzácie a všetkými nastavenými údajmi UUI. Keď volajúci potrebuje človeka, agent odošle SIP REFER, Genesys prevezme hovor späť a ID odovzdania príde v UUI hovoru.

Skôr než začnete

  • Agent ThunderPhone a kľúč API organizácie.
  • Genesys Cloud s BYOC Cloud a externý trunk (typ BYOC Carrier alebo PBX) s povolenými týmito nastaveniami (nastavenia externého trunku):
    • Hlavičky konverzácie, aby Genesys odosielal ID konverzácie v x-inin-cnv. Predvolene je vypnuté.
    • Prechod UUI, s typom hlavičky User-To-User a kódovaním Hex.
    • Prevzatie späť a prenos, aby Genesys prijal agentov REFER.

1. Vytvorte koncový bod SIP

Genesys odpovedá na výzvu digest, preto použite štandardný koncový bod:

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"}'

Heslo password z odpovede si ihneď uložte; zobrazí sa iba raz. Na trunku:

NastavenieHodnota
Server SIPsip.thunderphone.com, port 5061
ProtokolTLS
Digest autentifikáciausername a password koncového bodu
KodekyPCMU, PCMA alebo G.722

Priraďte trunk k odchádzajúcej trase svojej lokality, ktorej číslovací plán pokrýva adresu, na ktorú tok vytáča.

2. Odosielanie hovorov s kontextom

Vo svojom toku Architect:

  1. Voliteľne pridajte akciu Nastaviť údaje UUI s kontextom pre agenta, napríklad account=12345. Genesys odporúča najviac 128 znakov.
  2. Pridajte akciu Preniesť na číslo s sip_uri koncového bodu, napríklad sip:agent-12-jhxmginwjx@sip.thunderphone.com.

Genesys odošle ID konverzácie v x-inin-cnv. ThunderPhone ho uloží ako external_call_id hovoru. UUI dorazí do výzvy dekódované ako {{sip_uui}}.

Vlastné hlavičky trunku sú v Genesys statické, preto hodnoty pre jednotlivé hovory vkladajte do UUI. Genesys si pre seba vyhradzuje predpony hlavičiek x-inin, x-genesys, x-pcv a x-gcv.

3. Prevezmite hovor späť

Agent prenesie hovor pomocou REFER na adresu v Genesys, pričom ID odovzdania je ako hexadecimálny UUI v tejto adrese. Pridajte toto číslo na prenos (pozrite si Pridanie čísla na prenos a Hlavičky v adrese na prenos):

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Adresu nahraďte adresou, ktorá smeruje späť do frontu alebo toku, ktorý má prevziať volajúceho; jej formát potvrďte v Genesys. REFER vyzerá takto:

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

Keď je zapnuté Prevzatie späť a prenos, Genesys prevezme hovor späť z trunku a nasmeruje ho na túto adresu. Genesys uvádza, že prichádzajúce UUI sa uloží do Call.UUIData; pre prevzatie späť to však neuvádza, preto si v Genesys alebo počas testovacieho hovoru potvrďte, že tok prijímajúci volajúceho tam nájde ID odovzdania. Ak chcete získať súhrn a zámer, zavolajte vyhľadanie odovzdania pomocou Akcie údajov hovoru v integrácii Web Services Data Actions:

  • Požiadavka: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= nasledovaná ID z Call.UUIData.
  • Prihlasovacie údaje: váš kľúč API odoslaný ako Authorization: Bearer sk_live_….
  • Výstup: namapujte handoff.summary a handoff.intent na premenné toku.

Pozrite si Vyhľadanie odovzdaného hovoru.

Otestovanie

Zavolajte na číslo, ktoré vedie do toku, požiadajte agenta o osobu a overte, že Genesys presmeruje hovor na adresu, ktorú ste nastavili. V danom toku overte, že Call.UUIData obsahuje ID odovzdania ako text (ak zobrazuje hexadecimálne číslice, overte, že kódovanie UUI trunku je Hex). Potom otvorte hovor pomocou GET /v1/calls/{call_id}: external_call_id by malo byť ID konverzácie.

Obmedzenia

  • Akcia Získať hlavičky SIP číta iba počiatočný INVITE, takže nemôže čítať nič z REFER agenta. Odovzdanie sa do Genesys dostane iba prostredníctvom UUI.
  • Genesys zahodí všetky UUI, keď hovor obsahuje viac než jednu hlavičku UUI.
  • Adresa prenosu je obmedzená na 254 znakov, takže dlhé UUI sa skráti, aby sa zmestilo. ID odovzdania sa vždy zmestí.