Eksempelkode for integration af softphone ved hjælp af Dynamics 365 Channel Integration Framework 2.0

Artikel
12/08/2023

Download eksempelintegration af softphone til Microsoft Dynamics 365 Channel Integration Framework-version 2.0.

Bemærk

Eksempelkoden understøttes ikke på Internet Explorer og på browsere, der ikke har webRTC-understøttelse. Flere oplysninger: WebRTC

Forudsætninger

Omnichannel til Dynamics 365 Customer Service
Der kræves et gyldigt Azure-abonnement for at udgive eksempelappen til Azure.

Bemærk

Hvis du ikke har et Azure-abonnement, skal du oprette en gratis konto.

Udgiv en eksempelapp til Azure

Åbn løsningen SampleInteg.sln med Visual Studio 2017.
I Solution Explorer skal du højreklikke på løsningen og bygge den komplette løsning.
I Solution Explorer skal du højreklikke på projektet SampleInteg og vælge Udgiv.
Vælg Start for at starte Publicér-guiden.
Vælg App Service som udgivelsesmål.
Vælg Opret ny, og vælg derefter Publicér.
Angiv et appnavn. For eksempel SampleInteg.
Angiv gyldige abonnements-, ressourcegruppe- og hostingplanoplysninger.
Vælg Opret for at oprette Azure-apptjenesten, og gem apptjenestens URL til fremtidig brug.

F.eks., https://sampleinteg.azurewebsites.net.

Opret funktion til brug med app-tjenesten

Opret eksempelkode til klient-stemme funktionen.
Se funktionen fra readme-filen, der er pakket med eksempelintegration af softphone i Dynamics 365 Insider Portal.
Brug eksempelkoden til capability-token funktionen.
Se funktionen fra readme-filen, der er pakket med eksempelintegration af softphone i Dynamics 365 Insider Portal.

Bemærk

Gem URL'en til capability-token funktionen, du får fra ovenstående eksempelkode. F.eks. er URL https://sampleinteg.sample/capability-token.

Konfigurere prøveappen i Dynamics 365

Bemærk basis-URL'en for Dynamics 365-organisationen, hvorfra alle webressourcer er gemt. For en onlineorganisation skal denne have formen https://<orgname>.crmXX.dynamics.com. Eksempel: https://sampleorg.crm10.dynamics.com
Hent Dynamics 365-kanalintegrationsstruktur-løsningen Flere oplysninger i Hent Dynamics 365 Channel Integration Framework.

Konfigurer kanaludbyderen ved at angive detaljerne som vist i matrixen. Du kan finde flere oplysninger i Konfigurer udbyder for kanal.

Felt	Description
Name	Navn på kanaludbyder. Eksempel: Contoso
Entydigt navn	Et entydigt id i formatet <præfiks>_<navn>. VIGTIGT: Følgende er påkrævet for det entydige navn: Præfikset kan kun være alfanumerisk, og længden skal være mellem 3 og 8 tegn. Der skal angives et understregningstegn mellem præfikset og navnet
Mærkat	Etiketten vises som titlen på widgetten. Eksempel: Contoso
URL-adresse for kanal	Kanal-URL-adressen er i formatet: `<azure_app_service_url>?base=<crm_base_url>` Bemærk: For dette eksempel er URL'en `https://sampleinteg.azurewebsites.net?base=https://sampleorg.crm10.dynamics.com`.
Aktivér udgående kommunikation	Ja
Kanalrækkefølge	0
API-version	2.0
Domæne, der er tillid til	Tilføj domænet (URL) for at få adgang til Channel Integration Framework API'er.
Vælg Unified Interface-apps til kanalen	Listen over Unified Interface-apps, hvor kanalen vises for agenterne.
Vælg rollerne for kanalen	De sikkerhedsroller, der er til stede i Dynamics 365. Bemærk: Hvis du ikke tildeler nogen rolle, vises kanaludbyderen til alle brugere, der er tildelt Dynamics 365 Unified Interface-appen.

Start Unified Interface-appen for at se kommunikationswidget på venstre side.

Vigtigt

Alle URL'er skal være HTTPS.
Hvis du bruger et selvsigneret certifikat til Azure-appen eller Dynamics 365-organisationen, kan visse browsere afvise forbindelsen og ikke indlæse eksempeltelefonen. Som en løsning skal du åbne Azure-appen på en separat fane og acceptere certifikatet én gang.
Sørg for, at mikrofon- og højttaleradgang ikke er blokeret af browserpolitik.

Importere konfigurationsdata

Download værktøjet Konfigurationsoverførsel. Værktøj til konfigurationsoverførsel er tilgængeligt som en NuGet-pakke.
Start værktøjet Konfigurationsoverførsel. Dobbeltklik på DataMigrationUtility.exe i mappen: [your folder]\Tools\ConfigurationMigration\.
På hovedskærmbillede skal du vælge Importer data og vælge Fortsæt.
På Logon-skærmbilledet skal du angive godkendelsesoplysninger for at oprette forbindelse til den Dynamics 365-forekomst, som du vil importere data fra. Hvis du har flere organisationer på Dynamics 365 Server og du vil vælge den organisation, du vil importere konfigurationsdataene til, skal du markere afkrydsningsfeltet Vis altid en liste over tilgængelige organisationer. Vælg Logon.
Hvis du har flere organisationer og du markerede afkrydsningsfeltet Vis altid en liste over tilgængelige organisationer, kan du vælge den organisation, du vil oprette forbindelse til, på det næste skærmbillede. Vælg en Dynamics 365 apps-organisation, du kan forbinde til.
Angiv datafilen (data.zip), der skal importeres. Gå til datafilen, og markér den. Vælg Importér data.
Dette trin gælder kun, hvis de data, du importerer, indeholder brugeroplysninger for kildesystemet. Angiv tilknytning af brugeroplysninger på destinationssystemet. Du kan knytte dem alle til den bruger, der kører importprocessen, eller tilknytte de enkelte brugere ved hjælp af en brugertilknytningsfil (.xml). Hvis du vælger det sidste, skal du enten angive en eksisterende brugertilknytningsfil, eller værktøjet kan generere den for dig. Hvis du genererer en ny fil, skal du udfylde tilknytningsbrugernavnet i parameteren Ny parameter for hver bruger på kildeserveren. Vælg brugertilknytningsfilen i værktøjet, når du er færdig, og klik på OK.
Det næste skærmbillede viser importstatus af posterne. Dataene importeres i flere gennemløb for først at importere de grundlæggende data, mens de afhængige data sættes i kø, og derefter importere de afhængige data i de efterfølgende gennemløb for at håndtere eventuelle dataafhængigheder eller -sammenkædninger. Dette sikrer en ren og ensartet dataimport.
Vælg Udfør for at lukke værktøjet.

Se også

Hente Dynamics 365 Kanalintegrationsfunktioner

Del via