ThunderPhone v3 ir klāt.Sāciet patstāvīgi — no 2 ¢/min.Lasīt paziņojumu

Contact centers

Savienojiet no Microsoft Dynamics 365

Nosūtiet zvanus no Dynamics 365 Contact Center un Copilot Studio uz ThunderPhone balss aģentu, izmantojot savu SBC ar X galvenēm, un HTTP ceļā uzmeklējiet aģenta zvana pāradresēšanu.

Dynamics 365 Contact Center novirza zvanītāju uz balss aģentu, izmantojot jūsu sesijas robežkontrolieri (SBC), ar līdz piecām X galvenēm, tostarp sarunas ID. Kad balss aģents ir pabeidzis, tas noliek klausuli, jūsu SBC atgriež zvanītāju pakalpojumā Dynamics 365, un HTTP pieprasījuma mezgls iegūst pārsūtīšanas informāciju.

Pirms sākat

  • ThunderPhone balss aģents un organizācijas API atslēga.
  • Dynamics 365 Contact Center balss kanāls, kas ar Azure Communication Services Direct Routing ir savienots ar jūsu pārvaldītu SBC (SBC prasības): atbalstīts SBC ar publisku sertifikātu, TLS 1.2 portā 5061 un SRTP savienojumam ar Microsoft.
  • SIP X-galvenes atbalsts mezglā Transfer conversation (Copilot Studio). Apstipriniet, ka tas ir pieejams jūsu vidē.

Dynamics 365 pārsūta tikai uz tālruņa numuru, un Microsoft autentificē Direct Routing ar sertifikātu, nevis paroli. Jūsu SBC atrodas starp Microsoft un ThunderPhone un pārvērš šo numuru par balss aģenta SIP adresi.

1. Izveidojiet SIP galapunktu

Zvans sasniedz ThunderPhone no jūsu SBC, tāpēc izveidojiet standarta galapunktu, ko izmantot 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"}'

Nekavējoties saglabājiet atbildē saņemto password; tā tiek parādīta vienreiz, un jūsu SBC ar to atbild uz ThunderPhone izaicinājumu. Ja jūsu SBC neatbalsta digest autentifikāciju, tā vietā izveidojiet galapunktu ar auth iestatītu uz ip_allowlist un norādiet sava SBC publisko adresi; skatiet Platformas, kas autentificē pēc avota IP.

2. Sūtiet zvanus ar kontekstu

  1. Izvēlieties savā SBC balss aģentam tālruņa numuru, piemēram, +14155550188.
  2. SBC maršrutējiet zvanus uz šo numuru uz galapunkta sip_uri, piemēram, sip:agent-12-jhxmginwjx@sip.thunderphone.com, izmantojot TLS portā 5061. ThunderPhone atrod galapunktu pēc lietotāja daļas (agent-12-jhxmginwjx), kurai jābūt gan pieprasījuma URI, gan To galvenē. Nododiet X-galvenes tālāk nemainītas.
  3. Copilot Studio pievienojiet mezglu Transfer conversation ar External phone number transfer uz šo numuru un pievienojiet X-galvenes:
    • X-Call-ID: Dynamics 365 sarunas ID. Neviena Microsoft galvene to nenodod, tāpēc pievienojiet to šeit; ThunderPhone to saglabā kā zvana external_call_id. Copilot Studio apstipriniet, kurš mainīgais satur sarunas ID.
    • Līdz četrām papildu galvenēm, piemēram, X-Customer-Tier.

Microsoft nosūta ne vairāk kā piecas X-galvenes, kuru nosaukumi var būt līdz 64 rakstzīmēm gari un vērtības — līdz 256 rakstzīmēm garas, izmantojot burtus, ciparus un = ; . ! % * _ + ~ -. Tā raksta prefiksu ar mazajiem burtiem x-; ThunderPhone salīdzina galveņu nosaukumus, neņemot vērā reģistru, tāpēc x-customer-tier uzvednē nonāk kā {{sip_x_customer_tier}}.

Ja tā vietā veidojat zvanu ar Azure Communication Services Call Automation, AddSipX pēc noklusējuma raksta X-MS-Custom- nosaukumus. Nododiet SipHeaderPrefix.X, lai X-Call-ID saglabātu savu nosaukumu (pielāgots konteksts).

3. Saņemiet zvanu atpakaļ

Aģents atgriež zvanu: tas atvadās un noliek klausuli. Pievienojiet šo pārsūtīšanas numuru (skatiet Pievienojiet pārsūtīšanas numuru):

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

Par zvanītāja atgriešanu Dynamics 365 atbild jūsu SBC. Microsoft dokumentē vienu veidu, kā ienākt zvanam ar kontekstu: jauns zvans caur SBC uz Dynamics 365 reģistrētu numuru ar UUI, kura atslēgas atbilst konteksta mainīgajiem, ko iestatījāt sadaļā Darba plūsmas → Papildu iestatījumi (trešās puses IVR pārsūtīšana). Saskaņojiet ar savu SBC piegādātāju, kā zvanītājs sasniedz šo numuru, kad ThunderPhone noliek klausuli, un pārsūtiet sarunas ID, ko nosūtījāt laukā X-Call-ID, lai plūsma varētu atrast zvanu.

Pēc tam izgūstiet nodošanu ar Copilot Studio HTTP pieprasījuma mezglu:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= kam seko sarunas ID.
  • Galvene Authorization: Bearer sk_live_….
  • Parsējiet atbildi mainīgajā un izmantojiet handoff.summary un handoff.intent.

Skatiet Meklējiet nodotu zvanu.

Pārbaudiet

Zvaniet uz Dynamics 365 numuru, kas sasniedz pārsūtīšanas mezglu, palūdziet aģentam savienot ar cilvēku un pārbaudiet, vai zvanītājs atgriežas Dynamics 365. Pēc tam atveriet zvanu ar GET /v1/calls/{call_id}: laukā sip_headers jābūt norādītam x-call-id, un external_call_id jābūt sarunas ID. Ja zvans nekad nesasniedz aģentu un jūsu SBC žurnālos redzams SIP 404, tā pieprasījuma URI vai To galvenē nav galapunkta lietotāja daļas.

Ierobežojumi

  • Nepieciešams SBC. Microsoft nevar sastādīt SIP adresi vai atbildēt uz digest autentifikācijas pieprasījumu.
  • Microsoft nosūta ne vairāk kā piecas X-galvenes un ienākošam zvanam saglabā tikai pirmās piecas. Dynamics 365 UUI pieņem ne vairāk kā 128 rakstzīmes.
  • Microsoft nedokumentē galveņu nolasīšanu BYE ziņojumā, tāpēc nodošana tiek atgriezta tikai ar uzmeklēšanu.