Microsoft Dynamics

In diesem Leitfaden wird die Ersteinrichtung zum Verbinden Ihrer Contact Center AI Platform- und MS Dynamics-Plattformen beschrieben.

Nach der Integration können sich Ihre Kundenservicemitarbeiter in der Contact Center AI Platform anmelden und Anrufe und Chats direkt in ihrem Dynamics-Dashboard annehmen. Bei Interaktionen werden in Dynamics automatisch neue Kunden und Fälle erstellt und protokolliert. So können Sie alle Interaktionsdaten an einem Ort durchsuchen und Berichte dazu erstellen.

Vorbereitung

Bevor Sie mit der Integration beginnen, benötigen Sie Folgendes:

  • Administratorzugriff auf Ihre MS Dynamics-Umgebung mit Berechtigungen zum Importieren von Connectors in die Lösungsverwaltung.
  • Zugriff auf das Microsoft Azure-Portal (für die Microsoft Entra ID-Anwendungsregistrierung mit Azure-Diensten).
  • Zugriff auf die Power Apps-Oberfläche.
  • Zugriff auf das Contact Center AI Platform-Admin-Portal.
  • Die ZIP-Datei des UJET-Connectors – das neueste verwaltete Paket UJETConnector_1_2_0_0_managed-dynamics.zip
  • Ein ausreichendes Zeitfenster für die Ausfallzeit des Agentenadapters während der Installation (ca. 10 Minuten).

Auf dieser Seite wird davon ausgegangen, dass Sie Ihre Umgebung bereits identifiziert oder eine neue Umgebung für diesen Portalbereich eingerichtet haben.

Mit dem in Microsoft Dynamics installierten Connector können Kundenservicemitarbeiter Anrufe und Chats direkt in einem Dynamics-Dashboard annehmen.

Checkliste für die Microsoft Dynamics-Integration

Die folgende Checkliste enthält die Schritte zum Einrichten der Microsoft Dynamics-Integration.

  1. Installieren Sie die CCAI Platform-Lösung in Ihrer Umgebung.

  2. Konfigurieren Sie die CCAI Platform-Lösung IFrameUrl.

  3. Domainbasierte Einstellungen prüfen

  4. Neue Azure-Anwendungsregistrierung erstellen

    1. Fügen Sie eine Plattformkonfiguration hinzu.

    2. API-Berechtigungen konfigurieren

    3. Erstellen Sie neue Zertifikate und Secrets.

  5. Anwendungsnutzer für diese Umgebung einrichten

  6. Legen Sie im Administratorportal Werte fest, um eine Verbindung zu Ihrer Microsoft Dynamics-Instanz herzustellen.

  7. Fahren Sie mit den optionalen Schritten fort.

Connector installieren oder aktualisieren

Das von der Contact Center AI Platform verwaltete Paket enthält den Connector. Mit dem in Microsoft Dynamics installierten Connector können Kundenservicemitarbeiter Anrufe und Chats direkt in einem Microsoft Dynamics-Dashboard annehmen.

Zwei Möglichkeiten, auf die Lösungsverwaltung zuzugreifen: Je nach Dynamics-Benutzeroberfläche können Sie die Lösungen über einen der folgenden Pfade aufrufen:

  • Legacy-UI: Gehen Sie in MS Dynamics zu Service > Solutions.

  • Moderne Power Apps-Benutzeroberfläche: Klicken Sie oben rechts auf das Zahnrad, um zu den Erweiterten Einstellungen zu gelangen. Klicken Sie dann auf das Caret-Zeichen  neben Einstellungen, um das Drop-down-Menü zu öffnen, und wählen Sie Lösungen aus.

