ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Contact centers

Pripojenie z Microsoft Dynamics 365

Odosielajte hovory z Dynamics 365 Contact Center a Copilot Studio k hlasovému agentovi ThunderPhone prostredníctvom svojho SBC s hlavičkami X a vyhľadajte odovzdanie hovoru agentom cez HTTP.

Dynamics 365 Contact Center odošle volajúceho k agentovi cez váš hraničný riadiaci prvok relácie (SBC) s až piatimi X-hlavičkami vrátane ID konverzácie. Keď agent skončí, ukončí hovor, váš SBC vráti volajúceho do Dynamics 365 a uzol požiadavky HTTP načíta odovzdanie.

Skôr než začnete

  • Agent ThunderPhone a kľúč API organizácie.
  • Hlasový kanál Dynamics 365 Contact Center pripojený cez Azure Communication Services Priame smerovanie k SBC, ktorý prevádzkujete (požiadavky na SBC): podporovaný SBC s verejným certifikátom, TLS 1.2 na porte 5061 a SRTP smerom k Microsoftu.
  • Podpora SIP X-hlavičiek v uzle Preniesť konverzáciu (Copilot Studio). Potvrďte, že je vo vašom prostredí dostupná.

Dynamics 365 prenáša len na telefónne číslo a Microsoft overuje Priame smerovanie certifikátom, nie heslom. Váš SBC sa nachádza medzi Microsoftom a ThunderPhone a prevádza toto číslo na SIP adresu agenta.

1. Vytvorte koncový bod SIP

Hovor prichádza do ThunderPhone z vášho SBC, preto vytvorte štandardný koncový bod, ktorý bude SBC používať:

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 odpovede si ihneď uložte; zobrazí sa iba raz a váš SBC ním odpovie na výzvu ThunderPhone. Ak váš SBC nepodporuje autentifikáciu Digest, vytvorte koncový bod s hodnotou auth nastavenou na ip_allowlist a namiesto toho uveďte verejnú adresu vášho SBC; pozrite si platformy overované podľa zdrojovej IP adresy.

2. Odosielajte hovory s kontextom

  1. Vyberte pre agenta na vašom SBC telefónne číslo, napríklad +14155550188.
  2. Na SBC smerujte hovory na toto číslo do sip_uri koncového bodu, napríklad sip:agent-12-jhxmginwjx@sip.thunderphone.com, cez TLS na porte 5061. ThunderPhone nájde koncový bod podľa používateľskej časti (agent-12-jhxmginwjx), ktorá musí byť v URI požiadavky aj v hlavičke To. X-hlavičky odovzdajte bez zmien.
  3. V Copilot Studio pridajte uzol Preniesť konverzáciu s možnosťou Prenos na externé telefónne číslo na toto číslo a pridajte X-hlavičky:
    • X-Call-ID: ID konverzácie Dynamics 365. Žiadna hlavička Microsoftu ho nenesie, preto ho pridajte tu; ThunderPhone ho uloží ako external_call_id hovoru. V Copilot Studio potvrďte, ktorá premenná obsahuje ID konverzácie.
    • Až štyri ďalšie, napríklad X-Customer-Tier.

Microsoft odosiela najviac päť X-hlavičiek s názvami dlhými až 64 znakov a hodnotami dlhými až 256 znakov, pričom používa písmená, číslice a = ; . ! % * _ + ~ -. Predponu zapisuje malými písmenami ako x-; ThunderPhone porovnáva názvy hlavičiek bez ohľadu na veľkosť písmen, takže x-customer-tier sa dostane do promptu ako {{sip_x_customer_tier}}.

Ak hovor namiesto toho vytvárate pomocou Azure Communication Services Call Automation, AddSipX predvolene zapisuje názvy X-MS-Custom-. Odovzdajte SipHeaderPrefix.X, aby si X-Call-ID zachovalo svoj názov (vlastný kontext).

3. Vráťte hovor späť

Hlasový agent vráti hovor: rozlúči sa a zavesí. Pridajte toto číslo pre presmerovanie (pozrite si Pridanie čísla pre presmerovanie):

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

Vrátenie volajúceho do Dynamics 365 je úlohou vášho SBC. Microsoft dokumentuje jeden spôsob prichádzajúceho hovoru s kontextom: nový hovor cez SBC na číslo zaregistrované v Dynamics 365 s UUI, ktorého kľúče zodpovedajú premenným kontextu, ktoré nastavíte v časti Pracovné toky → Rozšírené nastavenia (presmerovanie IVR tretej strany). S dodávateľom SBC si dohodnite, ako volajúci dosiahne toto číslo, keď ThunderPhone zavesí, a preneste ID konverzácie, ktoré ste odoslali v X-Call-ID, aby tok mohol hovor nájsť.

Potom načítajte odovzdanie pomocou uzla Požiadavka HTTP v Copilot Studio:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= nasledované ID konverzácie.
  • Hlavička Authorization: Bearer sk_live_….
  • Odpoveď spracujte do premennej a použite handoff.summary a handoff.intent.

Pozrite si časť Vyhľadanie odovzdaného hovoru.

Otestujte to

Zavolajte na číslo Dynamics 365, ktoré vedie k uzlu presmerovania, požiadajte agenta o spojenie s človekom a overte, že sa volajúci vráti do Dynamics 365. Potom otvorte hovor pomocou GET /v1/calls/{call_id}: položka sip_headers by mala obsahovať x-call-id a external_call_id by malo byť ID konverzácie. Ak hovor nikdy nedorazí k agentovi a protokoly SBC zobrazujú SIP 404, identifikátor URI požiadavky alebo hlavička To neobsahuje používateľskú časť koncového bodu.

Obmedzenia

  • Vyžaduje sa SBC. Microsoft nemôže vytočiť adresu SIP ani odpovedať na výzvu digest.
  • Microsoft odosiela najviac päť hlavičiek X a pri prichádzajúcom hovore uchová iba prvých päť. Dynamics 365 prijíma v UUI najviac 128 znakov.
  • Microsoft nedokumentuje čítanie hlavičiek pri BYE, takže odovzdanie sa vráti iba prostredníctvom vyhľadania.