Richten Sie die Integration für Shopify ein

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 überprüfen dann die Shopify-Integration.

Richten Sie die Verbindung in Amazon Connect und Shopify ein

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

2. Wählen Sie auf der Instance-Seite den Instance-Alias aus. Der Instance-Alias ist auch Ihr Instance-Name, der in Ihrer Amazon Connect Connect-URL erscheint. Die folgende Abbildung zeigt die Seite mit den Amazon Connect Virtual Contact Center-Instances mit einem Feld um den Instance-Alias.

   

3. Wählen Sie im Navigationsbereich Kundenprofile aus.

4. Wählen Sie auf der Konfigurationsseite für Kundenprofile die Option Integration hinzufügen aus.

   

5. Wählen Sie auf der Seite Quelle auswählen die Option Shopify aus. Überprüfe die Anwendungsanforderungen, die auf der Seite „Anwendung auswählen“ aufgeführt sind.

   

6. 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 habenAWS-Konto.

   • Neue Verbindung erstellen: Geben Sie die Informationen ein, die für die externe Anwendung erforderlich sind.

     

     • Verbindungsname: Geben Sie einen Namen für Ihre 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:

       • Loggen Sie sich in Ihr partners.shopify.com-Konto ein.

       • Gehe zu deiner App.

       • Kopieren Sie die URL aus Ihrem Browser.

     • Client-ID: Geben Sie Ihre Anwendungs-Client-ID ein. Dies ist eine Zeichenfolge, die den Client in Ihrer externen Anwendung eindeutig unterscheidet. Diese Client-ID ist der Quellname, der auf der Anwendungswebsite verfügbar ist. Sie verwenden die ID, die Sie hier angeben, um den Client zu identifizieren, von dem Kundenprofile Ihre Objekte aufnehmen sollen. Ihre Client-ID ist möglicherweise verfügbar, nachdem Sie die Schritte zur Einrichtung der Quelle ausgeführt haben.

       So finden Sie Ihren Quellnamen:

       • Loggen Sie sich in Ihr partners.shopify.com-Konto ein.

       • Gehe zu deiner App.

       • Kopieren Sie den Quellnamen aus Ihrer EventBridge Amazon-Eventquelle.

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

8. Verwende die folgenden Anweisungen, um Shopify einzurichten:

   1. Loggen Sie sich auf partners.shopify.com ein.

   2. Wählen Sie unter Amazon EventBridge die Option Quelle erstellen aus.

   3. Fügen Sie Ihre AWS-Konto ID ein und wählen Sie Ihre AWS Region aus.

   4. Nachdem Sie das Ziel der Veranstaltungsquelle eingerichtet haben, kehren Sie zu den Kundenprofilen zurück. Es wird eine Warnung angezeigt, die darauf hinweist, dass Amazon Connect erfolgreich eine Verbindung mit Shopify hergestellt hat.

9. 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 definieren auch, wie Objekte aus Ihren Integrationen Profilen zugeordnet werden, wenn sie aufgenommen werden. Customer Profiles bietet standardmäßige Objekttypvorlagen, die Sie verwenden können, um zu definieren, wie Attribute in Ihren Quellobjekten den Standardobjekten in Kundenprofilen zugeordnet werden. Sie können auch die Objektzuordnungen verwenden, die Sie aus dem erstellt haben. PutProfileObjectType

   

10. Für das Startdatum der Datenerfassung beginnt Customer Profiles mit der Aufnahme von Datensätzen, die nach dem Hinzufügen der Integration erstellt wurden.

    Anmerkung

    Wenn Sie historische Aufzeichnungen benötigen, können Sie Amazon S3 als Integrationsquelle verwenden, um sie zu importieren.

11. Vergewissern Sie sich auf der Seite Überprüfen und Integrieren, dass der Verbindungsstatus Verbunden lautet, und wählen Sie dann Integration hinzufügen aus.

    Anmerkung

    Nachdem Sie diese Integration hinzugefügt haben, müssen Sie Webhook-Abonnements einrichten, damit Ereignisse in diese Integration einfließen können.

    

12. Nachdem die Integration eingerichtet wurde, wird auf der Konfigurationsseite für Kundenprofile im Bereich 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.

    

    Um zu sehen, welche Daten gesendet werden, wählen Sie die Integration und dann Objekte anzeigen aus.

13. Fahren Sie mit dem nächsten Schritt fort, um mithilfe der API Webhook-Abonnements einzurichten, sodass Ereignisse in diese Integration einfließen können.