Beide Pfade führen zur selben Liste „Lösungsverwaltung“. Verwenden Sie die in Ihrer Umgebung verfügbare Option.

  1. Rufen Sie Lösungen über einen der beschriebenen Pfade auf.

  2. Klicken Sie auf Importieren. Eine Seitenleiste (Lösung hinzufügen) wird angezeigt.

  3. Klicken Sie auf Durchsuchen und wählen Sie die ZIP-Datei des Connectors (UJETConnector_1_2_0_0_managed-dynamics.zip) aus.

  4. Klicken Sie auf Importieren. Die Details des Connector-Pakets sollten jetzt angezeigt werden. Wenn die Details korrekt angezeigt werden, fahren Sie mit dem nächsten Schritt fort. Prüfen Sie andernfalls noch einmal, ob die richtige Datei ausgewählt wurde.

  5. Klicken Sie auf Weiter. Folgen Sie der Anleitung auf dem Bildschirm, um den Import abzuschließen. Für das Upgrade des Connectors sind keine speziellen Optionen erforderlich.

  6. Aktualisieren Sie anschließend die Agentenseite, um zu prüfen, ob der aktualisierte Connector angezeigt wird.

  7. Suchen Sie den Connector-Eintrag in der Liste der Lösungen und prüfen Sie, ob er korrekt installiert ist. Dies kann im UJET Connector Settings Manager überprüft werden (siehe nächster Abschnitt).

Ergebnis: Der Connector ist installiert und einsatzbereit.

Connector-URL konfigurieren

Mit Paket 1.2.0.0 wird eine Konfigurationsmanager-Anwendung in die Contact Center AI Platform-Lösung eingeführt. Nach der Installation des Pakets v1_2_0_0 ist die neue Anwendung für den Integrator-System-Builder zugänglich.

  1. Suchen Sie in der Suchleiste nach UJET Connector Settings Manager und klicken Sie dann auf Play. Dadurch wird die Anwendung geöffnet und die Tabelle „UJET Connector Settings“ angezeigt, die die Konfiguration für den iFrame-Adapter enthält.

    Die Microsoft Dynamics-Oberfläche wird angezeigt, wobei der UJET Connector Settings Manager in der Symbolleiste zu sehen ist.

  2. Bei neuen Installationen muss der Tabelle „settings“ ein neuer Eintrag hinzugefügt werden. Klicken Sie auf Neu, um eine neue IFrameUrl-Einstellung hinzuzufügen.

    Der UJET Connector Settings Manager wird mit dem Namen und dem Wert angezeigt, die für „IFrameURL“ eingegeben wurden.

  3. Eine neue Seite wird geöffnet, auf der Sie eine IFrameUrl hinzufügen können. Es gibt zwei Felder: Name und Wert. Verwenden Sie die folgenden Beispielwerte, um die Konfiguration zu erleichtern.

    1. Name: IFrameUrl

    2. Wert: https://INSTANCE_SUBDOMAIN.ENVIRONMENT_DOMAIN

    Beispiel: https://mycompany.us.ccaiplatform.com, wobei mycompany die Subdomain Ihrer Instanz und us.ccaiplatform.com die Domain Ihrer Umgebung ist.

  4. Klicken Sie auf Speichern. In der Tabelle Einstellungen wird ein neuer Eintrag angezeigt. Die Konfiguration von IFrameUrl ist jetzt abgeschlossen.

Domainbasierte Zugriffssteuerung für den Agent-Adapter hinzufügen

Die domainbasierte Zugriffssteuerung sorgt für Sicherheit und ermöglicht es Ihnen, festzulegen und zu steuern, auf welchen Domains der Agent-Adapter angezeigt werden kann.

Domains in den Entwicklereinstellungen hinzufügen

So fügen Sie Domains in den Entwicklereinstellungen hinzu:

  1. Gehen Sie zu Entwicklereinstellungen > Agent-Adapter – Domainbasierte Zugriffssteuerung.

  2. Geben Sie jede Domain in einer neuen Zeile ein. Das Format ist *.domain, z. B. *.mycompany.com.

Domain angeben

Das Format für die Angabe einer Domain für eine Instanz kann ein beliebiger gültiger Domainname sein und einen Platzhalter (*) enthalten, um eine beliebige Anzahl von Subdomains abzugleichen. Der Platzhalter muss am Anfang der Domain platziert werden und stimmt mit allen Subdomains überein.

Außerdem kann der Nutzer mit der Syntax <protocol>://<domain>:<port> ein Protokoll und einen Port angeben.

  • Der Port kann ein Platzhalter sein, das Protokoll jedoch nicht.
  • Wenn ein Protokoll angegeben ist, wird nur dieses Protokoll abgeglichen und der Adapter kann nicht für andere Protokolle angezeigt werden. Beispielsweise führt https://some.example.domain.com nicht zu Übereinstimmungen mit http://some.example.domain.com oder mail://some.example.domain.com.

CRM-spezifische Domains

