ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Contact centers

Povežite se iz Microsoft Dynamics 365

Klice iz Dynamics 365 Contact Center in Copilot Studio usmerite do glasovnega agenta ThunderPhone prek svojega SBC-ja z glavami X ter prek HTTP pridobite podatke o predaji agenta.

Dynamics 365 Contact Center pošlje klicatelja agentu prek vašega mejnega krmilnika sej (SBC) z do petimi X-glavami, vključno z ID-jem pogovora. Ko agent konča, prekine klic, vaš SBC klicatelja vrne v Dynamics 365, vozlišče HTTP Request pa pridobi predajo.

Preden začnete

  • Agent ThunderPhone in organizacijski ključ API.
  • Glasovni kanal Dynamics 365 Contact Center, povezan prek storitve Azure Communication Services Direct Routing s SBC-jem, ki ga upravljate (zahteve za SBC): podprt SBC z javnim potrdilom, TLS 1.2 na vratih 5061 in SRTP proti Microsoftu.
  • Podpora za SIP X-glave v vozlišču Transfer conversation (Copilot Studio). Potrdite, da je na voljo v vašem okolju.

Dynamics 365 prenese klic samo na telefonsko številko, Microsoft pa Direct Routing preverja s potrdilom, ne z geslom. Vaš SBC je med Microsoftom in ThunderPhone ter to številko pretvori v SIP-naslov agenta.

1. Ustvarite končno točko SIP

Klic doseže ThunderPhone z vašega SBC-ja, zato ustvarite standardno končno točko, ki jo bo uporabljal SBC:

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"}'

Takoj shranite password iz odgovora; prikaže se samo enkrat, vaš SBC pa z njim odgovori na izziv ThunderPhone. Če vaš SBC ne podpira avtentikacije digest, namesto tega ustvarite končno točko z auth, nastavljenim na ip_allowlist, in javnim naslovom vašega SBC-ja; glejte Platforme, ki preverjajo pristnost po izvornem IP-ju.

2. Pošiljajte klice s kontekstom

  1. Na SBC-ju izberite telefonsko številko za agenta, na primer +14155550188.
  2. Na SBC-ju usmerite klice na to številko v sip_uri končne točke, na primer sip:agent-12-jhxmginwjx@sip.thunderphone.com, prek TLS na vratih 5061. ThunderPhone najde končno točko po uporabniškem delu (agent-12-jhxmginwjx), ki mora biti v URI-ju zahteve in glavi To. X-glave posredujte nespremenjene.
  3. V Copilot Studio dodajte vozlišče Transfer conversation z možnostjo External phone number transfer na to številko in dodajte X-glave:
    • X-Call-ID: ID pogovora Dynamics 365. Nobena Microsoftova glava ga ne vsebuje, zato ga dodajte tukaj; ThunderPhone ga shrani kot external_call_id klica. V Copilot Studio potrdite, katera spremenljivka vsebuje ID pogovora.
    • Do štiri dodatne, na primer X-Customer-Tier.

Microsoft pošlje največ pet X-glav z imeni do 64 znakov in vrednostmi do 256 znakov, pri čemer uporablja črke, številke in = ; . ! % * _ + ~ -. Predpono zapiše z malimi črkami kot x-; ThunderPhone imena glav primerja ne glede na velikost črk, zato x-customer-tier doseže poziv kot {{sip_x_customer_tier}}.

Če klic namesto tega ustvarite z Azure Communication Services Call Automation, AddSipX privzeto zapiše imena X-MS-Custom-. Posredujte SipHeaderPrefix.X, da X-Call-ID ohrani svoje ime (kontekst po meri).

3. Prejmite klic nazaj

Agent vrne klic: poslovi se in prekine povezavo. Dodajte to številko za preusmeritev (glejte Dodajte številko za preusmeritev):

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

Za vrnitev klicatelja v Dynamics 365 je odgovoren vaš SBC. Microsoft dokumentira en način za dohodni klic s kontekstom: nov klic prek SBC-ja na številko, registrirano v Dynamics 365, z UUI, katerega ključi se ujemajo s spremenljivkami konteksta, ki jih nastavite v razdelku Delovni tokovi → Napredne nastavitve (prenos iz IVR-ja tretje osebe). Z dobaviteljem SBC-ja uskladite, kako klicatelj doseže to številko, ko ThunderPhone prekine povezavo, in prenesite ID pogovora, ki ste ga poslali v X-Call-ID, da lahko tok najde klic.

Nato pridobite predajo z vozliščem Zahteva HTTP v Copilot Studio:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ki mu sledi ID pogovora.
  • Glava Authorization: Bearer sk_live_….
  • Razčlenite odgovor v spremenljivko ter uporabite handoff.summary in handoff.intent.

Glejte Poiščite predani klic.

Preizkusite

Pokličite številko Dynamics 365, ki doseže vozlišče za preusmeritev, prosite agenta za osebo in preverite, da se klicatelj vrne v Dynamics 365. Nato odprite klic z GET /v1/calls/{call_id}: sip_headers mora vsebovati x-call-id, medtem ko mora biti external_call_id ID pogovora. Če klic nikoli ne doseže agenta in dnevniki vašega SBC-ja prikazujejo SIP 404, URI zahteve ali glava To ne vsebujeta uporabniškega dela končne točke.

Omejitve

  • SBC je obvezen. Microsoft ne more klicati naslova SIP ali odgovoriti na izziv digest.
  • Microsoft pošlje največ pet glav X in ob dohodnem klicu ohrani le prvih pet. Dynamics 365 sprejme največ 128 znakov UUI.
  • Microsoft ne dokumentira branja glav pri BYE, zato se predaja vrne le prek poizvedbe.