Open in
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-Usera kódovaním Hex. - Prevzatie späť a prenos, aby Genesys prijal agentov
REFER.
- Hlavičky konverzácie, aby Genesys odosielal ID konverzácie v
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:
| Nastavenie | Hodnota |
|---|---|
| Server SIP | sip.thunderphone.com, port 5061 |
| Protokol | TLS |
| Digest autentifikácia | username a password koncového bodu |
| Kodeky | PCMU, 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:
- Voliteľne pridajte akciu Nastaviť údaje UUI s kontextom pre agenta,
napríklad
account=12345. Genesys odporúča najviac 128 znakov. - Pridajte akciu Preniesť na číslo s
sip_urikoncového bodu, napríkladsip: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 zCall.UUIData. - Prihlasovacie údaje: váš kľúč API odoslaný ako
Authorization: Bearer sk_live_…. - Výstup: namapujte
handoff.summaryahandoff.intentna 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č zREFERagenta. 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í.