Verwenden Sie die folgenden Domain-Namenskonventionen, wenn Sie Ihren CRM-Domainnamen eingeben.

Die eingebettete Benutzeroberfläche jedes CRM wird von bestimmten Domains geladen. Der Dynamics-Agent-Adapter wird beispielsweise von *.crm.dynamics.com geladen. Sie müssen alle Domains, die Ihr CRM verwendet, auf die Zulassungsliste setzen, wie in der folgenden Tabelle aufgeführt:

CRM Erforderliche Domains
Salesforce
  • *.visualforce.com
  • *.force.com
  • *.salesforce.com
Zendesk
  • *.zdusercontent.com
  • *.zendesk.com
Microsoft Dynamics *.crm.dynamics.com
Kustomer *.kustomerapp.com

Azure-Anwendungsregistrierung (OAuth-Client)

In diesem Abschnitt wird beschrieben, wie Sie eine Azure-Anwendungsregistrierung für Microsoft Dynamics erstellen.

Neue Anwendungsregistrierung in Azure erstellen

  1. Rufen Sie im Microsoft Azure-Portal Azure-Dienste > App-Registrierungen auf.

  2. Wählen Sie Neue Anwendungsregistrierung aus. Die Seite Anwendung registrieren wird angezeigt.

  3. Füllen Sie die Pflichtfelder aus:

    • Geben Sie im Feld Name die URL Ihrer CCAI Platform-Umgebung ohne https:// ein. Beispiel: yourcompany.domain.co.

    • Klicken Sie im Bereich Unterstützte Kontotypen auf Nur Konten im Organisationsverzeichnis.

  4. Klicken Sie auf Registrieren. Die Anwendung ist jetzt registriert.

Authentifizierungseinstellungen

In diesem Abschnitt wird beschrieben, wie Sie Authentifizierungseinstellungen im Microsoft Azure-Portal konfigurieren.

Plattformkonfiguration hinzufügen

So fügen Sie im Microsoft Azure-Portal eine Plattformkonfiguration hinzu:

  1. Nachdem Sie die registrierte App erstellt haben, rufen Sie Authentifizierung auf und geben Sie Ihre Callback-URL in das Feld Weiterleitungs-URI ein, z. B. https://yourcompany.domain.co/v1/dynamics/oauth_callback.

  2. Klicken Sie auf das Kästchen für ID-Tokens.

Neue Zertifikate und Secrets erstellen

So erstellen Sie neue Zertifikate und Secrets im Microsoft Azure-Portal:

  1. Rufen Sie Zertifikate und Secrets auf, um im Bereich Clientschlüssel hinzufügen einen neuen Schlüssel zu erstellen. Geben Sie dann im Feld Beschreibung Folgendes ein:

    1. Geben Sie eine Beschreibung ein, z. B. API-SCHLÜSSEL.

    2. Klicken Sie im Abschnitt Läuft ab auf den längsten verfügbaren Zeitraum, der von Ihrem Sicherheitsteam zugelassen wird.

    Hinweis: Diese muss neu generiert werden, wenn die Ablaufzeit erreicht ist.

  2. Klicken Sie auf Hinzufügen. Kopieren Sie den Secret-Wert sofort. Sie können ihn nicht mehr aufrufen, nachdem Sie diese Seite verlassen haben.

API-Berechtigungen hinzufügen

So fügen Sie API-Berechtigungen im Microsoft Azure-Portal hinzu:

  1. Gehen Sie zu Verwalten > API-Berechtigungen und klicken Sie auf Berechtigung hinzufügen.

  2. Klicken Sie auf Dynamics CRM.

  3. Wählen Sie Delegated permissions (Delegierte Berechtigungen) aus.

  4. Setzen Sie ein Häkchen bei user_impersonation und wählen Sie Berechtigungen hinzufügen aus.

  5. Wählen Sie unter API-Berechtigungen noch einmal Berechtigung hinzufügen aus.

  6. Wählen Sie Microsoft Graph aus.

  7. Wählen Sie Anwendungsberechtigungen aus.

  8. Fügen Sie die folgenden Anwendungsberechtigungen hinzu: Application.ReadWrite.All, Directory.Read.All und User.Read.All. Wählen Sie Berechtigungen hinzufügen aus.

  9. Wählen Sie unter API-Berechtigungen noch einmal Berechtigung hinzufügen aus.

  10. Wählen Sie Microsoft Graph und dann Delegierte Berechtigungen aus.

  11. Fügen Sie User.Read hinzu, falls es noch nicht vorhanden ist. Wählen Sie Berechtigungen hinzufügen aus.

  12. Klicken Sie in der Übersicht API-Berechtigungen auf Administratoreinwilligung für [Name Ihrer Organisation] erteilen und bestätigen Sie die Aktion im Dialogfeld. Prüfen Sie, ob in der Spalte Status für [Name Ihrer Organisation] für alle folgenden Berechtigungen Gewährt angezeigt wird:

