View a markdown version of this page

Integrieren von Drittanbieteranwendungen (3P-Apps) in den im Amazon-Connect-Workspace für Kundendienstmitarbeiter - Amazon Connect

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Integrieren von Drittanbieteranwendungen (3P-Apps) in den im Amazon-Connect-Workspace für Kundendienstmitarbeiter

Amazon Connect Agent Workspace ist eine einzige, intuitive Anwendung, die Ihren Agenten die Tools und step-by-step Anleitungen bietet, die sie benötigen, um Probleme effizient zu lösen, das Kundenerlebnis zu verbessern und das Onboarding zu beschleunigen. Sie können nicht nur Erstanbieteranwendungen in Ihrem Arbeitsbereich für Agenten verwenden, z. B. Kundenprofile, Kundenvorgänge und Connect AI-Agenten, sondern auch Anwendungen von Drittanbietern integrieren.

Anmerkung

Diese Funktion wird nur im Standard-Workspace für Kundendienstmitarbeiter unterstützt. Bei Verwendung eines benutzerdefinierten CCP wird sie nicht unterstützt.

Sie können beispielsweise Ihr eigenes Reservierungssystem oder ein vom Anbieter bereitgestelltes Metrik-Dashboard in den Arbeitsbereich für Agenten integrieren. Amazon Connect

Wenn Sie als Entwickler eine Drittanbieteranwendung erstellen, finden Sie weitere Informationen im Entwicklerhandbuch für den Kundendienstmitarbeiter-Workspace.

Voraussetzungen

Wenn Sie zur Verwaltung des Zugriffs auf Drittanbieteranwendungen benutzerdefinierte IAM-Richtlinien verwenden, benötigen die Benutzer die folgenden IAM-Berechtigungen, um eine Drittanbieteranwendung mithilfe der AWS-Managementkonsole zu integrieren. Zusätzlich zu AmazonConnect_FullAccess benötigen Benutzer Folgendes:

JSON
{ "Version":"2012-10-17", "Statement": [ { "Action": [ "app-integrations:CreateApplication", "app-integrations:GetApplication", "iam:GetRolePolicy", "iam:PutRolePolicy", "iam:DeleteRolePolicy" ], "Resource": "arn:aws:app-integrations:us-east-1:111122223333:application/*", "Effect": "Allow" } ] }

Integrationen

Anmerkung

