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, Anfragen aus der Showpad-Domain zuzulassen. Mit Salesforce können Kunden steuern, welche Webseiten die Salesforce-API verwenden dürfen. Auf diese Weise wird Ihre Salesforce-Instanz sicherer, da 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-Administrator unsere Showpad-Domain aktivieren kann, um Anfragen an Ihre Salesforce-Instanz zu machen. 

Dies ermöglicht:

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

1. Gehen Sie als ein Salesforce-Administrator auf Salesforce.com.com zu der Seite Setup.
2. Suchen Sie im Menü auf der linken Seite nach CORS. Sie können auch manuell Security Controls > CORS auswählen.
3. Fügen Sie einen neuen Whitelist-Ursprung hinzu.
4. Fügen Sie https: //*.showpad.biz hinzu und klicken Sie auf Save.

   Hinweis: Wenn die Berechtigung Modify All Data auf Salesforce deaktiviert ist, werden wir Sie über die Online Platform 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 mehrere verwendet.
   Öffnen Sie die Online Platform von Showpad und melden Sie sich mit Ihren Administrator-Anmeldeinformationen an.
2. Wählen Sie in den Einstellungen unter dem Abschnitt Integrations CRM und danach Configure a Salesforce-Instanz aus.
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 sie leichter identifiziert werden können.
   • Wenn Sie eine benutzerdefinierte Domain für den Zugriff auf Salesforce verwenden, wie z. B. https://companyxyz.my.salesforce.com, aktivieren Sie Use a Custom Domain und geben Sie companyxyz ein.
   • Benutzerkonten können in Showpad automatisch erstellt werden, wenn die Benutzer sich zum ersten Mal mit ihren Salesforce-Anmeldeinformationen anmelden. Erfahren Sie mehr über die Option Auto-Provisioning.
4. Klicken Sie auf Next und Connect to Salesforce.
5. Sie müssen jetzt Ihre Salesforce-Anmeldeinformationen eingeben. Diese Anmeldung wird als Integration verwendet, um den Benutzer mit Salesforce zu verbinden.
   Wenn der Benutzer, der zum Konfigurieren dieser Integration verwendet wird, kein mit allen Rechten versehener Administrator ist, sind die folgenden Berechtigungen erforderlich:
   • API-Zugriff
   • Lesen/Schreiben für Task, Event, All Showpad Objects
   • Lesen/Schreiben für Lead, Contact, Opportunity, Account
   Die Integration funktioniert mithilfe einer Server-zu-Server-Kommunikation. Im Ergebnis ist die Ursprungs-IP-Adresse nicht der IP-Bereich oder die IP-Adresse des Unternehmens, sondern eine Showpad-IP-Adresse. Wenn Sie IP-Einschränkungen verwenden, empfehlen wir, unsere Empfehlungen für die OAuth-App zu lesen.
   Nach dem Anmelden wird erneut die Online Platform von Showpad geöffnet. Ihren Benutzern wird beim Erstellen eines neuen Leads in Salesforce ein Formular angezeigt. Auf diesem Bildschirm können Sie das Formular konfigurieren. Wiederholen Sie die Schritte für das Formular Contacts.
   • Drei Felder sind erforderlich. Standardmäßig sind E-Mail, Nachname und Vorname ausgewählt.
   • Wählen Sie die Felder aus, die Sie mit inschließen möchten.
   • Ordnen Sie die Felder neu an, indem Sie auf ein Feld klicken, es halten und an eine andere Position in der Liste ziehen.
   
6. Sie können jetzt Content Recommendations 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 AppExchange von Salesforce installieren. Klicken Sie auf Save.
7. Auf der letzten angezeigten Registerkarte können Sie die erweiterte Aufzeichnung für benutzerdefinierte Objekte aktivieren. Account und Opportunity werden standardmäßig ausgewählt. Wenn Sie diese Funktion jedoch aktivieren, können Sie andere relevante Objekte für das Feld „Related To“ angeben. Dies ermöglicht es Ihren Benutzern, Freigaben mit anderen Objekten als Accounts oder Opportunities zu verknüpfen, wenn sie Aufgaben aufzeichnen. 
8. In Salesforce muss beim Bearbeiten oder Erstellen des benutzerdefinierten Objekts das Kontrollkästchen Allow Activities im Abschnitt Optional Features aktiviert sein.
9. Wählen Sie die benutzerdefinierten Objekte aus, für die Sie die Aktivität aufzeichnen möchten, und klicken Sie dann auf Save. Die angezeigte Liste enthält dieselben Objekte, die in der verbundenen SFDC-Instanz im Feld Related To einer Task verfügbar sind. Benutzer können Meetings zu einem benutzerdefinierten Objekt nicht aufzeichnen.  
10. Es ist möglich zu steuern, welche Benutzergruppen die Salesforce-Integration verwenden können. Klicken Sie auf die Registerkarte Groups with Access und wählen Sie All Users oder Selected Groups aus. 
11. Wenn eine Freigabe aufgezeichnet wird, sehen Sie den E-Mail-Text und einen Link, um die Freigabe als Empfänger in den Kommentaren der Aufgabeninformationen anzuzeigen. Je nachdem, wie Ihre Einstellungen konfiguriert sind, wird es für Ihre Benutzer ähnlich aussehen.