Die Optionen für API-Berechtigungen werden angezeigt.

API Berechtigung Typ
Dynamics CRM user_impersonation Delegiert
Microsoft Graph Application.ReadWrite.All Anwendung
Microsoft Graph Directory.Read.All Anwendung
Microsoft Graph User.Read Delegiert
Microsoft Graph User.Read.All Anwendung

Anwendungsnutzer für Ihre Umgebung einrichten

So richten Sie Anwendungsnutzer für Ihre Umgebung in Microsoft Dynamics ein:

  1. Wählen Sie Ihre Umgebung aus und klicken Sie auf Einstellungen.

    Der Tab „Einstellungen“ für die Microsoft Dynamics-Umgebung wird angezeigt.

  2. Klicken Sie auf Anwendungsnutzer.

    Die Einstellungen für Anwendungsnutzer werden auf dem Tab „Umgebung“ angezeigt.

  3. Klicken Sie auf App-Nutzer einrichten.

    Das Fenster zum Einrichten eines neuen App-Nutzers in Microsoft Dynamics wird angezeigt.

    1. Wählen Sie im Feld App eine vorhandene App aus und klicken Sie auf Hinzufügen.

    2. Klicken Sie auf das Feld Geschäftseinheit und dann auf eine Geschäftseinheit.

    3. Fügen Sie die folgenden Sicherheitsrollen hinzu:

      1. Service Reader

      2. Service Writer

  4. Klicken Sie auf Erstellen.

Werte im CCAI Platform-Portal eingeben

  1. Gehen Sie zu Einstellungen > Entwicklereinstellungen.

  2. Scrollen Sie zu CRM > Agent Platform.

  3. Wählen Sie MS Dynamics aus und geben Sie die Werte für Folgendes ein:

    Feld Wert So greifen Sie darauf zu
    Active Directory-Anwendungs-ID Anwendungs- oder Client-ID Rufen Sie im Microsoft Azure-Portal App-Registrierungen > Ihre App > Übersicht auf.
    Passwort für den Active Directory-Anwendungsschlüssel aktualisieren Clientschlüsselwert Wurde im vorherigen Schritt Zertifikate und Secrets erstellt. Muss sofort nach der Erstellung kopiert werden.
    Active Directory-Mandant Verzeichnis-ID (Mandanten-ID) Rufen Sie im Microsoft Azure-Portal App-Registrierungen > Ihre App > Übersicht auf. (Hinweis: „Active Directory“ in diesem Label bezieht sich auf das, was Microsoft jetzt als Microsoft Entra ID bezeichnet.)
    Dynamics-Domain URL Ihrer Microsoft Dynamics-Umgebung Zu finden auf der Übersichtsseite der Umgebung im Power Platform-Verwaltungscenter

    Die Optionen für das Power Platform-Verwaltungscenter werden angezeigt, wobei der Tab „Umgebungen“ hervorgehoben ist.

  4. Klicken Sie auf Speichern.

Benutzerdefinierte Feldzuordnung testen

In diesem Abschnitt wird MyCustomField als Beispiel für das Hinzufügen und Zuordnen eines benutzerdefinierten Felds verwendet.

Neues benutzerdefiniertes Feld in einer Lösungskomponente erstellen