Um Ihren Instances eine Integration hinzuzufügen, stellen Sie sicher, dass Ihre Instanz eine Service-Linked Role (SLR) verwendet. Wenn Ihre Instance derzeit keine SLR verwendet, Sie aber eine Integration hinzufügen möchten, müssen Sie zu einer SLR migrieren. Die Integration kann nur zu Instanzen hinzugefügt werden, die eine Spiegelreflexkamera verwenden. Weitere Informationen finden Sie unter Für Instances, die vor Oktober 2018 erstellt wurden.

  1. Öffnen Sie die Amazon Connect Konsole (https://console.aws.amazon.com/connect/).

  2. Wählen Sie im linken Navigationsbereich Integrationen aus. Wenn Sie dieses Menü nicht sehen, liegt das daran, dass es in Ihrer Region nicht verfügbar ist. Informationen zu den Regionen, in denen dieses Feature verfügbar ist, finden Sie unter Verfügbarkeit von Amazon Connect Funktionen nach Regionen.

  3. Wählen Sie auf der Seite Integrationen die Option Integration hinzufügen aus.

    Die Seite „Eigenschaften“ für den Block „Kontaktattribute festlegen“
  4. Geben Sie auf der Seite Integration hinzufügen Folgendes ein:

    1. Grundlegende Informationen

      1. Anzeigename: Ein benutzerfreundlicher Name für die Integration. Dieser Name wird in Sicherheitsprofilen und außerdem Kundendienstmitarbeitern auf der Registerkarte im Kundendienstmitarbeiter-Workspace angezeigt. Sie können diesen Namen an dieser Stelle jederzeit ändern.

      2. Beschreibung (optional): Sie können optional eine beliebige Beschreibung für diese Integration angeben. Diese Beschreibung wird Kundendienstmitarbeitern nicht angezeigt.

      3. Integrationstyp: Gibt an, ob es sich bei der Integration um eine Standard-Webanwendung, einen Dienst oder einen MCP-Server handelt. Dies bestimmt, wie innerhalb des Systems auf die Integration zugegriffen wird.

      4. Integrations-ID: Der offizielle Name, der für Integrationen vom Typ Standardanwendung oder Dienst eindeutig ist. Wenn Sie nur eine Anwendung pro Zugriffs-URL haben, empfehlen wir Ihnen, den Ursprung der Zugriffs-URL zu verwenden. Dieser Name kann nicht geändert werden.

      5. Timeout Initialisierung: Die maximal zulässige Zeit für die Herstellung einer Verbindung mit dem Workspace. Die zulässige Zeit wird in Millisekunden angegeben. Diese Einstellung hilft bei der Bewältigung von Verbindungsproblemen und gewährleistet einen rechtzeitigen Anwendungsstart.

    2. Einzelheiten der Anwendung

      1. Kontaktbereich: Gibt an, ob die Webanwendung für jeden Kontakt oder nur bei jeder neuen Browsersitzung aktualisiert wird. Diese Einstellung wirkt sich darauf aus, wie oft die Anwendung ihre Daten aktualisiert.

      2. Timeout Initialisierung: Die maximal zulässige Zeit für die Herstellung einer Verbindung mit dem Workspace. Die zulässige Zeit wird in Millisekunden angegeben. Diese Einstellung hilft bei der Bewältigung von Verbindungsproblemen und gewährleistet einen rechtzeitigen Anwendungsstart.

    3. Access

      1. Zugriffs-URL: Dies ist die URL, unter der Ihre Anwendung gehostet wird. Die URL muss sicher sein und mit „https“ beginnen, es sei denn, es handelt sich um einen lokalen Host.

        Anmerkung

        Nicht alle URLs können per iframe dargestellt werden. Im Folgenden finden Sie zwei Möglichkeiten, wie Sie prüfen können, ob die URL mit einem iframe versehen werden kann:

        1. Sie können das Drittanbieter-Tool Iframe Tester verwenden, um zu prüfen, ob eine URL mit einem iframe versehen werden kann.

          1. Wenn eine URL mit einem iframe versehen werden kann, wird sie in einer Vorschau auf dieser Seite gerendert.

          2. Wenn eine URL nicht mit einem iframe versehen werden kann, wird in der Vorschau auf dieser Seite ein Fehler angezeigt.

            • Es ist möglich, dass auf dieser Website ein Fehler angezeigt wird und die App trotzdem im Arbeitsbereich für Kundendienstmitarbeiter mit einem iframe versehen werden kann. Das liegt daran, dass der App-Entwickler seine App so sperren kann, dass sie nur in den Arbeitsbereich eingebettet werden kann und sonst nirgends. Wenn Sie diese App von einem App-Entwickler erhalten haben, empfehlen wir, trotzdem zu versuchen, diese App in den Arbeitsbereich für Kundendienstmitarbeiter zu integrieren.

        2. Für technische versierte Benutzer: Prüfen Sie den Inhalt der Sicherheitsrichtlinien der Anwendung, die Sie integrieren möchten.

          1. Firefox: Dreistrich-Menü > Weitere Werkzeuge > Werkzeuge für Web-Entwickler > Netzwerk

          2. Chrome: Dreipunkt-Menü > Weitere Tools > Entwicklertools > Netzwerk

          3. Andere Browser: Suchen Sie in den Entwicklertools nach den Netzwerkeinstellungen.

          4. Die Content-Security-Policy Frame-Ancestors-Direktive sollte es sein. https://your-instance.my.connect.aws

            1. Wenn die Direktive same origin oder istdeny, kann diese URL nicht von AWS/Amazon Connect gerahmt werden

        Sie haben folgende Möglichkeiten, wenn die App nicht mit einem Iframe versehen werden kann:

        • Wenn Sie die App/URL verwalten, können Sie die Inhaltssicherheitsrichtlinie der App aktualisieren. Folgen Sie dabei diesen bewährten Methoden für App-Entwickler und stellen Sie sicher, dass Apps nur in den Kundendienstmitarbeiter-Workspace von Connect eingebettet werden können.

        • Wenn Sie die App/URL nicht verwalten, können Sie versuchen, den App-Entwickler zu kontaktieren und ihn zu bitten, die Inhaltssicherheitsrichtlinie der App zu aktualisieren.

      2. Zulässige Ursprünge (optional): Zulassungsliste URLs , die zulässig sein sollte, sofern sie sich von der Zugriffs-URL unterscheidet. Die URL muss sicher sein und mit „https“ beginnen, es sei denn, es handelt sich um einen lokalen Host.

    4. Fügen Sie Berechtigungen zu Ereignissen und Anforderungen hinzu.

      Im Folgenden finden Sie ein Beispiel dafür, wie Sie mithilfe der AWS-Managementkonsole eine neue Anwendung einbinden und ihr Berechtigungen zuweisen können. In diesem Beispiel werden der Anwendung sechs verschiedene Berechtigungen zugewiesen.

      Bereitstellung grundlegender Informationen und Zugangsdetails

    5. Instance-Zuordnung

      1. Sie können jeder Instance innerhalb dieser Kontoregion Zugriff auf diese Anwendung gewähren.

      2. Die Verknüpfung der Integration mit einer Instanz ist zwar optional, Sie können diese Anwendung jedoch erst verwenden, wenn Sie sie einer oder mehreren Instanzen zuordnen.

        Anmerkung

        Für MCP-Server können Sie nur die Instanz auswählen, die mit der Discovery-URL des ausgewählten Gateways konfiguriert ist.

    Bereitstellung grundlegender Informationen und Zugangsdetails.

    Erteilen von Berechtigungen für die Anwendung zur Workspace-Datenintegration

    Erteilen von Berechtigungen für die Anwendung zur Workspace-Datenintegration

    Iframe-Konfiguration

    Iframe-Konfiguration.
  5. Wählen Sie Add Integration (Integration hinzufügen) aus.

  6. Wenn die Integration erfolgreich erstellt wurde, werden Sie zur Seite mit den Integrationsdetails weitergeleitet. Dort wird ein Erfolgsbanner angezeigt.

    Erteilen von Berechtigungen für die Anwendung zur Workspace-Datenintegration

    Sie können bestimmte Attribute einer vorhandenen App bearbeiten, z. B. ihren Anzeigenamen, ihre Zugriffs-URL und ihre Berechtigungen.

    1. Wenn beim Erstellen der Anwendung oder beim Zuordnen der Anwendung zu einer Instance ein Fehler aufgetreten ist, wird eine Fehlermeldung angezeigt und Sie können die entsprechende Maßnahme ergreifen, um das Problem zu beheben.

Integrationen löschen

Wenn Sie eine Integration in absehbarer Zeit nicht mehr verwenden möchten, können Sie sie löschen. Wenn Sie sie vorübergehend nicht, sie aber in absehbarer Zeit erneut verwenden möchten, empfehlen wir, die Verbindung zu einer Instance zu trennen, um zu vermeiden, dass Sie sie erneut hinzufügen müssen. Um Integrationen zu löschen, navigieren Sie zu AWS-Managementkonsole, wählen Sie eine Integration aus und wählen Sie Löschen.

Fehlersuche

  • Der Vorgang schlägt fehl, wenn die Integration mit einer Instanz verknüpft ist. Sie müssen zuerst die Integration von einer beliebigen Instanz trennen. Dann können Sie zurückkommen und es löschen.

Tipp

Wenn Sie eine Integration vor dem 15. Dezember 2023 erstellt haben, können Probleme auftreten, wenn Sie die Zuordnung der Integration zu Instanz (en) aktualisieren. Dies liegt daran, dass Sie Ihre IAM-Richtlinie aktualisieren müssen.

IAM-Fehler beim Versuch, eine Integration aufgrund unzureichender Berechtigungen zu löschen

Ihre IAM-Richtlinie muss so aktualisiert werden, dass sie die folgenden Berechtigungen enthält:

  • app-integrations:CreateApplicationAssociation

  • app-integrations:DeleteApplicationAssociation

JSON
{ "Version":"2012-10-17", "Statement": [ { "Action": [ "app-integrations:CreateApplication", "app-integrations:GetApplication" ], "Resource": "arn:aws:app-integrations:us-east-1:111122223333:application/*", "Effect": "Allow" }, { "Action": [ "app-integrations:CreateApplicationAssociation", "app-integrations:DeleteApplicationAssociation" ], "Resource": "arn:aws:app-integrations:us-east-1:111122223333:application-association/*", "Effect": "Allow" }, { "Action": [ "iam:GetRolePolicy", "iam:PutRolePolicy", "iam:DeleteRolePolicy" ], "Resource": "arn:aws:iam::111122223333:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_*", "Effect": "Allow" } ] }