Integrieren Sie Showpad-Aktivitäten in Salesforce

Erfahren Sie, wie dies in Salesforce Lightning durchgeführt wird

• Konfigurieren Sie CORS in Salesforce Lightning
• Richten Sie eine Salesforce-Instanz in Showpad ein
• Grundlegende Fehlerbehebung

Ihre Schritt-für-Schritt-Anleitung

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 Webseiten die Salesforce-API verwenden darf. Auf diese Weise wird Ihre Salesforce-Instanz sicherer, da nur Anforderungen von bekannten Seiten 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-Administrator es unserer Showpad-Domäne ermöglichen kann, Anforderungen an Ihre Salesforce-Instanz zu richten. 

Dies ermöglicht es:

• Showpad, eine Salesforce-Aktivität zu erstellen, wenn ein Benutzer in der Showpad-App oder der Web-App Inhalte mit einem Interessenten oder Kunden teilt.
• Showpad zum Erstellen eines Salesforce- Ereignisses, wenn ein Benutzer in einer beliebigen mobilen App eine Besprechung in Salesforce protokollieren möchte.

1. Gehen Sie als Salesforce Administrator auf die Einrichtungseite auf Salesforce.com.
2. Suchen Sie im linken Menü nach CORS. Sie können auch manuell Sicherheitskontrollen > CORS auswählen.
3. Einen Neuen Whitelist-Ursprung hinzufügen.
4. Fügen Sie https: //*.Showpad.biz hinzu und klicken Sie dann auf Speichern.

   Hinweis: Wenn die Berechtigung Alle Daten Ändern in Salesforce deaktiviert ist, werden wir Sie über die Online Plattform von Showpad 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 eine Verbindung zwischen Salesforce und Showpad herzustellen, 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 Plattform und melden Sie sich dann mit Ihren Administrator-Anmeldeinformationen an.
2. Wählen Sie in den Einstellungen CRM unter dem Integrationen-Abschnitt aus und gehen Sie dann "Eine Salesforce-Instanz Konfigurieren".
3. Geben Sie eine Beschreibung für Ihre Salesforce-Instanz ein. Wenn Sie mehrere Salesforce-Instanzen einrichten möchten, müssen Sie die entsprechenden Namen für jede Instanz auswählen, damit diese leichter identifiziert werden können.
   • 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 Benutzer sich zum ersten Mal mit ihren Salesforce-Anmeldeinformationen anmelden. Erfahren Sie mehr über die Auto-Bereitstellungs-Option.
4. Klicken Sie auf "Weiter" und "Mit Salesforce Verbinden".
5. Sie müssen jetzt Ihre Salesforce-Anmeldeinformationen eingeben. Diese Anmeldung wird als Integrations-Benutzer verwendet, sodass mit Salesforce eine Verbindung hergestellt werden kann.
   Wenn der Benutzer, der zum Konfigurieren dieser Integration verwendet wird, kein vollständiger Administrator ist, sind die folgenden Berechtigungen erforderlich:
   • API-Zugriff
   • Lesen/ Schreiben für Aufgabe, Ereignis, Alle Showpad-Objekte
   • Lesen/ Schreiben für Leitung, Kontakt, Möglichkeit, Konto
   Die Integration erfolgt über eine Server-zu-Server-Kommunikation. Das diesbezüglich Ergebnis ist, dass die entstehende IP-Adresse, nicht der IP-Bereich oder die IP-Adresse des Unternehmens ist, sondern vielemehr eine Showpad-IP-Adresse. Wenn Sie die IP-Beschränkungen verwenden, lesen sie bitte unsere Empfehlungen zur OAuth-App.
   Nach der Anmeldung wird die Showpad-Online-Plattform erneut geöffnet. Ihren Benutzern wird beim Erstellen eines neuen Leads in Salesforce, ein Formular angezeigt werden. In diesem Bildschirm können Sie das Formular konfigurieren. Wiederholen Sie die Schritte für das Formular "Kontakte".
   • Es sind drei Felder erforderlich. Standardmäßig sind E-Mail, Nachname und Vorname ausgewählt.
   • Wählen Sie die Felder aus, die Sie mit aufnehmen möchten.
   • Ordnen Sie die Felder neu an, indem Sie auf ein Feld klicken, dieses halten, und dann an eine andere Position in der Liste ziehen.
   
