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.
Salesforce-Integration
Mit dem Salesforce-Aktionskonnektor in Amazon Quick können Sie Aktionen innerhalb von Salesforce-Organisationen ausführen, einschließlich der Verwaltung von Datensätzen, der Abfrage von Daten und der Interaktion mit Salesforce-APIs. Informationen zu den Amazon Quick-Abonnementanforderungen finden Sie unterIntegrationen in der Konsole einrichten.
Anmerkung
Ab der Salesforce-Version Spring '26 (Februar 2026) ist die Erstellung neuer Connected Apps standardmäßig in allen Salesforce-Organisationen deaktiviert. In diesem Handbuch werden die externen Client-Apps (ECAs) von Salesforce verwendet, die vollständig mit dem Amazon Quick Salesforce Connector kompatibel sind.
Voraussetzungen
Bevor Sie die Salesforce-Integration einrichten, stellen Sie sicher, dass Sie über Folgendes verfügen:
-
Eine Salesforce-Organisation mit Systemadministratorzugriff.
-
Amazon Quick Author-Rolle oder höher.
-
Ihre Amazon Quick-Instance-URL (z. B.
https://us-east-1.quicksight.aws.amazon.com).
Schritt 1: Erstellen Sie eine externe Kundenanwendung in Salesforce
Erstellen Sie eine externe Client-App (ECA) in Salesforce, um die OAuth-Authentifizierung mit Amazon Quick zu aktivieren.
Navigieren Sie zu External Client App Manager
-
Melden Sie sich bei Ihrer Salesforce-Organisation an und wählen Sie Setup (Zahnradsymbol oben rechts).
-
Erweitern Sie im Navigationsbereich Plattformtools > Apps > Externe Client-Anwendungen > External Client App Manager.
-
Wählen Sie „Neue externe Client-App“.
Geben Sie grundlegende Informationen ein
Geben Sie die folgenden Basisinformationen für Ihre externe Kunden-App ein:
| Feld | Value (Wert) |
|---|---|
| Name der externen Client-App | Ein aussagekräftiger Name (z. B. „Amazon Quick Integration“) |
| API-Name | Auto-generated aus dem Namen der App |
| Kontakt-E-Mail | Deine Admin-E-Mail-Adresse |
| Vertriebsstaat | Lokal (Standard) |
Schritt 2: OAuth-Einstellungen konfigurieren
Aktivieren Sie OAuth
Wählen Sie im Abschnitt API (OAuth-Einstellungen aktivieren) die Option OAuth aktivieren aus, um das OAuth-Konfigurationsfenster zu erweitern.
Legen Sie die Rückruf-URL fest
Geben Sie die Amazon Quick OAuth-Callback-URL in das Feld Callback-URL ein:
<your-quick-instance-url>/sn/oauthcallback
Beispiel: https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback
Fügen Sie OAuth-Bereiche hinzu
Verschieben Sie die folgenden Bereiche von Verfügbare OAuth-Bereiche in Ausgewählte OAuth-Bereiche:
-
Auf den Identitäts-URL-Service zugreifen (id, profile, email, address, phone)
-
Benutzerdaten über APIs verwalten (api)
-
Benutzerdaten über Webbrowser (Web) verwalten
-
Voller Zugriff (vollständig)
-
Greifen Sie auf Visualforce-Anwendungen zu (Visualforce)
-
Anfragen jederzeit ausführen (refresh_token, offline_access)
-
Auf eindeutige Benutzerkennungen zugreifen (openid)
-
Auf benutzerdefinierte Berechtigungen zugreifen (custom_permissions)
-
Zugriff auf Connect-REST-API-Ressourcen (chatter_api)
-
Greifen Sie auf Analytics-REST-API-Ressourcen zu (wave_api)
-
Greifen Sie auf Analytics-REST-API-Diagramme und Geodatenressourcen (eclair_api) zu
-
Pardot-Dienste verwalten (pardot_api)
Aktivieren Sie OAuth-Flows
Wählen Sie die folgenden Flow-Optionen aus:
-
Aktivieren Sie den Fluss der Client-Anmeldeinformationen
-
Aktivieren Sie den Fluss von Autorisierungscode und Anmeldeinformationen
-
Aktivieren Sie den Token-Austauschfluss
Aktivieren Sie die Sicherheitseinstellungen
Wählen Sie die folgenden Sicherheitsoptionen aus:
-
Proof Key für Code Exchange (PKCE) erforderlich
-
Secret für Web Server Flow erforderlich (standardmäßig ausgewählt)
-
Secret für den Token-Aktualisierungsfluss erforderlich (standardmäßig ausgewählt)
Wählen Sie Erstellen, um die externe Client-App zu speichern.
Schritt 3: Holen Sie sich die Anmeldeinformationen von Verbrauchern
-
Nach der Erstellung befinden Sie sich auf der ECA-Detailseite.
-
Navigieren Sie zur Registerkarte „Einstellungen“ oder wählen Sie „Kundendaten verwalten“.
-
Möglicherweise müssen Sie Ihre Identität überprüfen (E-Mail-Bestätigungscode).
-
Kopieren Sie den Consumer Key (Client ID) und den Consumer Secret (Client Secret).
Wichtig
Speichern Sie diese Anmeldeinformationen sicher. Sie benötigen sie, wenn Sie den Connector in Amazon Quick konfigurieren.
Schritt 4: Salesforce-Konnektor in Amazon Quick konfigurieren
Navigieren Sie zu Connectors
-
Öffnen Sie Amazon Quick und wählen Sie Connectors.
-
Wählen Sie den Tab „Für Ihr Team erstellen“.
-
Suchen Sie Salesforce und wählen Sie es aus.
-
Wenn Sie gefragt werden, dass bereits ein Connector vorhanden ist, wählen Sie Nein, neuen erstellen aus.
Geben Sie die Verbindungsdetails ein
Geben Sie die folgenden Verbindungsdetails ein:
| Feld | Value (Wert) |
|---|---|
| Name | Ein beschreibender Name (z. B. „Salesforce ECA“) |
| Netzwerk | Öffentliches Netzwerk |
| Authentifizierungstyp | Benutzerdefinierte OAuth-App |
| Basis-URL | https:// |
| Kunden-ID | Verbraucherschlüssel aus Schritt 3 |
| Geheimer Kunde | Kundengeheimnis aus Schritt 3 |
| Token-URL | https:// |
| Autorisierungs-URL | https:// |
| URL umleiten | Pre-filled (nicht ändern) |
Wählen Sie Weiter aus, um fortzufahren.
Schritt 5: Überprüfen und veröffentlichen
-
Überprüfen Sie auf der Seite Überprüfen die verfügbaren Salesforce-Aktionen (bis zu 42 Aktionen).
-
Wählen Sie Weiter, um mit der Benutzerfreigabe fortzufahren.
-
Wählen Sie Benutzer oder Gruppen aus, die Zugriff auf diesen Connector haben sollen.
-
Wählen Sie Veröffentlichen, um den Connector zu veröffentlichen.
Nachdem Sie den Connector veröffentlicht haben, können Sie Salesforce-Aktionen in Amazon Quick Chat, Flows und Automatisierungen verwenden.
Verfügbare Aktionen
Nachdem Sie den Connector eingerichtet haben, sind die folgenden Salesforce-Aktionen verfügbar:
-
Operationen zum Erstellen, Lesen, Aktualisieren und Löschen (CRUD) für Standardobjekte und benutzerdefinierte Objekte.
-
Fragen Sie Salesforce-Daten mithilfe von SOQL (Salesforce Object Query Language) ab.
-
Verwalten Sie Leads, Accounts, Kontakte und Opportunities.
-
Führen Sie Apex-Methoden und benutzerdefinierte Logik aus.
-
Verwalten Sie Fälle, Aufgaben und Aktivitäten.
-
Greifen Sie auf Berichte und Dashboards zu.
Anmerkung
Die Salesforce-Integration unterstützt nur die Ausführung von Aktionen. Datenzugriff und Erstellung von Wissensdatenbanken sind für Salesforce-Systeme nicht verfügbar.
Fehlerbehebung
Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unterVerwaltung vorhandener Integrationen.
-
Fehler „URL existiert nicht mehr“ — Stellen Sie sicher, dass Sie in der Token-URL und der Autorisierungs-URL die richtige Salesforce-Domäne verwenden. Verwenden Sie keine älteren Endgeräte.
-
Die OAuth-Validierung schlägt fehl — Stellen Sie sicher, dass PKCE auf der ECA aktiviert ist und dass die Callback-URL genau mit Ihrer angehängten Amazon Quick-Instance-URL übereinstimmt.
/sn/oauthcallback -
Fehler „Fehlende Bereiche“ — Kehren Sie zur ECA-Konfiguration in Salesforce zurück und stellen Sie sicher, dass sich alle erforderlichen OAuth-Bereiche in der Liste „Ausgewählt“ und nicht mehr in der Liste „Verfügbar“ befinden.
-
Die Option „Verbundene Anwendung“ ist ausgegraut — Dies wird nach Salesforce Spring '26 erwartet. Verwenden Sie stattdessen eine externe Client-Anwendung. ECAs sind der unterstützte Ersatz.