3. Grundlegende Fehlerbehebung

OAuth-Authentifizierungsfehler

Die Integration von Showpad und Salesforce funktioniert mittels einer Server-zu-Server-Kommunikation. Dies hat zur Folge, dass die ursprüngliche Benutzer-IP-Adresse während des Anmeldevorgangs auf die Showpad-Adresse geändert wird.

In Fällen, in denen Login-IP-Bereiche verwendet werden, oder Benutzer OAuth-Anmeldefehler feststellen sollten, empfehlen wir, die Einstellungen in der OAuth-App von Enforce IP Restrictions auf Relax IP Restrictions zu ändern.

Mit der Einstellung Relax IP Restrictions können Benutzer die verbundene Showpad-App ohne IP-Einschränkungen ausführen. Sie finden diese Einstellungen im Abschnitt Salesforce-Administer.

1. Suchen Sie im Setup nach Connected Apps. Öffnen Sie die Optionen Connected Apps OAuth Usage auf der Registerkarte Manage Apps.
   
2. Suchen Sie die Salesforce Integration-App von Showpad und klicken Sie auf Install.
3. In der Liste Connect Apps OAuth Usage klicken Sie bitte auf Manage App Policies.
4. Klicken Sie auf Edit Policies. Klicken Sie auf das Dropdown-Menü IP Relaxation und ändern Sie die Enforce IP Restrictions auf Relax IP Restrictions.
   
5. Klicken Sie auf Save.

Salesforce Verbindung funktioniert nicht in der Web-App

Stellen Sie sicher, dass Sie mit einem Browser arbeiten, der HTML vollständig unterstützt. Eine vollständige Übersicht über unsere Browseranforderungen finden Sie hier.
Benutzer des Internet Explorer sollten sicherstellen, dass Sie mit IE11 oder höher arbeiten. Stellen Sie sicher, dass in den Security Settings die Option Verschiedenes sowohl für das Internet als auch für das Intranet aktiviert ist. Wenn dies nicht der Fall ist, lässt der Internet Explorer nicht zu, dass sich die Showpad-Seite mit der Salesforce-Domain verbindet und die Daten der Kontakte und Leads abruft.

1. Gehen Sie zu Einstellungen, Internet Options, Security.
2. Sie sollten ein Internet-Symbol sehen, stellen Sie sicher, dass es ausgewählt ist. Wenn sie das Local Intranet verwenden, stellen Sie sicher, dass Sie die gleiche Änderung auch dort machen.
3. Wählen Sie Custom.
4. Scrollen Sie herunter, bis Sie das Nachstehende finden, und stellen Sie sicher, dass Access Data Sources Across Domains aktiviert ist.
5. Klicken Sie auf Apply und Save.
6. Stellen Sie sicher, dass Sie die gleichen Einstellungen auch für das Local Intranet anwenden.
7. Sie müssen auch sicherstellen, dass Ihr CORS in Ihrer Salesforce-Instanz eingerichtet ist.

XMLHttpRequest kann nicht geladen werden, die Antwort beinhaltet den Statuscode 401

Für Salesforce-API-Aufrufe benötigen wir ein gültiges Zugriffstoken. Das Zugriffstoken wird auf den Showpad-Servern und nicht auf dem Browser des Benutzers abgerufen. Wenn die Salesforce-Einstellung ,,Locks the session to the IP address" aktiviert ist, bedeutet dies, dass wir nur API-Aufrufe von den Showpad-Servern senden können, weil wir das Salesforce-Token auf unseren Servern angefordert haben. Wenn Sie dieses Zugriffstoken auf einer anderen IP-Adresse (Ihrem 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 auf 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 Session Settings und stellen Sie sicher, dass das Kontrollkästchen ,,Lock sessions to the IP address from which they originated" nicht aktiviert ist.