Was ist für Sie drin?
Mit der Salesforce-Integration von Showpad können Benutzer ihre Verwaltungsaufgaben erheblich reduzieren. In Salesforce lassen wir zunächst Anforderungen zu, die von der Showpad-Domäne stammen. Anschließend konfigurieren wir die Salesforce-Integration in Showpad.
Sie benötigen dies, um erfolgreich zu sein
- Aktive Administratorrechte auf beiden Showpad und Salesforce - Plattformen
- Showpad Ultimate Plan
- Salesforce Enterprise- oder Unlimited-Plan
Wählen Sie Ihre Salesforce-Erfahrung aus
![]() Classic |
![]() Lightning |
Sehen Sie, wie es in Salesforce Classic gemacht wird
- Konfigurieren Sie CORS in Salesforce Classic
- Richten Sie eine Salesforce-Instanz in Showpad ein
- Grundlegende Fehlerbehebung
Tun Sie dies Schritt für Schritt
1. Konfigurieren Sie CORS in Salesforce Classic-Communitys
Der erste Schritt beim Konfigurieren der Salesforce-Integration besteht darin, Anforderungen aus der Showpad-Domäne zuzulassen. Mit Salesforce können Kunden steuern, welche Websites die Salesforce-API verwenden dürfen. Auf diese Weise wird Ihre Salesforce-Instanz geschützt, indem nur Anfragen von bekannten Webseiten zugelassen und alle anderen abgelehnt werden.
Diese Einstellung wird als CORS (Cross-Origin Resource Sharing) bezeichnet. Für die Integration von Showpad in Salesforce ist eine Konfiguration erforderlich. Die folgenden Anweisungen zeigen, wie ein Salesforce Admin es unserer Showpad Domain ermöglichen kann, Anforderungen an Ihre Salesforce-Instanz zu stellen. Wenn Sie dies bereits beim Einrichten Ihrer Standard-Showpad- und Salesforce-Integration getan haben, müssen Sie dies nicht erneut tun.
Das Einrichten ermöglicht:
- Showpad, um eine Salesforce Aktivität zu erstellen, wenn ein Benutzer in der Showpad App oder in der Web-App Inhalte mit einem Interessenten oder Kunden teilt.
- Showpad zum Erstellen eines Salesforce- Ereignisses, wenn ein Benutzer in einer mobilen App eine Besprechung bei Salesforce protokollieren möchte.
- Gehen Sie zur Setup-Seite in Salesforce.com als Salesforce Admin.
- Suchen Sie im linken Menü nach CORS. Sie können auch Sicherheitskontrollen > CORS manuell auswählen.
- Fügen Sie einen neuen Ursprung auf der Whitelist hinzu.
- Fügen Sie https: // *.showpad.biz hinzu und klicken Sie auf Speichern.
Hinweis: Wenn die Berechtigung "Alle Daten ändern" in Salesforce deaktiviert ist, werden wir Sie über dieShowpad's Online Platform informieren, dass wir die CORS-Konfiguration nicht überprüfen konnten. Sie können die Integration weiter einrichten, selbst wenn diese Warnung angezeigt wird.
- Um Salesforce und Showpad zu verbinden, müssen Sie Ihre Salesforce-Instanz (en) in Showpad einrichten. Sie können mehrere Salesforce-Instanzen konfigurieren, wenn Ihr Unternehmen mehr als eine verwendet.
Öffnen Sie die Showpad Online Platform und melden Sie sich mit Ihren Administrator-Anmeldeinformationen an. - Wählen Sie in den Einstellungen im Abschnitt Integrationen die Option CRM aus, und wählen Sie dann Salesforce-Instanz konfigurieren aus. Wenn Sie bereits mit einer Salesforce-Instanz verbunden sind, klicken Sie auf Salesforce-Instanz hinzufügen.
- Geben Sie eine Beschreibung für Ihre Salesforce-Instanz ein. Wenn Sie vorhaben, mehrere Salesforce-Instanzen einzurichten, achten Sie darauf, dass Sie für jede Instanz einen passenden Namen wählen, damit sie leichter zu identifizieren sind. Beispielsweise kann es nützlich sein, diese Instanz Salesforce Community zu benennen.
- Wenn Sie eine benutzerdefinierte Domäne für den Zugriff auf Salesforce verwenden, z. B. https://companyxyz.my.salesforce.com, aktivieren Sie Benutzerdefinierte Domäne verwenden und geben Sie companyxyz ein.
- Aktivieren Sie das Kontrollkästchen für die Community-Anmeldung
- Showpad- Benutzerkonten können automatisch erstellt werden, wenn sich Benutzer zum ersten Mal mit ihren Salesforce- Anmeldeinformationen anmelden. Weitere Informationen zur Option "Automatische Bereitstellung".
- Klicken Sie auf Weiter und Mit Salesforce verbinden.
- Sie müssen jetzt Ihre Salesforce-Anmeldeinformationen eingeben. Diese Anmeldung wird als Integration von Benutzer verwendet, um mit Salesforcezu verbinden.
Wenn der Benutzer, der zum Konfigurieren dieser Integration verwendet wird, kein vollständiger Administrator ist, sind die folgenden Berechtigungen erforderlich:
Systemeinstellungen:- API aktiviert
- Aufgaben bearbeiten
- Ereignisse bearbeiten
- Rollen und Rollenhierarchie anzeigen.
- Setup und Konfiguration anzeigen.
Objekteinstellungen- Lesen / Erstellen / Bearbeiten für Leads, Kontakte, Opportunities, Kontenobjekte.
- Lesen/Erstellen/Bearbeiten/Löschen für Showpad- Aktivitäten, Showpad- Aktivitäten, Showpad Content & Showpad Content.
Nach dem Anmelden wird die Showpad Online Platform geöffnet. - Sie können jetzt Inhaltsempfehlungen für Ihre Vertriebskollegen aktivieren. Auf dieser Seite finden Sie weitere Informationen. Um diese Funktion nutzen zu können, müssen Sie die Showpad for Salesforce-App über AppExchange von Salesforce installieren. Klicken Sie auf Speichern.
- Die letzte Registerkarte, die Sie sehen, dient zum Aktivieren der erweiterten Protokollierung für benutzerdefinierte Objekte. Konto und Opportunity sind standardmäßig ausgewählt, und Sie können andere Kontrollkästchen aktivieren, um andere relevante benutzerdefinierte Objekte für das Feld "Verwandt mit" anzugeben. Auf diese Weise können Ihre Benutzer beim Protokollieren von Aufgaben Freigaben auf andere Objekte als Konten oder Opportunities beziehen.
- In Salesforce muss für das benutzerdefinierte Objekt das Kontrollkästchen Aktivitäten zulassen im Abschnitt Optionale Funktionen aktiviert sein.
- Wählen Sie die benutzerdefinierten Objekte aus, für die Sie Aktivitäten protokollieren möchten, und klicken Sie dann auf Speichern. Die angezeigte Liste enthält dieselben Objekte, die in der Instanz des verbundenen SFDC im Feld "Bezogen auf" einer Aufgabe verfügbar sind. Benutzer können keine Besprechungen in einem benutzerdefinierten Objekt protokollieren.
- Sie können steuern, welche Benutzergruppen die Salesforce-Integration verwenden können. Klicken Sie auf die Registerkarte Gruppen mit Zugriff und wählen Sie Alle Benutzer oder Gruppen auswählen. Wenn Sie Gruppen auswählen aussuchen, aktivieren Sie die Kontrollkästchen für die Gruppen, denen Sie Zugriff auf die Integration gewähren möchten.
- Wenn eine Freigabe protokolliert wird, werden in den Kommentaren der Aufgabeninformationen der E-Mail-Text und ein Link zum Anzeigen der Freigabe als Empfänger angezeigt. Abhängig davon, wie Ihre Einstellungen konfiguriert sind, sieht es für Ihre Benutzer ähnlich aus.
3. Grundlegende Fehlerbehebung
OAuth-Authentifizierungsfehler
Die Showpad- und Salesforce-Integration funktioniert mit einer Server-zu-Server-Kommunikation. Dies hat zur Folge, dass die IP-Adresse des ursprünglichen Benutzers während des Anmeldevorgangs mit der Adresse des Showpads geändert wird.
In Fällen, in denen Anmelde-IP-Bereiche verwendet werden oder bei Benutzern OAuth-Anmeldefehler auftreten, empfehlen wir, die Einstellungen in der OAuth-App von IP-Einschränkungen erzwingen in IP-Einschränkungen lockern zu ändern.
Mit der Einstellung IP-Einschränkungen lockern können Benutzer die verbundene Showpad-App ohne IP-Einschränkungen ausführen. Sie finden diese Einstellungen im Abschnitt Salesforce-Verwaltung.
- Öffnen Sie die OAuth-Verwendungsoptionen für verbundene Apps auf der Registerkarte Apps verwalten.
- Suchen Sie die Showpad Salesforce Integration-App und klicken Sie auf Installieren.
- Auf der Registerkarte "Verbundene Apps" können Sie die OAuth-Richtlinien anzeigen und "IP-Einschränkungen erzwingen" zu "IP-Einschränkungen lockern" ändern.
Die Salesforce-Verbindung funktioniert in der Web-app nicht
Stellen Sie sicher, dass Sie mit einem Browser arbeiten, der HTML vollständig unterstützt. Um einen vollständigen Überblick über unsere Browseranforderungen zu erhalten, klicken Sie hier.
Stellen Sie für Internet Explorer-Benutzer sicher, dass Sie mit IE11 oder höher arbeiten. Stellen Sie sicher, dass in den Sicherheitseinstellungen die Option "Verschiedenes" für Internet und Intranet aktiviert ist. Ist dies nicht der Fall, lässt Internet Explorer nicht zu, dass die Showpad-Seite eine Verbindung zur Salesforce-Domäne herstellt und die Kontakt- und Leaddaten abruft.
- Gehen Sie zu Einstellungen, Internetoptionen, Sicherheit.
- Sie sollten ein Internet-Symbol sehen, stellen Sie sicher, dass es ausgewählt ist. Wenn sie das lokale Intranet verwenden, stellen Sie sicher, dass Sie dieselbe Änderung auch dort anwenden.
- Wählen Sie Benutzerdefiniert.
- Scrollen Sie, bis Sie Folgendes finden, und stellen Sie sicher, dass der Zugriff auf domänenübergreifende Datenquellen aktiviert ist
- Übernehmen und speichern.
- Stellen Sie sicher, dass Sie dieselben Einstellungen auch für das lokale Intranet anwenden.
- Sie müssen auch sicherstellen, dass Ihr CORS in Ihrer Salesforce-Instanz eingerichtet ist.
XMLHttpRequest kann nicht geladen werden, die Antwort hat den Statuscode 401
Um Salesforce-API-Aufrufe zu tätigen, benötigen wir ein gültiges Zugriffstoken. Das Zugriffstoken wird auf den Showpad- Servern eingeholt und nicht im Browser des Benutzers. Wenn die Salesforce-Einstellung "sperrt die Sitzung auf die IP-Adresse" aktiviert ist, bedeutet dies, dass wir nur API-Aufrufe von den Showpad-Servern senden können, da wir das Salesforce-Token auf unseren Servern angefordert haben. Wenn Sie dieses Zugriffstoken für eine andere IP-Adresse (Ihren Browser) verwenden, funktioniert es aufgrund dieser Salesforce-Einstellung nicht. Wenn Sie diese Einstellung deaktivieren, kann das Zugriffstoken auch im Browser verwendet werden, und Sie können Salesforce-Anfragen in der Web-app stellen.
Beachten Sie, dass die mobilen Apps unsere Server nicht verwenden, um ein neues Zugriffstoken anzufordern, sodass sie dieses Problem nicht haben.
Sehen Sie, wie es in Salesforce Lightning gemacht wird
- Konfigurieren Sie CORS in Salesforce Lightning
- Richten Sie eine Salesforce-Instanz in Showpad ein
- Grundlegende Fehlerbehebung
Tun Sie dies Schritt für Schritt
1. Konfigurieren Sie CORS in Salesforce Lightning
Der erste Schritt beim Konfigurieren der Salesforce-Integration besteht darin, Anforderungen aus der Showpad-Domäne zuzulassen. Mit Salesforce können Kunden steuern, welche Websites die Salesforce-API verwenden dürfen. Auf diese Weise wird Ihre Salesforce-Instanz geschützt, indem nur Anforderungen von bekannten Websites zugelassen und alle anderen abgelehnt werden.
Diese Einstellung wird als CORS (Cross-Origin Resource Sharing) bezeichnet. Für die Integration von Showpad in Salesforce ist eine Konfiguration erforderlich. Die folgenden Anweisungen zeigen, wie ein Salesforce Admin es unserer Showpad Domain ermöglichen kann, Anforderungen an Ihr Salesforce-Instanz zu stellen. Wenn Sie dies bereits beim Einrichten Ihrer Standard-Showpad- und Salesforce-Integration getan haben, müssen Sie dies nicht erneut tun.
Dies erlaubt:
- Showpad, um eine Salesforce Aktivität zu erstellen, wenn ein Benutzer in der Showpad App oder in der Web-app Inhalte mit einem Interessenten oder Kunden teilt.
- Showpad zum Erstellen eines Salesforce- Ereignisses, wenn ein Benutzer in einer mobilen App eine Besprechung bei Salesforce protokollieren möchte.
- Gehen Sie zur Setup-Seite in Salesforce.com als Salesforce Admin.
- Suchen Sie im linken Menü nach CORS. Sie können auch manuell Sicherheitssteuerungen > CORS wählen.
- Einen neuen Ursprung auf der Whitelist hinzufügen.
- Fügen Sie https://*.showpad.biz hinzu und klicken Sie auf Speichern.
Hinweis: Wenn die Berechtigung Alle Daten ändern in Salesforce deaktiviert ist, werden wir Sie über die Showpad's Online Platform informieren, dass wir die CORS-Konfiguration nicht überprüfen konnten. Sie können die Integration weiterhin einrichten, wenn diese Warnung angezeigt wird.
- Um Salesforce und Showpad zu verbinden, müssen Sie Ihre Salesforce-Instanz (en) in Showpad einrichten. Sie können mehrere Salesforce-Instanzen konfigurieren, wenn Ihr Unternehmen mehr als eine verwendet.
Öffnen Sie die Showpad Online Platform und melden Sie sich mit Ihren Administrator-Anmeldeinformationen an. - Wählen Sie in den Einstellungen im Abschnitt Integrationen die Option CRM aus, und wählen Sie dann Salesforce-Instanz konfigurieren aus. Wenn Sie bereits mit einer Salesforce-Instanz verbunden sind, klicken Sie auf Salesforce-Instanz hinzufügen.
- Geben Sie eine Beschreibung für Ihre Salesforce-Instanz ein. Wenn Sie mehrere Salesforce-Instanzen einrichten möchten, müssen Sie für jede Instanz geeignete Namen auswählen, um die Identifizierung zu vereinfachen.
- Wenn Sie eine benutzerdefinierte Domäne für den Zugriff auf Salesforce verwenden, z. B. https://companyxyz.my.salesforce.com, aktivieren Sie "Benutzerdefinierte Domäne verwenden" und geben Sie "companyxyz" ein.
- Aktivieren Sie das Kontrollkästchen für die Community-Anmeldung und geben Sie die Community-Anmelde-URL ein.
- Showpad- Benutzerkonten können automatisch erstellt werden, wenn sich Benutzer zum ersten Mal mit ihren Salesforce- Anmeldeinformationen anmelden. Weitere Informationen zur Option "Automatische Bereitstellung".
- Klicken Sie auf Weiter und stellen Sie eine Verbindung Mit Salesforce verbinden.
- Sie müssen jetzt Ihre Salesforce-Anmeldeinformationen eingeben. Diese Anmeldung wird als Integration Benutzer verwendet werden, um mit Salesforcezu verbinden.
Wenn der Benutzer, der zum Konfigurieren dieser Integration verwendet wird, kein vollständiger Administrator ist, sind die folgenden Berechtigungen erforderlich:
Systemeinstellungen.- API aktiviert
- Aufgaben bearbeiten.
- Ereignisse bearbeiten.
- Rollen und Rollenhierarchie anzeigen
- Setup und Konfiguration anzeigen
Objekteinstellungen- Lesen / Erstellen / Bearbeiten für Leads, Kontakte, Opportunities, Kontenobjekte.
- Lesen / Erstellen / Bearbeiten / Löschen für Showpad- Aktivitäten, Showpad- Aktivitäten, Showpad Content & Showpad Content.
Nach dem Anmelden wird die Showpad Online Platform geöffnet. - Sie können jetzt Inhaltsempfehlungen für Ihre Vertriebskollegen aktivieren. Auf dieser Seite finden Sie weitere Informationen. Um diese Funktion nutzen zu können, müssen Sie die „ Showpad for Salesforce-App “ über AppExchange von Salesforce installieren. Klicken Sie auf Speichern.
- Die letzte Registerkarte, die Sie sehen, dient zum Aktivieren der erweiterten Protokollierung für benutzerdefinierte Objekte. Konto und Opportunity sind standardmäßig ausgewählt, und Sie können andere relevante Objekte angeben, indem Sie deren Kontrollkästchen für das Feld "Verwandt mit" aktivieren. Dadurch können Ihre Benutzer beim Protokollieren von Aufgaben Freigaben auf andere Objekte als Konten oder Opportunities beziehen.
- In Salesforce muss beim Bearbeiten oder Erstellen des benutzerdefinierten Objekts das Kontrollkästchen Aktivitäten zulassen im Abschnitt Optionale Funktionen aktiviert sein.
- Wählen Sie die benutzerdefinierten Objekte aus, für die Sie Aktivitäten protokollieren möchten, und klicken Sie dann auf Speichern. Die angezeigte Liste enthält dieselben Objekte, die in der Instanz des verbundenen SFDC im Feld "Bezogen auf" einer Aufgabe verfügbar sind. Benutzer können keine Besprechungen in einem benutzerdefinierten Objekt protokollieren.
- Sie können steuern, welche Benutzergruppen die Salesforce- Integration verwenden können! Klicken Sie auf die Registerkarte Gruppen mit Zugriff und wählen Sie Alle Benutzer oder Ausgewählte Gruppen aus. Wenn Sie Gruppen auswählen, aktivieren Sie die Kontrollkästchen für die Gruppen, denen Sie Zugriff auf die Integration gewähren möchten.
- Wenn eine Freigabe protokolliert wird, werden in den Kommentaren der Aufgabeninformationen der E-Mail-Text und ein Link zum Anzeigen der Freigabe als Empfänger angezeigt. Abhängig davon, wie Ihre Einstellungen konfiguriert sind, sieht es für Ihre Benutzer ähnlich aus.
3. Grundlegende Fehlerbehebung
OAuth-Authentifizierungsfehler
Die Showpad- und Salesforce-Integration funktioniert mit einer Server-zu-Server-Kommunikation. Dies hat zur Folge, dass die IP-Adresse des ursprünglichen Benutzers während des Anmeldevorgangs mit der Adresse des Showpads geändert wird.
In Fällen, in denen Anmelde-IP-Bereiche verwendet werden oder bei Benutzern OAuth-Anmeldefehler auftreten, empfehlen wir, die Einstellungen in der OAuth-App von IP-Einschränkungen erzwingen in IP-Einschränkungen lockern zu ändern.
Mit der Einstellung IP-Einschränkungen entspannen können Benutzer die verbundene Showpad-App ohne IP-Einschränkungen ausführen. Sie finden diese Einstellungen im Abschnitt Salesforce-Verwaltung.
- Suchen Sie im Setup nach verbundenen Apps. Öffnen Sie die OAuth-Verwendungsoptionen für verbundene Apps auf der Registerkarte Apps verwalten.
- Suchen Sie die Showpad Salesforce Integration-App und klicken Sie auf Installieren.
- Klicken Sie in der Liste Connect Apps OAuth Usage auf App-Richtlinien verwalten.
- Klicken Sie auf Richtlinien bearbeiten. Klicken Sie auf das Dropdown-Menü IP-Entspannung und ändern Sie erzwungene IP-Einschränkungen in lockere IP-Einschränkungen.
- Klicken Sie auf Speichern!
Die Salesforce-Verbindung funktioniert in der Web-app nicht
Stellen Sie sicher, dass Sie an einem Browser arbeiten, der HTML vollständig unterstützt. Um einen vollständigen Überblick über unsere Browseranforderungen zu erhalten, klicken Sie hier.
Stellen Sie für Internet Explorer-Benutzer sicher, dass Sie mit IE11 oder höher arbeiten. Stellen Sie sicher, dass in den Sicherheitseinstellungen die Option "Verschiedenes" für Internet und Intranet aktiviert ist. Ist dies nicht der Fall, lässt Internet Explorer nicht zu, dass die Showpad-Seite eine Verbindung zur Salesforce-Domäne herstellt und die Kontakt- und Leaddaten abruft.
- Gehen Sie zu Einstellungen, Internetoptionen, Sicherheit.
- Sie sollten ein Internet-Symbol sehen, stellen Sie sicher, dass es ausgewählt ist. Wenn sie das lokale Intranet verwenden, stellen Sie sicher, dass Sie dieselbe Änderung auch dort anwenden.
- Wählen Sie Benutzerdefiniert!
- Scrollen Sie, bis Sie Folgendes finden, und stellen Sie sicher, dass der Zugriff auf domänenübergreifende Datenquellen aktiviert ist
- Übernehmen und speichern.
- Stellen Sie sicher, dass Sie dieselben Einstellungen auch für das lokale Intranet anwenden.
- Sie müssen auch sicherstellen, dass Ihr CORS in Ihrer Salesforce-Instanz eingerichtet ist.
XMLHttpRequest kann nicht geladen werden, die Antwort hat den Statuscode 401
Für Salesforce-API-Aufrufe benötigen wir ein gültiges Zugriffstoken. Das Zugriffstoken wird auf den Showpad- Servern und nicht im Browser des Benutzers abgerufen. Wenn die Salesforce-Einstellung "Sperrt die Sitzung an die IP-Adresse" aktiviert ist, bedeutet dies, dass wir nur API-Anrufe von den Showpad-Servern senden können, da wir das Salesforce-Token auf unseren Servern angefordert haben. Wenn Sie dieses Zugriffstoken für eine andere IP-Adresse (Ihren Browser) verwenden, funktioniert es aufgrund dieser Salesforce-Einstellung nicht. Wenn Sie diese Einstellung deaktivieren, kann das Zugriffstoken auch im Browser verwendet werden und Sie können Salesforce- Anforderungen in der Web-app machen.
Beachten Sie, dass die mobilen Apps unsere Server nicht verwenden, um ein neues Zugriffstoken anzufordern, sodass sie dieses Problem nicht haben.
Navigieren Sie zu Sitzungseinstellungen und stellen Sie sicher, dass das Kontrollkästchen Sitzungen an die IP-Adresse sperren, von der sie stammen, deaktiviert ist.