Integrieren Sie Showpad-Aktivitäten in Salesforce

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 Webseiten zugelassen und alle anderen abgelehnt werden.

Diese Einstellung wird als CORS (Cross-Origin Resource Sharing) bezeichnet und für die Integration von Showpad in Salesforce ist eine Konfiguration erforderlich. Die folgenden Anweisungen zeigen, wie ein Salesforce-Administrator es unserer Showpad-Domäne ermöglichen kann, Anforderungen an Ihre Salesforce-Instanz zu stellen. 

Dies erlaubt:

• Showpad, 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, ein Salesforce-Ereigniss zu erstellen, wenn ein Nutzer in einer mobilen App eine Besprechung bei Salesforce protokollieren möchte.

1. Gehen Sie als Salesforce-Administrator zur Setup-Seite in Salesforce.com.
2. Suchen Sie im linken Menü nach CORS. Sie können auch manuell Sicherheitskontrollen > CORS auswählen.
3. Fügen Sie einen neuen Ursprung auf der Whitelist hinzu.
4. 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 weiter in Showpads Online Platform informieren, dass wir die CORS-Konfiguration nicht überprüfen konnten. Sie können die Integration weiterhin einrichten, wenn diese Warnung angezeigt wird.

2. Richten Sie eine Salesforce-Instanz in Showpad ein

1. 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 Administratoranmeldeinformationen an.
2. Wählen Sie in den Einstellungen im Abschnitt Integrationen die Option CRM aus, und wählen Sie dann Salesforce-Instanz konfigurieren aus.
3. 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.
   • Showpad-Benutzerkonten können automatisch erstellt werden, wenn sich Benutzer zum ersten Mal mit ihren Salesforce-Anmeldeinformationen anmelden. Erfahren Sie mehr zur Option Automatische Bereitstellung.
4. Klicken Sie auf Weiter und Mit Salesforce verbinden.
5. Sie müssen jetzt Ihre Salesforce-Anmeldeinformationen eingeben. Diese Anmeldung wird als Benutzer Integration verwendet werden, um mit Salesforce zu 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
   
   Objekt-Einstellungen
   • Lesen / Erstellen / Bearbeiten für Leads, Kontakte, Möglichkeiten und Kontenobjekte.
   • Lesen / Erstellen / Bearbeiten / Löschen für Showpad-Aktivitäten, Showpad- Aktivitätselemente, Showpad Content & Showpad Content.
   Die Integration funktioniert mit einer Server-zu-Server-Kommunikation. Das Ergebnis ist, dass die ursprüngliche IP-Adresse nicht der IP-Bereich oder die IP-Adresse des Unternehmens ist, sondern eine Showpad-IP-Adresse. Wenn Sie IP-Einschränkungen verwenden, empfehlen wir Ihnen, unsere OAuth-App-Empfehlungen zu lesen.
   Nach der Anmeldung wird die Online Platform von Showpad geöffnet. 
6. Sie können nun Inhaltsempfehlungen für Ihre Vertriebskollegen aktivieren. Auf dieser Seite finden Sie weitere Informationen dazu. Um diese Funktion nutzen zu können, müssen Sie über AppExchange von Salesforce, Showpad für die Salesforce-App installieren. Klicken Sie auf Speichern.
7. 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 „Bezogen auf“ aktivieren. Auf diese Weise können Ihre Nutzer beim Protokollieren von Aufgaben andere Objekte als Konten oder Opportunities freigeben.
8. In Salesforce muss beim Bearbeiten oder Erstellen des benutzerdefinierten Objekts das Kontrollkästchen „Aktivitäten zulassen“ im Abschnitt „Optionale Funktionen“ aktiviert sein.
9. 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.  
10. 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.
11. Wenn eine Freigabe protokolliert wird, werden Sie in den Kommentaren der Aufgabeninformationen den E-Mail-Text und ein Link zum Anzeigen der Freigabe als Empfänger sehen. Abhängig davon, wie Ihre Einstellungen konfiguriert sind, wird es für Ihre Benutzer ähnlich aussehen.

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

1. Suchen Sie im Setup nach Verbundenen Apps. Öffnen Sie die Verbundene Apps/OAuth-Verwendungsoptionen unter der Registerkarte Apps verwalten.
   
2. Suchen Sie die Showpad Salesforce Integration-App und klicken Sie auf Installieren.
3. Klicken Sie in der Liste „Verbundene Apps Apps OAuth Usage“ auf App-Richtlinien verwalten.
4. Klicken Sie auf Richtlinien bearbeiten. Klicken Sie auf das Dropdown-Menü IP-Entspannung und ändern Sie IP-Einschränkungen erzwingen in IP-Einschränkungen lockern.
   
5. 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 an 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 Leadsdaten abruft.

1. Gehen Sie zu Einstellungen, Internetoptionen, Sicherheit.
2. 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.
3. Wählen Sie Benutzerdefiniert.
4. Scrollen Sie, bis Sie Folgendes finden, und stellen Sie sicher, dass der Zugriff auf domänenübergreifende Datenquellen aktiviert ist
5. Übernehmen und speichern.
6. Stellen Sie sicher, dass Sie dieselben Einstellungen auch für das lokale Intranet anwenden.
7. 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-Aurufe 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 stellen.
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.