ThunderPhone v3 er live.Selvbetjening fra 2 cent pr. minut.Læs mere om lanceringen

Contact centers

Forbind fra Microsoft Dynamics 365

Send opkald fra Dynamics 365 Contact Center og Copilot Studio til en ThunderPhone-agent via din SBC med X-headers, og slå agentens overdragelse op over HTTP.

Dynamics 365 Contact Center sender den, der ringer, til agenten gennem din sessionsgrænsekontroller (SBC) med op til fem X-headere, herunder samtale-id'et. Når agenten er færdig, lægger den på, din SBC sender den, der ringer, tilbage til Dynamics 365, og en HTTP Request-knude henter overdragelsen.

Før du starter

  • En ThunderPhone-agent og en organisations-API-nøgle.
  • Dynamics 365 Contact Center-stemmekanalen, forbundet gennem Azure Communication Services Direct Routing til en SBC, du driver (SBC-krav): en understøttet SBC med et offentligt certifikat, TLS 1.2 på port 5061 og SRTP mod Microsoft.
  • SIP X-header-understøttelse på knuden Overfør samtale (Copilot Studio). Bekræft, at den er tilgængelig i dit miljø.

Dynamics 365 overfører kun til et telefonnummer, og Microsoft godkender Direct Routing med certifikat, ikke med adgangskode. Din SBC ligger mellem Microsoft og ThunderPhone og omsætter dette nummer til agentens SIP-adresse.

1. Opret SIP-slutpunktet

Opkaldet når ThunderPhone fra din SBC, så opret et standard-slutpunkt, som SBC'en kan bruge:

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

Gem password fra svaret med det samme; den vises kun én gang, og din SBC besvarer ThunderPhones udfordring med den. Hvis din SBC ikke kan bruge digest-godkendelse, skal du i stedet oprette slutpunktet med auth sat til ip_allowlist og din SBC's offentlige adresse; se Platforme, der godkender efter kilde-IP.

2. Send opkald med kontekst

  1. Vælg et telefonnummer til agenten på din SBC, f.eks. +14155550188.
  2. På SBC'en skal du route opkald til det nummer til slutpunktets sip_uri, for eksempel sip:agent-12-jhxmginwjx@sip.thunderphone.com, over TLS på port 5061. ThunderPhone finder slutpunktet via brugerdelen (agent-12-jhxmginwjx), som skal være i både anmodnings-URI'en og To-headeren. Send X-headerne videre uændret.
  3. I Copilot Studio skal du tilføje en knude Overfør samtale med Overførsel til eksternt telefonnummer til det nummer og tilføje X-headerne:
    • X-Call-ID: Dynamics 365-samtale-id'et. Ingen Microsoft-header indeholder det, så tilføj det her; ThunderPhone gemmer det som opkaldets external_call_id. Bekræft i Copilot Studio, hvilken variabel der indeholder samtale-id'et.
    • Op til fire yderligere, f.eks. X-Customer-Tier.

Microsoft sender højst fem X-headere med navne på op til 64 tegn og værdier på op til 256 tegn ved hjælp af bogstaver, cifre og = ; . ! % * _ + ~ -. Det skriver præfikset med små bogstaver som x-; ThunderPhone matcher headernavne uden hensyn til store og små bogstaver, så x-customer-tier når prompten som {{sip_x_customer_tier}}.

Hvis du i stedet opbygger opkaldet med Azure Communication Services Call Automation, skriver AddSipX som standard navne med X-MS-Custom-. Send SipHeaderPrefix.X, så X-Call-ID beholder sit navn (brugerdefineret kontekst).

3. Få opkaldet tilbage

Agenten returnerer opkaldet: den siger farvel og lægger på. Tilføj dette viderestillingsnummer (se Tilføj viderestillingsnummeret):

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

Det er din SBC's opgave at bringe den, der ringer, tilbage til Dynamics 365. Microsoft dokumenterer én måde at modtage et opkald med kontekst på: et nyt opkald gennem SBC'en til et nummer, der er registreret i Dynamics 365, med UUI, hvis nøgler matcher kontekstvariabler, du har konfigureret under Arbejdsstrømme → Avancerede indstillinger (viderestilling fra tredjeparts-IVR). Aftal med din SBC-leverandør, hvordan den, der ringer, når det nummer, når ThunderPhone lægger på, og overfør det samtale-id, du sendte i X-Call-ID, så flowet kan finde opkaldet.

Hent derefter overdragelsen med en Copilot Studio-node af typen HTTP-anmodning:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= efterfulgt af samtale-id'et.
  • Headeren Authorization: Bearer sk_live_….
  • Parse svaret til en variabel, og brug handoff.summary og handoff.intent.

Se Slå et overdraget opkald op.

Test det

Ring til et Dynamics 365-nummer, der når viderestillingsnoden, bed agenten om en person, og kontrollér, at den, der ringer, kommer tilbage til Dynamics 365. Åbn derefter opkaldet med GET /v1/calls/{call_id}: sip_headers skal vise x-call-id, og external_call_id skal være samtale-id'et. Hvis opkaldet aldrig når agenten, og din SBC logger SIP 404, indeholder dens anmodnings-URI eller To-header ikke slutpunktets brugerdel.

Begrænsninger

  • En SBC er påkrævet. Microsoft kan ikke ringe til en SIP-adresse eller besvare en digest-udfordring.
  • Microsoft sender højst fem X-headere og bevarer kun de første fem på et indgående opkald. Dynamics 365 accepterer højst 128 tegn i UUI.
  • Microsoft dokumenterer ikke læsning af headere på en BYE, så overdragelsen kommer kun tilbage via opslaget.