6. Sie können jetzt die Inhaltsempfehlungen für Ihre Vertriebskollegen aktivieren. Auf dieser Seite finden Sie weitere Informationen. Um diese Funktion zu verwenden, müssen Sie die Showpad-for-Salesforce-App über das AppExchange von Salesforce installieren. Klicken Sie auf Speichern.
7. Auf der letzten angezeigten Registerkarte, können Sie die erweiterte Protokollierung für benutzerdefinierte Objekte aktivieren. Konto und Verkaufschance sind standardmäßig ausgewählt. Sie können andere relevante Objekte angeben, indem Sie die entsprechenden Kontrollkästchen im Feld "Im Zusammenhang Mit" ankreuzen. Somit können Ihre Benutzer beim Protokollieren von Aufgaben, die Freigaben mit anderen Objekten, als Konten oder Chancen verknüpfen.
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 die Aktivität protokollieren möchten. Klicken Sie dann auf Speichern. Die angezeigte Liste enthält dieselben Objekte, die in der Instanz des verbundenen SFDC im Feld "Im Zusammenhang Mit einer Aufgabe" verfügbar sind. Benutzer können keine Besprechungen in einem benutzerdefinierten Objekt protokollieren.  
10. Es kann kontrolliert werden, welche Benutzergruppen die Salesforce-Integration verwenden können. Klicken Sie auf die Registerkarte Gruppen mit Zugriff und wählen Sie dann Alle Benutzer oder Ausgewählte Gruppen aus. 
11. Wenn eine Freigabe protokolliert ist, wird der E-Mail-Text, sowie ein Link zum Anzeigen der Freigabe als Empfänger in den Kommentaren der Aufgabeninformationen angezeigt. Abhängig davon, wie Ihre Einstellungen konfiguriert sind, sieht dies für Ihre Benutzer ähnlich aus.

3. Grundlegende Fehlerbehebung

OAuth-Authentifizierungsfehler

Die Integration von Showpad und Salesforce funktioniert über eine Server-zu-Server-Kommunikation. Eine Folge davon ist, dass die entstehende IP-Adresse des Benutzers, während des Anmeldevorgangs in die IP-Adresse von Showpad geändert werden.

In Fällen, in denen die Anmelde-IP-Bereiche verwendet werden oder, wenn 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 OAuth-Verwendungs-Optionen für verbundene Apps in der Registerkarte Apps Verwalten.
   
2. Suchen Sie die Showpad Salesforce Integrations-App und klicken Sie dann auf Installieren.
3. Klicken Sie in der OAuth-Verwendungsliste von Verbundenen Apps auf App-Richtlinien Verwalten.
4. Klicken Sie auf Richtlinien Bearbeiten. Klicken Sie auf das Dropdown-Menü IP-Lockern und ändern Sie "IP-Einschränkungen Erzwingen" in "IP-Einschränkungen Lockern"
   
5. Klicken Sie dann auf Speichern.

Salesforce Verbindung funktioniert nicht innerhalb der Web App

Stellen Sie sicher, dass Sie mit einem Browser arbeiten, der vollständig HTML unterstützt. Sie können hier eine vollständige Übersicht über unsere Browseranforderungen finden.
Stellen Sie für die Nutzer des Internet Explorers sicher, dass Sie mit IE11 oder höher arbeiten. Stellen Sie sicher, dass in den Sicherheitseinstellungen die Option Verschiedenes aktiviert haben, die sowohl für das Internet, als auch für das Intranet aktiviert ist. Ist dies nicht der Fall, wird der Internet Explorer nicht zulassen, dass die Showpad-Seite eine Verbindung zur Salesforce-Domäne herstellt und die Daten für Kontakte und Leads abgerufen werde können.

1. Gehen Sie zu Einstellungen, Internetoptionen, Sicherheit.
2. Sie sollten ein Internet-Symbol sehen können. Stellen Sie sicher, dass dieses ausgewählt ist. Wenn sie das lokale Intranet verwenden, stellen Sie bitte sicher, dass Sie auch dort die gleichen Änderung anwenden.
3. Wählen Sie Benutzerdefiniert aus.
4. Scrollen Sie, bis Sie das unten aufgeführte finden. Vergewissern Sie sich, dass Auf Datenquellen Domänenübergreifend aktiviert ist
5. Übernehmen und Speichern.
6. Stellen Sie sicher, dass Sie die gleichen 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 die 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 "Sperrung der Sitzung an 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 auf einer anderen IP-Adresse (Ihrem Browser) verwenden, wird dies aufgrund der Salesforce-Einstellung nicht funktionieren. Wenn Sie diese Einstellung deaktivieren, kann das Zugriffstoken auch im Browser verwendet werden. Sie können dann die Salesforce-Anforderungen in der Web App anfragen.
Bitte beachten Sie, dass die mobilen Apps nicht unsere Server verwenden, um ein neues Zugriffstoken anzufordern, sodass sie dieses Problem nicht haben.

Navigieren Sie zu den Sitzungseinstellungen und stellen Sie sicher, dass das Kontrollkästchen Sitzungen der IP-Adresse Sperren, von der sie stammen, nicht aktiviert ist.