Open in
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
- Na SBC vyberte telefonní číslo pro agenta, například
+14155550188. - Na SBC směrujte hovory na toto číslo do
sip_urikoncového bodu, napříkladsip:agent-12-jhxmginwjx@sip.thunderphone.com, přes TLS na portu5061. 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čceTo. Hlavičky X předejte beze změny. - 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ží jakoexternal_call_idhovoru. 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.summaryahandoff.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í.