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

Contact centers

Připojení z Microsoft Dynamics 365

Směrujte hovory z Dynamics 365 Contact Center a Copilot Studio k agentovi ThunderPhone prostřednictvím svého SBC s hlavičkami X a vyhledejte předání agenta přes HTTP.

Dynamics 365 Contact Center odesílá volajícího k agentovi prostřednictvím vašeho hraničního řadiče relací (SBC), a to až s pěti hlavičkami X včetně ID konverzace. Když agent skončí, zavěsí, váš SBC přivede volajícího zpět do Dynamics 365 a uzel požadavku HTTP načte předání.

Než začnete

  • Agent ThunderPhone a organizační klíč API.
  • Hlasový kanál Dynamics 365 Contact Center připojený přes Azure Communication Services Přímé směrování k SBC, který provozujete (požadavky na SBC): podporovaný SBC s veřejným certifikátem, TLS 1.2 na portu 5061 a SRTP směrem k Microsoftu.
  • Podpora hlaviček SIP X v uzlu Přesměrovat konverzaci (Copilot Studio). Ověřte, že je ve vašem prostředí k dispozici.

Dynamics 365 přesměrovává pouze na telefonní číslo a Microsoft ověřuje Přímé směrování pomocí certifikátu, nikoli hesla. Váš SBC stojí mezi Microsoftem a ThunderPhone a přesměruje toto číslo na SIP adresu agenta.

1. Vytvořte koncový bod SIP

Hovor přichází do ThunderPhone z vašeho SBC, proto vytvořte standardní koncový bod, který bude SBC používat:

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": "Dynamics 365 SBC"}'

Heslo password z odpovědi ihned uložte; zobrazí se pouze jednou a váš SBC jím odpoví na výzvu ThunderPhone. Pokud váš SBC nepodporuje ověřování pomocí mechanismu Digest, vytvořte místo toho koncový bod s hodnotou auth nastavenou na ip_allowlist a veřejnou adresou vašeho SBC; viz Platformy ověřované podle zdrojové IP adresy.

2. Odesílejte hovory s kontextem

  1. Na SBC vyberte telefonní číslo pro agenta, například +14155550188.
  2. Na SBC směrujte hovory na toto číslo do sip_uri koncového bodu, například sip:agent-12-jhxmginwjx@sip.thunderphone.com, přes TLS na portu 5061. ThunderPhone vyhledá koncový bod podle uživatelské části (agent-12-jhxmginwjx), která musí být jak v identifikátoru URI požadavku, tak v hlavičce To. Hlavičky X předejte beze změny.
  3. V Copilot Studio přidejte uzel Přesměrovat konverzaci s možností Přesměrování na externí telefonní číslo na toto číslo a přidejte hlavičky X:
    • X-Call-ID: ID konverzace Dynamics 365. Žádná hlavička Microsoftu je nepřenáší, proto je přidejte zde; ThunderPhone je uloží jako external_call_id hovoru. V Copilot Studio ověřte, která proměnná obsahuje ID konverzace.
    • Až čtyři další, například X-Customer-Tier.

Microsoft odesílá nejvýše pět hlaviček X, s názvy o délce až 64 znaků a hodnotami o délce až 256 znaků, s použitím písmen, číslic a znaků = ; . ! % * _ + ~ -. Prefix zapisuje malými písmeny jako x-; ThunderPhone porovnává názvy hlaviček bez ohledu na velikost písmen, takže x-customer-tier se do promptu dostane jako {{sip_x_customer_tier}}.

Pokud místo toho sestavujete hovor pomocí Azure Communication Services Call Automation, AddSipX ve výchozím nastavení zapisuje názvy X-MS-Custom-. Předejte SipHeaderPrefix.X, aby si X-Call-ID zachovalo svůj název (vlastní kontext).

3. Vraťte hovor zpět

Agent hovor vrátí: rozloučí se a zavěsí. Přidejte toto číslo pro přepojení (viz Přidání čísla pro přepojení):

{"name": "Dynamics 365", "action": "return"}

Vrácení volajícího do Dynamics 365 zajišťuje vaše SBC. Microsoft dokumentuje jeden způsob příchozího hovoru s kontextem: nový hovor přes SBC na číslo registrované v Dynamics 365 s UUI, jehož klíče odpovídají proměnným kontextu, které nastavíte v části Pracovní proudy → Upřesnit nastavení (přepojení IVR třetí strany). S dodavatelem SBC si domluvte, jak se volající dostane na toto číslo, když ThunderPhone zavěsí, a přeneste ID konverzace, které jste odeslali v X-Call-ID, aby tok mohl hovor najít.

Poté načtěte předání pomocí uzlu Požadavek HTTP v Copilot Studio:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= následované ID konverzace.
  • Hlavička Authorization: Bearer sk_live_….
  • Odpověď analyzujte do proměnné a použijte handoff.summary a handoff.intent.

Viz Vyhledání předaného hovoru.

Otestujte to

Zavolejte na číslo Dynamics 365, které vede k uzlu přepojení, požádejte agenta o spojení s člověkem a ověřte, že se volající vrátí do Dynamics 365. Poté otevřete hovor pomocí GET /v1/calls/{call_id}: sip_headers by mělo uvádět x-call-id a external_call_id by mělo být ID konverzace. Pokud hovor nikdy nedosáhne agenta a protokoly SBC obsahují SIP 404, identifikátor URI požadavku nebo hlavička To neobsahuje uživatelskou část koncového bodu.

Omezení

  • Je vyžadováno SBC. Microsoft nemůže volat na adresu SIP ani odpovídat na výzvu digest.
  • Microsoft odesílá nejvýše pět hlaviček X a u příchozího hovoru zachová pouze prvních pět. Dynamics 365 přijímá nejvýše 128 znaků UUI.
  • Microsoft nedokumentuje čtení hlaviček při BYE, takže předání se vrací pouze prostřednictvím vyhledání.