So richten Sie die benutzerdefinierte Feldzuordnung in Microsoft Dynamics ein:

  1. So erstellen Sie ein neues benutzerdefiniertes Feld in einer Lösungskomponente:

    1. Gehen Sie zu Verkäufe > Einstellungen > Lösungen.

    2. Klicken Sie oben auf der Seite Alle Lösungen auf Neu.

    3. Geben Sie TestCustomFields als Anzeigenamen ein.

    4. Klicken Sie auf Speichern und schließen.

    5. Klicken Sie auf die vorhandene Lösungskomponente.

  2. Gehen Sie zu Komponenten > Entitäten > Vorhandene hinzufügen.

  3. Klicken Sie auf die Lösungskomponente Contact.

  4. Klicken Sie auf OK, um die Details der Komponente „Contact“ aufzurufen. Das Dialogfeld „Systemformular“ für die Lösungskomponente wird angezeigt.

  5. Klicken Sie auf die Entitäts-Assets, die Sie in die Lösung aufnehmen möchten.

    1. Entitätsmetadaten einschließen.

    2. Fügen Sie Alle Assets hinzu.

      Klicken Sie in diesem Beispiel auf Entitätsmetadaten einschließen.

      Es wird ein Beispiel für die Entitäts-Assets mit den Entitätsmetadaten gezeigt.

  6. Klicken Sie auf Beenden.

  7. Gehen Sie zu Komponenten > Entitäten > Kontakt > Felder.

  8. Klicken Sie auf Neu.

  9. Im Feld „Name“ wird ein neuer Feldname eingefügt. Kopieren Sie den Feldnamen für die spätere Verwendung:

    Die Benennung des benutzerdefinierten Felds wird angezeigt, wobei das Namensfeld hervorgehoben ist.

  10. Klicken Sie auf Speichern und schließen.

Formular bearbeiten, um das benutzerdefinierte Feld anzuzeigen

Das folgende Beispiel konzentriert sich auf die zuvor konfigurierte Komponente der Kontaktlösung.

So bearbeiten Sie das Formular, um das benutzerdefinierte Feld anzuzeigen, führen Sie die folgenden Schritte in Microsoft Dynamics aus:

  1. Öffnen Sie einen Kontakt und klicken Sie auf Formular.

  2. Öffnen Sie den Feld-Explorer und filtern Sie nach Benutzerdefinierte Felder.

    Alt

  3. Doppelklicken Sie auf MyCustomField.

  4. Klicken Sie auf Speichern und dann auf Veröffentlichen, um das neue Feld dem Formular hinzuzufügen.

  5. Aktualisieren Sie den Browser, um zu prüfen, ob das Formular auf dem Kontaktbildschirm angezeigt wird.

  6. Prüfen Sie, ob MyCustomField im Formular enthalten ist.

  7. Geben Sie den ermittelten Wert in das Feld MyCustomField ein.

  8. Klicken Sie auf Speichern.

Benutzerdefinierte Feldzuordnung im Contact Center AI Platform-Portal einrichten

So richten Sie die benutzerdefinierte Feldzuordnung im Contact Center AI Platform-Portal ein:

  1. Klicken Sie im CCAI Platform-Portal auf Einstellungen > Entwicklereinstellungen. Wenn Sie das Menü Einstellungen nicht sehen, klicken Sie auf das Dreistrich-Menü .

  2. Gehen Sie zu Benutzerdefinierte Feldzuordnung und klicken Sie auf das Feld.

  3. Klicken Sie unter CRM-Feld für die Suche auf das zuvor erstellte benutzerdefinierte Feld (new_mycustomfield).

Konto- und Kundenfelder in einem benutzerdefinierten Fallformular ausfüllen

In Microsoft Dynamics werden die Kundendaten standardmäßig nur beim Erstellen eines Falls ausgefüllt. Wenn Sie diese Einstellung aktualisieren, kann das Kontaktfeld gleichzeitig mit den Kundendaten aus einem Fall ausgefüllt werden.

  1. Klicken Sie im CCAI Platform-Portal auf Einstellungen > Entwicklereinstellungen. Wenn Sie das Menü Einstellungen nicht sehen, klicken Sie auf das Dreistrich-Menü .

  2. Gehen Sie zu CRM > Account Lookup.

  3. Klicken Sie unter Objekttyp auf Kontakt.

  4. Klicken Sie das Kästchen Abgleich benutzerdefinierter Parameter verwenden an.

  5. Nachdem Sie das Häkchen gesetzt haben, wird eine Tabelle mit den Feldern Contact Field Key und Case Field Key angezeigt. Außerdem sehen Sie Optionen zum Hinzufügen, Bearbeiten oder Löschen. Wenn Sie zwischen Objekttypen wechseln, wird die Tabelle gelöscht, sofern die Felder nicht gespeichert sind.

    • Dadurch können das Feld Kontakt im Fallobjekt und das Feld Kunde mit dem Konto, das mit dem Kontakt verknüpft ist (falls vorhanden), gleichzeitig aktualisiert werden.

    • Das CRM-Ticket wird aktualisiert, wenn das Kästchen Benutzerdefinierten Parameterabgleich verwenden angeklickt ist und die Parameterkonfiguration gültig ist. Andernfalls wird die Standardlogik zum Aktualisieren des CRM verwendet. Wenn alle Parameter richtig konfiguriert sind, werden sie alle aktualisiert. Wenn Parameter falsch konfiguriert sind, werden nur die korrekt konfigurierten Parameter aktualisiert.

