Open in
Připojení z Genesys Cloud
Směrujte hovory z Genesys Cloud k agentovi ThunderPhone přes trunk BYOC Cloud s ID konverzace a UUI a přebírejte je zpět s předáním v UUI.
Váš tok Architect odešle volajícího k agentovi přes trunk BYOC Cloud spolu s ID konverzace a veškerými nastavenými údaji UUI. Když volající potřebuje člověka, agent odešle SIP REFER, Genesys hovor převezme zpět a ID předání dorazí v UUI hovoru.
Než začnete
- Agent ThunderPhone a klíč API organizace.
- Genesys Cloud s BYOC Cloud a externím trunkem (typ BYOC Carrier nebo
PBX) s aktivovanými následujícími nastaveními
(nastavení externího trunku):
- Hlavičky konverzace, aby Genesys odesílal ID konverzace v
x-inin-cnv. Ve výchozím nastavení je vypnuté. - Průchod UUI s typem hlavičky
User-To-Usera kódováním Hex. - Převzetí zpět a přesměrování, aby Genesys přijímal
REFERagenta.
- Hlavičky konverzace, aby Genesys odesílal ID konverzace v
1. Vytvořte koncový bod SIP
Genesys odpovídá na digest challenge, proto použijte standardní 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 odpovědi si ihned uložte; zobrazí se pouze jednou. Na
trunku nastavte:
| Nastavení | Hodnota |
|---|---|
| Server SIP | sip.thunderphone.com, port 5061 |
| Protokol | TLS |
| Digest ověřování | username a password koncového bodu |
| Kodeky | PCMU, PCMA nebo G.722 |
Přidejte trunk do odchozí trasy své lokality, jejíž číslovací plán pokrývá adresu, na kterou tok volá.
2. Odesílejte hovory s kontextem
V toku Architect:
- Volitelně přidejte akci Nastavit data UUI s kontextem pro agenta,
například
account=12345. Genesys doporučuje maximálně 128 znaků. - Přidejte akci Přesměrovat na číslo s
sip_urikoncového bodu, napříkladsip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys odesílá ID konverzace v x-inin-cnv. ThunderPhone jej uloží jako
external_call_id hovoru. UUI dorazí do promptu dekódované jako
{{sip_uui}}.
Vlastní hlavičky trunku jsou v Genesys statické, proto hodnoty pro jednotlivé
hovory vkládejte do UUI. Genesys si pro sebe vyhrazuje předpony hlaviček
x-inin, x-genesys, x-pcv a x-gcv.
3. Převezměte hovor zpět
Agent přesměruje hovor pomocí REFER na adresu v Genesys, přičemž ID předání
je uvnitř této adresy jako hexadecimální UUI. Přidejte toto číslo pro přesměrování (viz
Přidání čísla pro přesměrování
a Hlavičky uvnitř adresy pro přesměrování):
{
"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, která směruje zpět do fronty nebo toku, jenž má
volajícího převzít; její formát ověřte u Genesys. REFER vypadá takto:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
Při zapnutém Převzetí zpět a přesměrování Genesys převezme hovor zpět z
trunku a nasměruje jej na danou adresu. Genesys uvádí, že příchozí UUI se uloží
do Call.UUIData; pro převzetí zpět to však nedokumentuje, proto u Genesys
nebo při testovacím hovoru ověřte, že tok přijímající volajícího zde najde ID
předání. Chcete-li získat souhrn a záměr, zavolejte vyhledání předání pomocí
akce Datová akce volání v integraci Web Services Data Actions:
- Požadavek:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=následovaný ID zCall.UUIData. - Přihlašovací údaje: váš klíč API odeslaný jako
Authorization: Bearer sk_live_…. - Výstup: namapujte
handoff.summaryahandoff.intentna proměnné toku.
Viz Vyhledání předaného hovoru.
Otestujte to
Zavolejte na číslo, které vede do toku, požádejte agenta o osobu a ověřte, že
Genesys přesměruje hovor na nastavenou adresu. V tomto toku ověřte, že
Call.UUIData obsahuje ID předání jako text (pokud zobrazuje šestnáctkové číslice, ověřte, že
kódování UUI trunku je nastavené na Hex). Poté otevřete hovor pomocí GET /v1/calls/{call_id}:
external_call_id by mělo být ID konverzace.
Omezení
- Akce Získat hlavičky SIP čte pouze počáteční
INVITE, takže nemůže číst nic zREFERagenta. Předání se do Genesys dostane pouze prostřednictvím UUI. - Genesys zahodí všechna UUI, pokud hovor obsahuje více než jednu hlavičku UUI.
- Adresa přesměrování je omezená na 254 znaků, takže dlouhé UUI se zkrátí, aby se vešlo. ID předání se vždy vejde.