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. # Integration für Anwendungen in Amazon Connect einrichten Diese Integrationen verwenden die von Amazon Connect empfohlenen Anwendungen, um Amazon Connect Customer Profiles regelmäßig zu aktualisieren. ## Bevor Sie beginnen ### Massenaufnahme von Daten Wenn Sie Ihre Integration einrichten, werden Sie aufgefordert, ein Datum einzugeben, ab dem Sie Daten aufnehmen möchten. Wenn Sie ein Datum vor mehr als zwei Monaten auswählen, aktiviert Customer Profiles automatisch eine Massenaufnahme über mehrere neu erstellte Flows. Auf diese Weise müssen Sie nicht berechnen, wie viele Flows Sie für die Datenaufnahme benötigen. Wenn die automatische Massenaufnahme aktiviert ist, geht Customer Profiles wie folgt vor: + Legt die Batchgröße auf zwei Monate fest. + Wiederholt die Versuche bei vorübergehenden Fehlern bis zu dreimal. Du kannst die [CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html)API verwenden, um deine eigene Batchgröße aufzurufen. ### Warum werde ich aufgefordert, eine IAM-Rolle auszuwählen oder zu erstellen? Für Salesforce, Marketo und Customer Profiles trägt Customer Profiles dazu bei ServiceNow, die historische Erfassung dieser Quellen zu verbessern, indem Sie mithilfe Ihrer IAM-Rolle mehrere Workflows erstellen, mit denen Sie Ihre Daten schnell und effizient aufnehmen können. Wenn Sie für diese Quellen unter **Datum für den Import von Datensätzen** einen Zeitraum von mehr als 60 Tagen auswählen, werden Sie aufgefordert, eine neue IAM-Rolle zu erstellen oder eine bestehende Rolle auszuwählen. Diese Rolle erlaubt Customer Profiles, Ihre Integration zu verwalten. Sie gewährt Customer Profiles die erforderlichen Berechtigungen zur Erstellung und Aktualisierung eines Workflows zur Datenaufnahme. Nach Abschluss des Workflows erstellt Customer Profiles eine standardmäßige, kontinuierliche Integration, die Ihre neuen Daten aufnimmt, sobald sie in Ihrer Quelle aktualisiert werden. Die in der Konsole erstellte Rolle kann nur von der Domain verwendet werden, in der sie erstellt wurde. Dies liegt daran, dass Amazon Connect den Zugriff auf die Rolle auf den von dieser Domain verwendeten KMS-Schlüssel beschränkt. Weitere Informationen finden Sie unter [Zugriffsgewährung auf Ihre Customer-Profiles-Ausführungsrolle mit den geringsten Berechtigungen](#grant-least-privilege-cp). ## Zugriffsgewährung auf Ihre Customer-Profiles-Ausführungsrolle mit den geringsten Berechtigungen Wenn Sie Ihre eigene IAM-Rolle erstellen möchten, empfehlen wir, die im folgenden Code angegebenen Berechtigungen zu verwenden, um die Rolle auf die geringsten Berechtigungen zu beschränken. Verwenden Sie das folgende Snippet, um Ihre Rolle manuell zu erstellen. Verwenden Sie Ihren eigenen KMS-Schlüssel und geben Sie bei Bedarf Ihre Region an. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Condition": { "ForAnyValue:StringEquals": { "aws:RequestTag/awsOwningService": "customer-profiles-integration-workflow" } }, "Action": [ "appflow:CreateFlow", "appflow:TagResource", "profile:TagResource", "profile:PutIntegration" ], "Resource": "*", "Effect": "Allow", "Sid": "CreateFlowResources" }, { "Action": [ "appflow:UseConnectorProfile" ], "Resource": "*", "Effect": "Allow", "Sid": "UseConnectorResources" }, { "Condition": { "ForAnyValue:StringEquals": { "aws:ResourceTag/awsOwningService": "customer-profiles-integration-workflow" } }, "Action": [ "appflow:DescribeFlow", "appflow:DescribeFlowExecutionRecords", "appflow:DeleteFlow", "appflow:StartFlow", "appflow:StopFlow", "appflow:UpdateFlow", "profile:DeleteIntegration" ], "Resource": "*", "Effect": "Allow", "Sid": "AccessFlowResources" }, { "Action": [ "kms:CreateGrant", "kms:ListGrants" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KeyId" ], "Condition": { "StringEquals": { "kms:ViaService": [ "appflow.us-east-1.amazonaws.com" ] } }, "Effect": "Allow", "Sid": "KMSAppflow" }, { "Action": [ "kms:CreateGrant" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KeyId" ], "Condition": { "StringEquals": { "kms:ViaService": [ "profile.us-east-1.amazonaws.com" ] }, "ForAllValues:StringEquals": { "kms:GrantOperations": [ "Decrypt" ] } }, "Effect": "Allow", "Sid": "KMSCustomerProfiles" } ] } ``` ------ ## Überwachen Ihrer Customer-Profiles-Integrationen Falls die Integration nach der Verbindungserstellung nicht mehr funktioniert, löschen Sie die Integration und verbinden Sie sie dann erneut. ## Was ist zu tun, wenn keine Objekte gesendet werden Klicken Sie auf **Flow-Details** wenn ein Objekt nicht gesendet wird, um zu erfahren warum der Vorgang fehlgeschlagen ist. Möglicherweise müssen Sie die Konfiguration löschen und erneut eine Verbindung zur externen Anwendung herstellen. # Einrichten der Integration für Amazon-Connect-Supportfälle Um Ihre Amazon Connect Falldaten in Amazon Connect Connect-Kundenprofilen zu aktualisieren und Funktionen wie berechnete Attribute zu verwenden, können Sie sie mithilfe von Amazon integrieren AppIntegrations. Richten Sie zunächst einen Cases-Event-Stream ein, um Systemfelder an einen EventBridge Bus zu senden, und leiten Sie diese Ereignisse dann über Amazon AppIntegrations an Kundenprofile weiter. ## Streamen von Daten von Amazon-Connect-Supportfällen zu Event Bridge 1. Öffnen Sie die Amazon Connect Connect-Konsole unter [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/). 1. Wählen Sie auf der Seite „Instances“ den Instance-Alias aus. Der Instance-Alias ist auch Ihr **Instance-Name**, der in Ihrer Amazon-Connect-URL erscheint. In der folgenden Abbildung sehen Sie die Seite **Instances des virtuellen Contact Centers für Amazon Connect** mit einem Rahmen um den Instance-Alias. ![\[Der Alias der Instance.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png) 1. Wählen Sie im Navigationsbereich **Fälle** aus und notieren Sie sich Ihre Cases-Domain-ID aus dem Abschnitt **Domain-Details**. ![\[Die Seite „Fälle“ mit dem Abschnitt „Domain-Details“ und einem Pfeil, der auf die Domain-ID zeigt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png) 1. Verwenden Sie die AWS CLI, erstellen Sie eine Fallereigniskonfiguration, um Amazon Connect Cases Events an Ihren AWS-Konto standardmäßigen Event Bridge-Bus zu senden. ``` // set up Case Event Configuration including all system fields aws connectcases put-case-event-configuration --domain-id  --region  --event-bridge "{                          \"enabled\": true,     \"includedData\": {        \"caseData\": {           \"fields\": [           {           \"id\": \"status\"           },           {           \"id\": \"title\"           },           {           \"id\": \"summary\"           },           {           \"id\": \"reference_number\"           },           {           \"id\": \"created_datetime\"           },           {           \"id\": \"last_updated_datetime\"           },           {           \"id\": \"last_closed_datetime\"           },                 {           \"id\": \"customer_id\"           }         ]       }     }   }" ``` 1. Öffnen Sie die Event Bridge-Konsole für Ihre AWS Region. Zum Beispiel [https://us-west-2.console.aws.amazon.com/events/Zuhause? region=us-west-2\$1/eventbuses](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses) 1. Wählen Sie **Event Bus erstellen** aus. ![\[Die Seite Event-Busse in der EventBridge Amazon-Konsole, die Schaltfläche Event-Bus erstellen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png) 1. Erstellen Sie einen Event Bus mit dem Namen `connect-cases-to-customer-profiles`. ![\[Die Seite „Event Bus erstellen“ mit dem Feld „Name“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png) 1. Kehren Sie zu Ihrem **Standard-Event-Bus** zurück und erstellen Sie eine Regel mit dem Namen `connect-cases-to-customer-profiles-rule`. ![\[Der Standard-Event-Bus mit der Schaltfläche „Regel erstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png) ![\[Der Schritt „Ereignismuster erstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png) + Ereignismuster-Snippet: ``` {   "source": ["aws.cases"],   "detail": {     "eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]   } } ``` ![\[Der Abschnitt „Erstellungsmethode“, die Option „Benutzerdefiniertes Muster (JSON-Editor)“, der Code des Ereignismusters.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png) + Wählen Sie **Direkt zu Überprüfen und Erstellen** und anschließend **Regel erstellen** aus. ![\[Die Schaltfläche „Direkt zu Überprüfen und Erstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png) ## Nehmen Sie Event Bridge-Falldaten in Kundenprofile auf, indem Sie AppIntegrations 1. Erstellen Sie mit dem AWS CLI eine Event-Integration mit AppIntegrations und zeichnen Sie die ARN-Ausgabe auf.  Diese stellt die Quelldaten dar, die eine Amazon-Connect-Instance verwenden kann. ``` aws appintegrations create-event-integration --region  --name Connect-Cases-Event-Integration --event-bridge-bus connect-cases-to-customer-profiles --event-filter "{\"Source\": \"aws.cases\" }" --description "Event Integration for Cases Event Bus" ``` 1. Erstellen Sie mithilfe der AWS CLI Put-Integrations-API eine Integration mit Kundenprofilen. Dadurch wird der Datenfluss zu Customer Profiles gestartet, wobei die Platzhalterwerte durch den Ereignisintegrations-ARN und den Namen der Customer-Profiles-Domain ersetzt werden. ``` aws customer-profiles put-integration --region  --domain-name   --uri  --object-type-name Connect-case ``` ## Überprüfen der Supportfälle-Integration 1. Erstellen Sie einen Fall in Amazon-Connect-Supportfälle. 1. Das Ereignis dürfte unmittelbar empfangen werden. Sie sollten trotzdem kurz warten, bis es vorliegt und sie es mit dem Kundenprofil verknüpfen können. 1. Suchen Sie mithilfe von das AWS CLI Connect-Case-Objekt unter dem Profil und ersetzen Sie die Platzhalter durch die richtigen Werte. ``` aws customer-profiles list-profile-objects --domain-name  --region --object-type-name Connect-case --profile-id ``` 1. Wenn Sie in der Antwort auf den obigen API-Aufruf kein Element finden, liegt ein Problem mit der Integration vor. Fehlerbehebung: 1. Gehen Sie zur EventBridge Amazon-Konsole. 1. Prüfen Sie, ob der Aktiv EventSource ist und der Abgleich EventBus existiert und läuft. 1. Prüfen Sie, ob die Fallereigniskonfiguration korrekt konfiguriert ist. 1. Wenn diese funktionieren, wenden Sie sich an uns, Support um Unterstützung bei der Untersuchung des Problems zu erhalten. # Richten Sie die Amazon Connect Connect-Integration mit Salesforce ServiceNow, Marketo oder Zendesk ein Um Ihre Amazon Connect Connect-Kundenprofile regelmäßig zu aktualisieren, können Sie Amazon in Salesforce ServiceNow, Marketo oder Zendesk integrieren. AppFlow Sie richten zuerst die Verbindung in Amazon Connect und der Anwendung Ihrer Wahl ein und prüfen dann die Integration. ## Richten Sie die Verbindung in Amazon Connect und Salesforce ServiceNow, Marketo oder Zendesk ein 1. Öffnen Sie die Amazon Connect Connect-Konsole unter [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/). 1. Wählen Sie auf der Seite „Instances“ den Instance-Alias aus. Der Instance-Alias ist auch Ihr **Instance-Name**, der in Ihrer Amazon-Connect-URL erscheint. In der folgenden Abbildung sehen Sie die Seite **Instances des virtuellen Contact Centers für Amazon Connect** mit einem Rahmen um den Instance-Alias. ![\[Die Seite „Instances des virtuellen Contact Centers für Amazon Connect“, „Instance Alias“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/instance.png) 1. Wählen Sie im Navigationsbereich **Customer Profiles** aus. 1. Wählen Sie wie in der folgenden Abbildung gezeigt auf der **Konfigurationsseite für Kundenprofile** die Option **Integration hinzufügen** aus. ![\[Die Konfigurationsseite für Kundenprofile, die Schaltfläche „Integration hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png) 1. Wählen Sie auf der Seite **Datenquelle auswählen** die externe Anwendung, aus der Sie Kundenprofildaten abrufen möchten. Sie können sich die [Integrationsanforderungen](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html) ansehen, um die für Ihre Anwendung erforderlichen Verbindungsanforderungen besser zu verstehen. ![\[Die Seite „Datenquelle auswählen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png) 1. Wählen Sie auf der Seite **Verbindung herstellen** eine der folgenden Optionen aus: + **Bestehende Verbindung verwenden**: Auf diese Weise können Sie bestehende AppFlow Amazon-Ressourcen, die Sie möglicherweise in Ihrem AWS-Konto erstellt haben, wiederverwenden. + **Neue Verbindung erstellen**: Geben Sie die von der externen Anwendung geforderten Informationen ein. ![\[Die Seite „Verbindung herstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png) 1. Wählen Sie auf der Seite mit den **Integrationsoptionen** aus, welche Quellobjekte Sie aufnehmen möchten, und wählen Sie deren Objekttyp aus. Objekttypen speichern Ihre aufgenommenen Daten. Sie geben außerdem vor, wie Objekte aus Ihren Integrationen den Profilen bei der Aufnahme zugeordnet werden sollen. Customer Profiles bietet standardmäßige Objekttypvorlagen, mit denen Sie vorgeben können, wie Attribute in Ihren Quellobjekten den Standardobjekten in Customer Profiles zugeordnet werden sollen. Sie können auch die Objektzuordnungen verwenden, die Sie aus dem erstellt haben. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) Wenn Sie die Salesforce-Integration für die vom Benutzer erstellte Datenzuordnung hinzufügen oder erstellen, müssen Sie die spezifische Datenzuordnung vorgeben, da sonst die Salesforce-Standarddatenzuordnung für den Objekttyp ausgewählt wird. Sie können Ihre Datenzuordnung erstellen und sie später bei der Einrichtung eines speziellen Daten-Connectors verwenden. ![\[Die Seite mit den Integrationsoptionen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-integration-options.png) 1. Für das **Aufnahme-Startdatum** beginnt Customer Profiles die Aufnahme von Datensätzen, die nach diesem Datum erstellt wurden. Standardmäßig ist das Datum für den Import von Datensätzen auf einen 30-Tage-Vorlauf festgelegt. 1. Vergewissern Sie sich auf der Seite **Überprüfen und Integrieren**, dass der **Verbindungsstatus** **Verbunden** lautet, und klicken Sie dann auf **Integration erstellen**. ![\[Die Seite „Überprüfen und integrieren“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png) 1. Nachdem die Integration eingerichtet wurde, klicken Sie wieder auf der Seite **Konfiguration für Kundenprofile** auf **Objekte anzeigen**, um zu sehen, welche Daten gebündelt und gesendet werden. Derzeit nimmt dieser Prozess Datensätze auf, die in den letzten 30 Tagen erstellt oder geändert wurden. ![\[Die Konfigurationsseite „Kundenprofile“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-objects.png) # Einrichten einer Segment-Integration, um regelmäßige Aktualisierungen für Amazon Connect Customer Profiles bereitzustellen Um Ihre Amazon Connect Connect-Kundenprofile regelmäßig zu aktualisieren, können Sie die Integration mit Segment über Amazon vornehmen AppFlow. Sie richten zuerst die Verbindung in Amazon Connect und Segment ein, und prüfen dann die korrekte Segment-Integration. ## Verbindungseinrichtung in Amazon Connect und Segment 1. Öffnen Sie die Amazon Connect Connect-Konsole unter [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/). 1. Wählen Sie auf der Seite „Instances“ den Instance-Alias aus. Der Instance-Alias ist auch Ihr **Instance-Name**, der in Ihrer Amazon-Connect-URL erscheint. In der folgenden Abbildung sehen Sie die Seite **Instances des virtuellen Contact Centers für Amazon Connect** mit einem Rahmen um den Instance-Alias. ![\[Die Seite „Instances des virtuellen Contact Centers für Amazon Connect“, „Instance Alias“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/instance.png) 1. Wählen Sie im Navigationsbereich **Customer Profiles** aus. 1. Wählen Sie auf der **Konfigurationsseite für Kundenprofile** die Option **Integration hinzufügen** aus. ![\[Die Konfigurationsseite für Kundenprofile, die Schaltfläche „Integration hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png) 1. Wählen Sie auf der Seite **Datenquelle auswählen** die Option **Segment** aus. Überprüfen Sie die Anwendungsanforderungen, die auf der Seite **Anwendung auswählen** aufgeführt sind. ![\[Die Seite „Datenquelle auswählen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png) 1. Wählen Sie auf der Seite **Verbindung herstellen** eine der folgenden Optionen aus: + **Bestehende Verbindung verwenden**: Auf diese Weise können Sie vorhandene EventBridge Amazon-Ressourcen wiederverwenden, die Sie möglicherweise in Ihrem erstellt haben AWS-Konto. + **Neue Verbindung erstellen**: Geben Sie die von der externen Anwendung geforderten Informationen ein. ![\[Die Seite „Verbindung herstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png) + **Verbindungsname**: Geben Sie einen Namen für die Verbindung ein. Der Verbindungsname wird von Integrationen referenziert, die diese Verbindung verwenden. + **Verbindungs-URL**: Geben Sie die Verbindungs-URL Ihrer Anwendung ein. Diese URL wird für Deep-Links zu den Objekten verwendet, die in Ihrer externen Anwendung erstellt wurden. Die Verbindungs-URL ist die Segment-Workspace-URL, die auf der Anwendungswebsite verfügbar ist. So finden Sie die Workspace-URL: 1. Loggen Sie sich bei Ihrem „segment.com“-Konto ein. 1. Navigieren Sie zu **Einstellungen**, **Allgemeine Einstellungen**. 1. Kopieren Sie die URL aus dem Browser. 1. Customer Profiles verwendet Amazon EventBridge für Integrationen mit Segment. Kopieren Sie auf der Seite zum **Einrichten der Quelle** Ihre AWS-Konto ID in Ihre Zwischenablage und wählen Sie dann **Log in to Segment aus, um** Amazon EventBridge zu konfigurieren. 1. Gehen Sie wie folgt vor, um Segment einzurichten: 1. Melden Sie sich bei Segment an. 1. Wählen Sie in Ihrer Anwendung eine Quelle aus, um das Ziel für Amazon einzurichten EventBridge. 1. Fügen Sie Ihre AWS-Konto ID ein und wählen Sie Ihre AWS Region aus. 1. Setzen Sie den Schalter auf **EIN**, um Ihre Partner-Eventquelle zu aktivieren. 1. Navigieren Sie zu **Event Tester** und senden Sie ein Testevent, um die Aktivierung Ihrer Partner-Eventquelle abzuschließen. 1. **Client-ID**: Dies ist eine Zeichenfolge, die den Client in Ihrer externen Anwendung eindeutig identifiziert. Diese Client-ID ist der Quellenname, der auf der Anwendungs-Website verfügbar ist. Mit der von Ihnen angegebenen ID wird der Client identifiziert von dem Customer Profiles Ihre Objekte aufnehmen soll. So finden Sie Ihre Source-ID: 1. Navigieren Sie zu **Quellen** und wähle eine Quelle aus. 1. Navigieren Sie zu **Einstellungen**, **API-Schlüssel**. 1. Kopieren Sie Ihre **Source-ID**. Nachdem Sie das Ziel für die Ereignisquelle eingerichtet haben, kehren Sie zur Customer-Profiles-Konsole zurück und fügen Sie dort die Client-ID ein. 1. Es wird eine Mitteilung angezeigt, dass Amazon Connect eine Verbindung mit Segment hergestellt hat. 1. Wählen Sie auf der Seite mit den **Integrationsoptionen** aus, welche Quellobjekte Sie aufnehmen möchten, und wählen Sie deren Objekttyp aus. Objekttypen speichern Ihre aufgenommenen Daten. Sie geben außerdem vor, wie Objekte aus Ihren Integrationen den Profilen bei der Aufnahme zugeordnet werden sollen. Customer Profiles bietet standardmäßige Objekttypvorlagen, mit denen Sie vorgeben können, wie Attribute in Ihren Quellobjekten den Standardobjekten in Customer Profiles zugeordnet werden sollen. Sie können auch die Objektzuordnungen verwenden, die Sie aus dem erstellt haben. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) ![\[Die Seite „Integrationsoptionen“, der Abschnitt „Objekttyp“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png) 1. Für das **Aufnahme-Startdatum** beginnt Customer Profiles die Aufnahme von Datensätzen, die nach der Erstellung der Integration erstellt wurden. **Anmerkung** Wenn Sie historische Datensätze benötigen, können Sie [Amazon S3 als Integrationsquelle für deren Import verwenden](customer-profiles-object-type-mappings.md). 1. Vergewissern Sie sich auf der Seite **Überprüfen und Integrieren**, dass der **Verbindungsstatus** **Verbunden** lautet, und klicken Sie dann auf **Integration hinzufügen**. 1. Nachdem die Integration eingerichtet wurde, wird auf der Seite mit der **Konfiguration der Kundenprofile** unter **Integrationen** angezeigt, welche Integrationen derzeit eingerichtet sind. Die Optionen **Letzte Ausführung** und **Integrationsintegrität** sind derzeit für diese Art von Integration nicht verfügbar. ![\[Die Konfigurationsseite für Kundenprofile, der Abschnitt „Integrationen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png) Wenn Sie sehen möchten, welche Daten gesendet werden, wählen Sie die Integration aus, und klicken dann auf **Objekte anzeigen**. ## Überprüfen Ihrer Segment-Integration Hierfür brauchen Sie Folgendes: + Zugriff auf Ihren Segment-Arbeitsbereich. + [Zugriff auf das Amazon-Connect-CCP](amazon-connect-contact-control-panel.md). **So prüfen Sie Ihre Segment-Integration** 1. Navigieren Sie zum Dashboard in Ihrem Segment-Arbeitsbereich und klicken Sie auf **Ziele**. ![\[Die Segment-Übersichtsseite.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png) 1. Sie sehen eine Liste von Zielen, an die Segment Daten sendet. Wählen Sie das EventBridge Ziel für Kundenprofile. ![\[Die Seite mit der Liste der Ziele.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png) 1. Wählen Sie die Registerkarte **Ereignistester** aus. Von dieser Seite aus senden Sie ein Testereignis an Customer Profiles. Das Ereignis wird aufgenommen und in ein Kundenprofil umgewandelt, das Sie in der Amazon-Connect-Kundendienstmitarbeiteranwendung einsehen können. ![\[Die Registerkarte „Ereignistester“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png) 1. Wählen Sie **Identifizieren** als Ereignistyp und anschließend **Event Builder** als Eingabemethode aus. 1. Sie können eine **Benutzer-ID** und einige Merkmale angeben. Kundendienstmitarbeiter können in der Anwendung nach diesen Merkmalen suchen. 1. Klicken Sie auf **Ereignis senden**. 1. Das Ereignis sollte fast sofort empfangen werden. Sie sollten trotzdem kurz warten, bevor Sie ein Kundenprofil erstellen. 1. Öffnen Sie die Amazon-Connect-Anwendung für Kundendienstmitarbeiter: Suchen Sie nach der Benutzer-ID, die Sie im **Event Builder** eingegeben haben. Das Kundenprofil mit der Benutzer-ID und den von Ihnen eingegebenen Eigenschaften sollte nun angezeigt werden. 1. Wenn Sie das Kundenprofil nicht sehen, liegt ein Problem mit Ihrer Integration vor. Fehlerbehebung: 1. Gehen Sie zur EventBridge Amazon-Konsole. 1. Prüfen Sie, ob der Aktiv EventSource ist und der Abgleich EventBus existiert und läuft. Wenn diese funktionieren, wenden Sie sich an uns, Support um Unterstützung bei der Untersuchung des Problems zu erhalten. ## Überwachen Ihrer Customer-Profiles-Integrationen Falls die Integration nach der Verbindungserstellung nicht mehr funktioniert, löschen Sie die Integration und verbinden Sie sie dann erneut. ## Was ist zu tun, wenn keine Objekte gesendet werden Klicken Sie auf **Flow-Details** wenn ein Objekt nicht gesendet wird, um zu erfahren warum der Vorgang fehlgeschlagen ist. Möglicherweise müssen Sie die Konfiguration löschen und erneut eine Verbindung zur externen Anwendung herstellen. # Einrichten einer Shopify-Integration, um regelmäßige Aktualisierungen für Amazon Connect Customer Profiles bereitzustellen Um die Kundenprofile von Amazon Connect regelmäßig zu aktualisieren, können Sie die Integration mit Shopify über Amazon AppIntegrations vornehmen. Sie richten zuerst die Verbindung in Amazon Connect und Shopify ein, und prüfen dann die korrekte Shopify-Integration. ## Verbindungseinrichtung in Amazon Connect und Shopify 1. Öffnen Sie die Amazon Connect Connect-Konsole unter [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/). 1. Wählen Sie auf der Seite „Instances“ den Instance-Alias aus. Der Instance-Alias ist auch Ihr **Instance-Name**, der in Ihrer Amazon-Connect-URL erscheint. In der folgenden Abbildung sehen Sie die Seite **Instances des virtuellen Contact Centers für Amazon Connect** mit einem Rahmen um den Instance-Alias. ![\[Die Seite „Instances des virtuellen Contact Centers für Amazon Connect“, „Instance Alias“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/instance.png) 1. Wählen Sie im Navigationsbereich **Customer Profiles** aus. 1. Wählen Sie auf der **Konfigurationsseite für Kundenprofile** die Option **Integration hinzufügen** aus. ![\[Die Konfigurationsseite für Kundenprofile, die Schaltfläche „Integration hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png) 1. Wählen Sie auf der Seite **Quelle auswählen** die Option **Shopify** aus. Überprüfen Sie die Anwendungsanforderungen, die auf der Seite **Anwendung auswählen** aufgeführt sind. ![\[Die Seite „Quelle auswählen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png) 1. Wählen Sie auf der Seite **Verbindung herstellen** eine der folgenden Optionen aus: + **Bestehende Verbindung verwenden**: Auf diese Weise können Sie vorhandene EventBridge Amazon-Ressourcen wiederverwenden, die Sie möglicherweise in Ihrem erstellt haben AWS-Konto. + **Neue Verbindung erstellen**: Geben Sie die von der externen Anwendung geforderten Informationen ein. ![\[Die Seite „Verbindung herstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png) + **Verbindungsname**: Geben Sie einen Namen für die Verbindung ein. Der Verbindungsname wird von Integrationen referenziert, die diese Verbindung verwenden. + **Verbindungs-URL**: Geben Sie die Verbindungs-URL Ihrer Anwendung ein. Diese URL wird für Deep-Links zu den Objekten verwendet, die in Ihrer externen Anwendung erstellt wurden. Die Verbindungs-URL ist die URL der Shopify-Partner-App, die auf der Website der Anwendung verfügbar ist. So finden Sie die URL Ihrer Shopify-Partner-App: + Melden Sie sich bei Ihrem „partners.shopify.com“-Konto an. + Öffnen Sie die App. + Kopieren Sie die URL aus dem Browser. + **Client-ID**: Geben Sie die Client-ID für die Anwendung ein. Dies ist eine Zeichenfolge, die den Client in Ihrer externen Anwendung eindeutig identifiziert. Diese Client-ID ist der Quellenname, der auf der Anwendungs-Website verfügbar ist. Mit der von Ihnen hier angegebenen ID wird der Client identifiziert von dem Customer Profiles Ihre Objekte aufnehmen soll. Ihre Client-ID ist möglicherweise erst nach Einrichtung der Quelle verfügbar. So finden Sie Ihren Quellennamen: + Melden Sie sich bei Ihrem „partners.shopify.com“-Konto an. + Öffnen Sie die App. + Kopieren Sie den Quellnamen aus Ihrer EventBridge Amazon-Eventquelle. 1. Kopieren Sie auf der Seite zum **Einrichten der Quelle** Ihre AWS-Konto ID in Ihre Zwischenablage und wählen Sie dann **Bei Shopify anmelden** aus. 1. Gehen Sie wie folgt vor, um Shopify einzurichten: 1. Melden Sie sich bei Ihrem „partners.shopify.com“-Konto an. 1. Wählen Sie unter Amazon EventBridge die Option **Quelle erstellen** aus. 1. Fügen Sie Ihre AWS-Konto ID ein und wählen Sie Ihre AWS Region aus. 1. Nachdem Sie das Ziel für die Ereignisquelle eingerichtet haben, kehren Sie zur Customer Profiles zurück. Es wird eine Mitteilung angezeigt, dass Amazon Connect eine Verbindung mit Shopify hergestellt hat. 1. Wählen Sie auf der Seite mit den **Integrationsoptionen** aus, welche Quellobjekte Sie aufnehmen möchten, und wählen Sie deren Objekttyp aus. Objekttypen speichern Ihre aufgenommenen Daten. Sie geben außerdem vor, wie Objekte aus Ihren Integrationen den Profilen bei der Aufnahme zugeordnet werden sollen. Customer Profiles bietet standardmäßige Objekttypvorlagen, mit denen Sie vorgeben können, wie Attribute in Ihren Quellobjekten den Standardobjekten in Customer Profiles zugeordnet werden sollen. Sie können auch die Objektzuordnungen verwenden, die Sie aus dem erstellt haben. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) ![\[Die Seite mit den Integrationsoptionen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png) 1. Für das **Aufnahme-Startdatum** beginnt Customer Profiles die Aufnahme von Datensätzen, die nach der Erstellung der Integration erstellt wurden. **Anmerkung** Wenn Sie historische Datensätze benötigen, können Sie [Amazon S3 als Integrationsquelle für deren Import verwenden](customer-profiles-object-type-mappings.md). 1. Vergewissern Sie sich auf der Seite **Überprüfen und Integrieren**, dass der **Verbindungsstatus** **Verbunden** lautet, und klicken Sie dann auf **Integration hinzufügen**. **Anmerkung** Nachdem Sie diese Integration hinzugefügt haben, müssen Sie [Webhook-Abonnements einrichten](#shopify-webhook-subscriptions), damit Ereignisse in diese Integration einfließen können. ![\[Die Seite „Überprüfen und integrieren“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png) 1. Nachdem die Integration eingerichtet wurde, wird auf der **Konfigurationsseite für Kundenprofile** im Abschnitt **Integrationen** angezeigt, welche Integrationen aktuell eingerichtet sind. Die Optionen **Letzte Ausführung** und **Integrationsintegrität** sind derzeit für diese Art von Integration nicht verfügbar. ![\[Der Abschnitt „Integrationen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png) Wenn Sie sehen möchten, welche Daten gesendet werden, wählen Sie die Integration aus, und klicken dann auf **Objekte anzeigen**. 1. Fahren Sie mit dem nächsten Schritt fort, um mithilfe der API **Webhook-Abonnements** einzurichten, sodass Ereignisse in diese Integration einfließen können. ## Einrichten von Webhook-Abonnements 1. Verwenden Sie die folgende URL, um sicherzustellen, dass Ihre App über die erforderlichen Berechtigungen verfügt: ``` https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce} ``` Wobei Folgendes gilt: + `shop` ist der Name Ihres Shopify-Shops. + `api_key` ist der API-Schlüssel Ihrer Shopify-App. Diese Informationen finden Sie auf der Detailseite der Shopify-**App**. + `scopes` sollte den Wert `read_customers,read_orders,read_draft_orders` haben. + `redirect_uri` ist die Umleitungs-URI, die Sie bei der Erstellung für Ihre App angegeben haben. Für unsere Zwecke kann dies eine beliebige gültige URL sein. + `nonce` kann ein beliebiger eindeutiger Wert sein, um eine externe Autorisierungsanfrage zu identifizieren. Wir empfehlen, hier einen Zeitstempel zu verwenden. Nachdem Sie die URL erstellt haben, kopieren Sie sie in Ihren Browser ein. Es wird eine installation/authorization Seite ähnlich der folgenden Abbildung angezeigt, auf der der Shop-Inhaber aufgefordert wird, Berechtigungen für den definierten Bereich zu erteilen. ![\[Ein Beispiel für eine Shopify-Seite für die Installation und Autorisierung der App.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png) 1. Klicken Sie auf **Nicht aufgeführte App installieren**, um die App für Ihren Shop zu installieren und zu autorisieren. Sie werden zu der von Ihnen angegebenen Umleitungs-URI weitergeleitet, wobei ein Autorisierungscode als Abfrageparameter an die Umleitungs-URI angehängt wird. Beispiel: ``` https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}×tamp=1409617544&state={nonce}&shop={shop_origin}&host={host} ``` 1. Kopieren Sie den `authorization_code` aus dieser URI. Im Folgenden verwenden Sie ihn, um ein permanentes Zugriffstoken zu erhalten. 1. Öffnen Sie das Tool, das Sie für API-Aufrufe verwenden. Zum Beispiel [CURL](https://curl.se/) oder [POSTMAN](https://www.postman.com/). 1. Stellen Sie eine POST-Anfrage an die Shopify-`Admin`API an diesen Endpunkt: ``` https://{shop}.myshopify.com/admin/oauth/access_token ``` mit dem folgenden Anforderungstext: ``` { "code": "authorization_code_received_from_redirect_uri", "client_id": "your_app_api_key", "client_secret": "your_app_api_secret" } ``` Die Anfrage wird wie folgt beantwortet: ``` { "access_token": "permanent_access_token", "scope": "read_customers,read_orders,read_draft_orders" } ``` 1. Beachten Sie den `access_token`. Dies ist ein permanentes Token, das den angegebenen Umfang aus einem vorherigen Schritt hat. Jetzt können Sie Webhook-Abonnements erstellen. 1. Stellen Sie bei den folgenden API-Aufrufen sicher, dass Sie den HTTP-Header-Schlüssel `X-Shopify-Access-Token` auf den in der Antwort des früheren Aufrufs erhaltenen `access_token`. 1. Für Webhook-Abonnements stellen Sie die folgende POST-Anfrage für jeden der im nächsten Schritt aufgeführten `topic`-Werte: Endpunkt `https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json` Anforderungstext ``` { "webhook": { "topic": "replace_this_with_one_of_the_topics_in_the_list_below", "address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration", "format": "json" } } ``` 1. Ersetzen Sie für jedes Abonnement den Wert für `topic` durch die folgenden Werte: + `customers/create` + `customers/enable` + `customers/update` + `draft_orders/create` + `draft_orders/update` + `orders/cancelled` + `orders/create` + `orders/fulfilled` + `orders/paid` + `orders/partially_fulfilled` + `orders/updated` Ab sofort empfangen Sie Ereignisse von Ihrem Shopify-Shop. Prüfen Sie als Nächstes Ihre Shopify-Integration. ## Shopify-Integration prüfen 1. Melden Sie sich als Admin bei Ihrem Shopify-Shop an. 1. Klicken Sie im linken Navigationsmenü auf **Kunden**. 1. Klicken Sie auf **Kunde hinzufügen**. 1. Geben Sie Ihre Kundendaten ein. Geben Sie unbedingt auch eine Telefonnummer und eine E-Mail-Adresse ein. Diese müssen keinem echten Kunden gehören. Nachdem Sie die Integration überprüft haben, werden Sie diesen Kunden wieder löschen. 1. Speichern Sie das Kundenobjekt. 1. Das Ereignis sollte fast sofort empfangen werden. Sie sollten trotzdem kurz warten, bevor Sie ein Kundenprofil erstellen. 1. Öffnen Sie die den Arbeitsbereich für Kundendienstmitarbeiter in Amazon Connect und suchen Sie den Benutzer anhand der E-Mail-Adresse oder Telefonnummer, die Sie gerade im Shopify-Shop eingegeben haben. Sie sollten das Kundenprofil mit der eingegebenen E-Mail-Adresse oder Telefonnummer sehen. 1. Wenn Sie das Kundenprofil nicht sehen, liegt ein Problem mit Ihrer Integration vor. Fehlerbehebung: 1. Gehen Sie zur EventBridge Amazon-Konsole. 1. Prüfen Sie, ob der Aktiv EventSource ist und der Abgleich EventBus existiert und läuft. Wenn diese funktionieren, wenden Sie sich an uns, Support um Unterstützung bei der Untersuchung des Problems zu erhalten. ## Überwachen Ihrer Customer-Profiles-Integrationen Falls die Integration nach der Verbindungserstellung nicht mehr funktioniert, löschen Sie die Integration und verbinden Sie sie dann erneut. ## Was ist zu tun, wenn keine Objekte gesendet werden Klicken Sie auf **Flow-Details** wenn ein Objekt nicht gesendet wird, um zu erfahren warum der Vorgang fehlgeschlagen ist. Möglicherweise müssen Sie die Konfiguration löschen und erneut eine Verbindung zur externen Anwendung herstellen.