Integrieren Sie Showpad-Aktivitäten in Salesforce

Wie Sie dadurch profitieren 

Mit der Salesforce-Integration von Showpad können Benutzer die Menge ihrer Verwaltungsaufgaben erheblich reduzieren. In Salesforce lassen wir zunächst Abfragen von der Showpad-Domain zu. Anschließend konfigurieren wir die Salesforce-Integration in Showpad.

Das benötigen Sie

• Aktive Admin-Berechtigungen auf der Showpad- und der Salesforce-Plattform
• Showpad Ultimate-Paket
• Salesforce Enterprise- oder Unlimited-Plan
• Um dieser Anleitung zu folgen, wechseln Sie zu Salesforce Classic View, falls Lightning View aktiviert ist

Der schnelle Weg zur Großartigkeit

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

Tun Sie dies Schritt für Schritt

1. Konfigurieren Sie CORS in Salesforce

Der erste Schritt beim Konfigurieren der Salesforce-Integration besteht darin, Abfragen von der Showpad-Domain zuzulassen. Mit Salesforce können Kunden steuern, welche Websites die Salesforce-API verwenden dürfen. Auf diese Weise wird Ihre Salesforce-Instanz sicherer, da nur Abfragen von bekannten Sites 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 Abfragen von unserer Showpad-Domain an Ihre Salesforce-Instanz zulassen kann. 

Dies ermöglicht:

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

1. Rufen Sie die Setup-Seite in Salesforce.com als Salesforce-Administrator auf.
2. Suchen Sie im linken Menü nach CORS. Sie können auch manuell Sicherheitskontrollen > CORS auswählen. 
3. Fügen Sie einen neuen Whitelist-Ursprung 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, informieren wir Sie dementsprechend über Showpads Online Platform, 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 Platform und melden Sie sich mit Ihren Administrator-Anmeldeinformationen an.
2. Wählen Sie CRM in den Einstellungen unter dem Abschnitt „Integrationen“ und wählen 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 entsprechende 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, z. B. https://companyxyz.my.salesforce.com, aktivieren Sie die Option „Benutzerdefinierte Domain 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-Provisioning-Option.
4. Klicken Sie auf „Weiter“ und „Mit Salesforce verbinden“. 
5. Sie müssen jetzt Ihre Salesforce-Anmeldeinformationen eingeben. Dieser Login wird als Integrationsbenutzer verwendet, um eine Verbindung zu Salesforce herzustellen und es muss sich dabei um einen aktiven Administrator in Showpad und Salesforce handeln.
   Die Integration funktioniert über eine Server-zu-Server-Verbindung. Dadurch wird die Ursprungs-IP-Adresse nicht im IP-Adressbereich des Unternehmens liegen oder die IP-Adresse des Unternehmens sein, sondern eine Showpad-IP-Adresse. Wenn Sie IP-Einschränkungen verwenden, empfehlen wir Ihnen, unsere Empfehlungen für die OAuth-App zu lesen.
   Nach dem Anmelden wird die Showpad Online Platform erneut geöffnet. Ihren Benutzern wird beim Erstellen eines neuen Leads in Salesforce ein Formular angezeigt. In diesem Fenster können Sie das Formular konfigurieren. Wiederholen Sie die Schritte für das Formular „Kontakte“.
   • Dazu sind drei Felder erforderlich. Standardmäßig sind E-Mail, Nachname und Vorname ausgewählt.
   • Wählen Sie die Felder aus, die Sie einbeziehen 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-Empfehlungen 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 „Speichern“.