Test USER segment DAP

So testen Sie eine DAP:

  1. Klicken Sie im CCAI Platform-Portal auf Einstellungen > Warteschlange. Wenn Sie das Menü Einstellungen nicht sehen, klicken Sie auf Menü.

  2. Bevorzugten Social-Media-Kanal auswählen

  3. Gehen Sie im Bereich Einstellungen zu Zugriffspunkt und klicken Sie neben dem zu aktualisierenden Zugriffspunkt auf das Bearbeitungssymbol.

    Die Optionen zum Aktualisieren des Direct Access Point werden angezeigt.

  4. Geben Sie im Feld Benutzerdefiniertes Nutzersegmentfeld im CRM den Namen des Felds im CRM ein, das die Informationen zum Nutzersegment enthält, z. B. new_mycustomfield.

  5. Wählen Sie Aktualisieren aus.

Fehlerbehebung

In diesem Abschnitt werden häufige Probleme und ihre Lösungen beschrieben.

Agent-Adapter nicht sichtbar

Wenn der Agent-Adapter nach Änderungen an der Administratorkonfiguration nicht sichtbar ist, sollten die Agenten Folgendes tun:

  • Rechtsklicken Sie auf den Bereich des Agent-Adapters.

  • Wählen Sie Frame neu laden aus.

Dadurch wird der Adapter mit der neuesten Konfiguration neu geladen.

Allgemeine Probleme

Symptom Mögliche Ursache Lösung
Adapter bricht sofort nach der Einrichtung ab Fehlende CRM-spezifische Domains in der domainbasierten Zugriffssteuerung Prüfen Sie, ob alle erforderlichen Domains hinzugefügt wurden (siehe CRM-spezifische Domains oben). Achten Sie bei MS Dynamics darauf, dass *.crm.dynamics.com enthalten ist.
Adapter wird nach Domainänderungen nicht geladen Verzögerung bei der Domainweitergabe Es kann bis zu einer Minute dauern, bis die Änderungen wirksam werden. Führen Sie die oben beschriebene Aktion Frame neu laden aus.
OAuth-Authentifizierungsfehler Falsche Anwendungs-ID, falsches Schlüsselpasswort oder falsche Mandanten-ID Prüfen Sie die Werte unter Einstellungen > Entwicklereinstellungen > CRM > Agent Platform noch einmal. Prüfen Sie, ob der Clientschlüssel abgelaufen ist.
API-Berechtigungsfehler Administrator-Einwilligung nicht erteilt oder Berechtigungen fehlen Rufen Sie im Microsoft Azure-Portal API-Berechtigungen auf und prüfen Sie, ob alle fünf Berechtigungen vorhanden sind und die Administratoreinwilligung erteilt wurde (siehe Tabelle mit der Zusammenfassung der Berechtigungen unter „Authentifizierungseinstellungen“).
Connector während der Installation instabil Die Installation wird ausgeführt Die Installation dauert 5–10 Minuten. Warten Sie, bis der Vorgang abgeschlossen ist, und aktualisieren Sie dann die Agent-Seite.
Clientschlüssel abgelaufen Das Secret hat das konfigurierte Ablaufdatum erreicht Generieren Sie unter Zertifikate und Secrets einen neuen Clientschlüssel, kopieren Sie den Wert sofort und aktualisieren Sie das Feld Schlüsselpasswort im CCAI Platform-Portal.

Wenn Sie weitere Unterstützung benötigen, wenden Sie sich an den CCAI Platform-Support.