Richten Sie Webhook-Abonnements ein

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 gilt:

   • shopist der Name Ihres Shopify-Shops.

   • api_keyist der API-Schlüssel Ihrer Shopify-App. Du findest ihn auf der Detailseite der Shopify-App.

   • scopessollte den Wert read_customers,read_orders,read_draft_orders haben.

   • redirect_uriist der Umleitungs-URI, den Sie für Ihre App angegeben haben, als Sie sie erstellt haben. Für unsere Zwecke kann es sich um eine beliebige gültige URL handeln.

   • noncekann ein beliebiger eindeutiger Wert sein, um eine bestimmte Autorisierungsanfrage von anderen zu identifizieren. Wir empfehlen die Verwendung eines Zeitstempels.

   Nachdem Sie die URL erstellt haben, fügen Sie sie in Ihren Browser ein. Eine Installations-/Autorisierungsseite ähnlich der folgenden Abbildung wird angezeigt, auf der der Shop-Inhaber aufgefordert wird, Berechtigungen für den definierten Bereich zu erteilen.

   

2. Wählen Sie Nicht aufgeführte App installieren, um die App im Namen Ihres Shops zu installieren und zu autorisieren.

   Sie werden zu der Umleitungs-URI weitergeleitet, die Sie eingegeben haben, wobei ein Autorisierungscode als Abfrageparameter an die Umleitungs-URI angehängt ist. Beispiele:

   https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}&timestamp=1409617544&state={nonce}&shop={shop_origin}&host={host}

3. Kopieren Sie den authorization_code von dieser URI. In den nächsten Schritten werden Sie es verwenden, um ein permanentes Zugriffstoken zu erhalten.

4. Gehen Sie zu dem Tool, das Sie für API-Aufrufe verwenden. Zum Beispiel CURL oder POSTMAN.

5. Um ein permanentes Zugriffstoken zu erhalten, stellen Sie eine POST-Anfrage an die Admin Shopify-API an diesen Endpunkt:

   https://{shop}.myshopify.com/admin/oauth/access_token

   mit dem folgenden Anfragetext:

   {
       "code": "authorization_code_received_from_redirect_uri",
       "client_id": "your_app_api_key",
       "client_secret": "your_app_api_secret"
   }

   Diese Anfrage gibt die folgende Antwort zurück:

   {
       "access_token": "permanent_access_token",
       "scope": "read_customers,read_orders,read_draft_orders"
   }

6. Beachten Sie den access_token. Dies ist ein permanentes Token mit dem angegebenen Gültigkeitsbereich aus einem vorherigen Schritt. Jetzt sind Sie bereit, Webhook-Abonnements zu erstellen.

7. Stellen Sie bei den folgenden API-Aufrufen sicher, dass Sie den HTTP-Header-Schlüssel X-Shopify-Access-Token auf den Schlüssel setzen, den access_token Sie aus der Antwort des früheren Aufrufs erhalten haben.

8. Um Webhook-Abonnements einzurichten, stellen Sie die folgende POST-Anforderung für jeden der im nächsten Schritt aufgelisteten topic Werte:

   Endpunkt: https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json

   Hauptteil der Anfrage:

   {
       "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"
       }
   }

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

Sie sind jetzt bereit, Ereignisse von Ihrem Shopify-Shop zu erhalten. Überprüfen Sie als Nächstes Ihre Shopify-Integration.

Überprüfen Sie Ihre Shopify-Integration

1. Melden Sie sich als Admin in Ihrem Shopify-Shop an.

2. Wählen Sie im linken Navigationsmenü Kunden aus.

3. Wählen Sie Kunde hinzufügen aus.

4. Geben Sie Ihre Kundendaten ein. Geben Sie unbedingt eine Telefonnummer und eine E-Mail-Adresse ein. Diese müssen keinem echten Kunden gehören. Sie werden diesen Kundeneintrag löschen, nachdem Sie die Integration überprüft haben.

5. Speichern Sie das Kundenobjekt.

6. Die Übertragung der Veranstaltung sollte fast sofort erfolgen, aber es sollte eine Minute einplanen, bis sie zugestellt und ein Kundenprofil erstellt werden kann.

7. Öffnen Sie die Amazon Connect Connect-Agentenoberfläche und suchen Sie den Benutzer anhand der E-Mail-Adresse oder Telefonnummer, die Sie im Shopify Store eingegeben haben. Sie sollten das Kundenprofil mit derselben E-Mail-Adresse oder Telefonnummer sehen können.

8. Wenn Sie das Kundenprofil nicht sehen können, liegt ein Problem mit Ihrer Integration vor. Um Fehler zu beheben:

   1. Gehen Sie zur EventBridge Amazon-Konsole.

   2. Prüfen Sie, ob der aktiv EventSource ist und der Abgleich EventBus existiert und läuft.

   Wenn diese funktionieren, wenden Sie sich an uns, AWS Support um Unterstützung bei der Untersuchung des Problems zu erhalten.

Überwachen Sie die Integrationen Ihrer Kundenprofile

Wenn Ihre Verbindung hergestellt wurde und sie nicht mehr funktioniert, löschen Sie die Integration und stellen Sie sie dann erneut her.

Was ist zu tun, wenn keine Objekte gesendet werden

Wenn ein Objekt nicht gesendet werden kann, wähle Flow-Details aus, um mehr darüber zu erfahren, was schief gelaufen ist.

Möglicherweise müssen Sie die Konfiguration löschen und erneut eine Verbindung zur externen Anwendung herstellen.