---
title: "Forbind fra Microsoft Dynamics 365"
description: "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](/da/guides/api-keys).
- Dynamics 365 Contact Center-stemmekanalen, forbundet gennem Azure
  Communication Services **Direct Routing** til en SBC, du driver
  ([SBC-krav](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  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](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  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:

```bash
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](/da/guides/sip-addresses).

## 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](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Få opkaldet tilbage

Agenten returnerer opkaldet: den siger farvel og lægger på. Tilføj dette
viderestillingsnummer (se
[Tilføj viderestillingsnummeret](/da/guides/contact-centers/overview)):

```json
{"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](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
