ThunderPhone v3 je venku.Spustíte sami, od 2 ¢/min.Přečíst oznámení

Contact centers

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-User a kódováním Hex.
    • Převzetí zpět a přesměrování, aby Genesys přijímal REFER agenta.

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 SIPsip.thunderphone.com, port 5061
ProtokolTLS
Digest ověřováníusername a password koncového bodu
KodekyPCMU, 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:

  1. Volitelně přidejte akci Nastavit data UUI s kontextem pro agenta, například account=12345. Genesys doporučuje maximálně 128 znaků.
  2. Přidejte akci Přesměrovat na číslo s sip_uri koncového bodu, například sip: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 z Call.UUIData.
  • Přihlašovací údaje: váš klíč API odeslaný jako Authorization: Bearer sk_live_….
  • Výstup: namapujte handoff.summary a handoff.intent na 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 z REFER agenta. 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.