7. Auf der letzten angezeigten Registerkarte können Sie die erweiterte Verfolgung für benutzerdefinierte Objekte aktivieren. Konto und Verkaufschance werden standardmäßig ausgewählt. Wenn Sie diese Funktion jedoch aktivieren, können Sie andere relevante Objekte für das Feld „Bezug zu“ angeben. Auf diese Weise können Ihre Benutzer beim Verfolgen von Aufgaben Freigaben mit anderen Objekten als Konten oder Verkaufschancen verknüpfen. 
8. In Salesforce muss für das benutzerdefinierte Objekt 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 verfolgen möchten, und klicken Sie dann auf „Speichern“. Die angezeigte Liste enthält dieselben Objekte, die in der verbundenen SFDC-Instanz im Feld „Bezug zu“ einer Aufgabe verfügbar sind. Benutzer können keine Besprechungen in einem benutzerdefinierten Objekt verfolgen.  
10. Es kann festgelegt werden, 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 verfolgt wird, werden der E-Mail-Text und ein Link zum Anzeigen der Freigabe aus der Sicht des Empfängers in den Kommentaren der Aufgabeninformationen angezeigt. Abhängig davon, wie Ihre Einstellungen konfiguriert sind, sieht für Ihre Benutzer alles ähnlich aus. 
    
    

3. Grundlegende Fehlerbehebung

OAuth-Authentifizierungsfehler

Die Integration von Showpad und Salesforce funktioniert über eine Server-zu-Server-Verbindung. Dies hat zur Folge, dass die IP-Adresse des Ursprungsbenutzers während des Anmeldevorgangs zu der Adresse von Showpad geändert wird.

In Fällen, in denen IP-Anmeldebereiche verwendet werden oder OAuth-Anmeldefehler bei Benutzern 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 der Salesforce-Verwaltung.

1. Öffnen Sie die OAuth-Verwendungsoptionen für verbundene Apps auf der Registerkarte „Apps verwalten“.
   
2. Suchen Sie die Showpad Salesforce Integration-App und klicken Sie auf „Installieren“.
3. Auf der Registerkarte „Verbundene Apps“ können Sie die OAuth-Richtlinien anzeigen und die Option „IP-Einschränkungen erzwingen“ in „IP-Einschränkungen lockern“ ändern.
   

Die Salesforce-Verbindung funktioniert nicht in der Web-App

Stellen Sie sicher, dass Sie mit einem Browser arbeiten, der HTML vollständig unterstützt. Eine komplette Übersicht unserer Browseranforderungen finden Sie hier.
Stellen Sie als Benutzer des Internet Explorers sicher, dass Sie mit IE11 oder höher arbeiten. Stellen Sie sicher, dass Sie in den sonstigen Sicherheitseinstellungen sowohl Internet als auch Intranet aktiviert haben. Ist dies nicht der Fall, lässt Internet Explorer nicht zu, dass die Showpad-Seite eine Verbindung zur Salesforce-Domain herstellt und die Daten für Kontakte und Leads abruft.

1. Gehen Sie zu Einstellungen, Internetoptionen, Sicherheit.
2. Sie sollten dort ein Internet-Symbol sehen; stellen Sie sicher, dass es ausgewählt ist. Wenn sie das lokale Intranet verwenden, stellen Sie sicher, dass Sie dort auch die gleiche Änderung vornehmen.
3. Wählen Sie „Benutzerdefiniert“.
4. Scrollen Sie nach unten und vergewissern Sie sich, dass der domainübergreifende Zugang zu Datenquellen erlaubt ist
5. Übernehmen und speichern Sie die Einstellungen.
6. Stellen Sie sicher, dass Sie die gleichen Einstellungen auch für das lokale Intranet vornehmen.
7. Sie müssen auch sicherstellen, dass Ihr CORS in Ihrer Salesforce-Instanz eingerichtet ist.

XMLHttpRequest kann nicht geladen werden; 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 „Sitzung an die IP-Adresse binden“ aktiviert ist, können wir nur API-Aufrufe von den Showpad-Servern senden, da 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-Abfragen in der Web-App machen.
Beachten Sie, dass die mobilen Apps beim Anfordern eines neuen Zugrifftokens unsere Server nicht verwenden, sodass sie dieses Problem auch nicht haben.