Integrieren Sie Showpad-Aktivitäten in Salesforce

Mit der Salesforce-Integration von Showpad können Benutzer ihre Verwaltungsaufgaben erheblich reduzieren, indem sie ihre Showpad-Aktivitäten einfach in Salesforce protokollieren. Nach der Konfiguration können Benutzer jede Showpad-E-Mail oder Linkfreigabe für den entsprechenden Kontakt, Lead, Opportunity oder Account in Salesforce protokollieren. In Salesforce lassen wir zunächst Anfragen zu, die von der Showpad-Domäne kommen. Dann konfigurieren wir die Einstellungen in Showpads Online Platform.

Sie benötigen dies, um erfolgreich zu sein

• Aktive Admin-Rechte sowohl auf der Showpad- als auch auf der Salesforce-Plattform
• Showpad Ultimativer Plan
• Salesforce Enterprise- oder Unlimited-Plan
• Die Benutzer, die ihre Aktivitäten in Salesforce protokollieren, benötigen
  • API-Zugang
  • Zugriff auf die Datensätze, für die Sie Ihnen Zugang gewähren möchten (z. B. Konto, Opportunity, Lead und Kontakt)
  • Berechtigung für Aufgabenerstellung, -Bearbeitung und -Anzeige
• Bevor Sie diese Schritte ausführen, stellen Sie bitte sicher, dass Ihre Salesforce-Instanz mit Showpad’s Online-Plattform verbunden ist. Lesen Sie hier, wie Sie dies tun können.

Sehen Sie, wie es funktioniert

• CORS konfigurieren
• Kontakte filtern und Objektprotokollierung konfigurieren
• Sicherstellen der richtigen Aufgabenart
• Grundlegende Fehlerbehebung

Tun Sie dies Schritt für Schritt

CORS konfigurieren

Der erste Schritt bei der Konfiguration der Salesforce-Integration besteht darin, Anfragen von der Showpad-Domäne zuzulassen. Salesforce erlaubt seinen Kunden zu kontrollieren, welche Websites die Salesforce-API nutzen dürfen. Dies trägt zur Sicherheit Ihrer Salesforce-Instanz bei, da nur Anfragen von bekannten Websites zugelassen und alle anderen abgelehnt werden.

Diese Einstellung wird CORS (Cross-Origin Resource Sharing) genannt und muss konfiguriert werden, damit Showpad mit Salesforce integriert werden kann. Die folgenden Anweisungen zeigen, wie ein Salesforce Admin unserer Showpad Domain ermöglichen kann, Anfragen an Ihre Salesforce-Instanz zu stellen.

Das Einrichten ermöglicht:

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

1. Rufen Sie die Einrichtungsseite mit Salesforce.com als Salesforce admin auf.
2. Suchen Sie im linken Menü nach CORS. Sie können auch manuell Sicherheitskontrollen auswählen > CORS.
3. Eine neue erlaubte Herkunft hinzufügen.
4. Fügen Sie https://*.showpad.biz hinzu und klicken Sie auf Speichern. Hier verwenden Sie ein Sternchen anstelle des Namens Ihrer Organisation.

   Hinweis: Wenn die Berechtigung Alle Daten ändern in Salesforce deaktiviert ist, werden wir Sie auf Showpad's Online Platform darüber informieren, dass wir die CORS-Konfiguration nicht überprüfen konnten. Sie können die Integration weiterhin einrichten, wenn diese Warnung angezeigt wird.

5. Wenn Sie eine E-Mail-Freigabe verfassen, ruft Salesforce vorgeschlagene Einträge aus Ihrer vollständigen Kontaktliste ab. Die Beeinflussung und Einschränkung dieser Abfrage ist für bestimmte Anwendungsfälle möglich. Sprechen Sie mit Ihrem Customer Success Manager, wenn Sie mehr darüber erfahren möchten.

Kontakte filtern und Objektprotokollierung konfigurieren

1. Wählen Sie zuerst auf der Registerkarte Filter aus, welche Kontakte die Benutzer sehen können. Dies sind die Kontakte, die angezeigt werden, wenn Sie eine E-Mail-Freigabe in Showpad senden. Klicken Sie im Abschnitt CRM-Daten für Showpad section auf Bearbeiten um Kontakte & Leads zu filtern.
2. Legen Sie fest, was Benutzer sehen können:
   • Alle Kontakte (d.h. alle Kontakte, auf die sie gemäß ihren Einstellungen für Profile, Berechtigungen und Freigaberegeln in Salesforce Zugriff haben).
   • Nur die Kontakte von Nutzern (d.h. nur die Kontakte, für die Sie unter Salesforceals Eigentümer eingetragen sind).
3. Klicken Sie auf Speichern.
4. Um die erweiterte Protokollierung für benutzerdefinierte Objekte zu aktivieren, navigieren Sie zum Abschnitt Showpad-Daten zu CRM und klicken Sie auf Bearbeiten. Konto und Opportunity werden standardmäßig ausgewählt, und Sie können weitere Kästchen ankreuzen, um andere relevante benutzerdefinierte Objekte für das Feld „Zugehörig zu“ anzugeben. Dadurch können Ihre Nutzer bei der Erfassung von Aufgaben Freigaben mit anderen Objekten als Konten oder Opportunities verknüpfen.
5. In Salesforce müssen für das benutzerdefinierte Objekt die Kästchen Aktivitäten zulassen und Suche zulassen in den Abschnitten Optionale Funktionen und Suchstatus aktiviert sein.
6. Wählen Sie die benutzerdefinierten Objekte aus, für die Sie die Aktivität 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 „Verwandt mit“ einer Aufgabe verfügbar sind. Benutzer können keine Meetings in einem benutzerdefinierten Objekt protokollieren.
7. Es ist möglich zu steuern, welche Nutzer Gruppen die Salesforce Integration nutzen können. Klicken Sie in den Admin-Einstellungen im Menü auf der linken Seite auf Funktionen. Scrollen Sie nach unten zu Salesforce Connection und wählen Sie Alle Benutzer oder Gruppen auswählen. Wählen Sie, falls gewünscht, die Gruppen aus, denen Sie Zugriff gewähren möchten, und klicken Sie dann auf „Übernehmen“.
8. Wenn eine Freigabe protokolliert wird, sehen Sie den E-Mail-Text und einen Link zum Anzeigen der Freigabe als Empfänger unter Kommentare in den Aufgabeninformationen. Je nachdem, wie Sie Ihre Einstellungen konfiguriert haben, wird es für Ihre Nutzer ähnlich aussehen.
9. Optional können Sie zulassen, dass die Showpad-E-Mail-Freigabeaktivitäten für mehrere Kontakte protokolliert werden. Navigieren Sie dazu in Salesforce zu Einrichtung, Funktionseinstellungen, Vertrieb und dann zu Aktivitätseinstellungen. Aktivieren Sie die Option „Benutzern das Verknüpfen erlauben“.
   Wenn Sie Ihr Salesforce-Instanz bereits mit Showpad verbunden haben, bevor Sie diese Option aktiviert haben, kehren Sie bitte zu dem CRM zurück, das Sie unter Showpad's Online Platform eingerichtet haben. Klicken Sie zum Öffnen im Protokollierung-Abschnitt auf Bearbeiten und speichern Sie Ihre Protokollierungsobjekte erneut. Dadurch wird die Einstellung für mehrere Kontakte in Salesforce neu synchronisiert.
10.  

Sicherstellen der Aufgabenart.

Bei der Erstellung der protokollierten Aktivitäten kann Showpad das Feld Salesforce „Typ“ auf einen relevanten Wert setzen, der auf der spezifischen Art der protokollierten Freigabe basiert (Showpad share, Showpad email, shared space, etc), was bei der Berichterstellung hilfreich sein kann. Um sicherzustellen, dass Aufgaben diesen Typ erhalten, sollten diese Werte in Salesforce vorhanden sein, bevor Sie Ihre Salesforce-Instanz in OP verbinden. Um sie nachträglich hinzuzufügen, können Sie eine erneute Synchronisierung der verfügbaren Aufgabentypen auslösen, indem Sie die Registerkarte Benutzerdefinierte Objekte öffnen und erneut speichern, wie in Schritt 2 oben beschrieben.

 

Grundlegende Fehlerbehebung

OAuth-Authentifizierungsfehler

Die Integration von Showpad und Salesforce funktioniert über eine Server-zu-Server-Kommunikation. Dies hat zur Folge, dass die ursprüngliche Nutzer-IP-Adresse während des Anmeldevorgangs mit der Adresse von Showpad ausgetauscht wird.

In Fällen, in denen Login-IP-Bereiche verwendet werden, oder wenn bei Benutzern OAuth-Anmeldefehler auftreten, empfehlen wir, die Einstellungen in der OAuth-App von IP-Beschränkungen erzwingen auf IP-Beschränkungen lockern zu ändern.

Die Einstellung IP-Beschränkungen aufheben ermöglicht es Nutzern, die verbundene Showpad-App ohne IP-Beschränkungen auszuführen. Sie finden diese Einstellungen unter dem Salesforce Verwalten Abschnitt.

1. Suchen Sie unter Einrichtung nach „Verbundene Apps“. Öffnen Sie die Optionen „OAuth-Verwendung für verbundene Apps“ auf der Registerkarte Apps verwalten.
   
2. Suchen Sie die App Showpad Salesforce Integration und klicken Sie auf Installieren.
3. Klicken Sie in der Liste Connect Apps OAuth Usage auf Manage App Policies.
4. Klicken Sie auf Richtlinien bearbeiten. Klicken Sie auf das Dropdown-Menü IP-Lockerung und ändern Sie dann IP-Beschränkungen erzwingen auf IP-Beschränkungen lockern
   
5. Klicken Sie auf Speichern.

Die Salesforce-Verbindung funktioniert nicht in der Web-app

Vergewissern Sie sich, dass Sie mit einem Browser arbeiten, der HTML vollständig unterstützt. Eine vollständige Übersicht über unsere Browseranforderungen finden Sie hier.
Vergewissern Sie sich, dass in den Sicherheitseinstellungen die Option Sonstiges sowohl für Internet als auch für Intranet aktiviert ist. Wenn dies nicht der Fall ist, erlaubt Internet Explorer der Showpad-Seite nicht, sich mit der Salesforce-Domäne zu verbinden und die Kontakt- und Lead-Daten abzurufen.

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 nutzen, sollten Sie die gleiche Änderung auch dort vornehmen.
3. Wählen Sie Benutzerdefiniert.
4. Scrollen Sie, bis Sie Folgendes finden: Sicherstellen dass domänenübergreifender Zugriff auf Datenquellen aktiviert ist.
5. Klicken Sie auf Anwenden und Speichern.
6. Stellen Sie sicher, dass Sie die gleichen Einstellungen auch für das lokale Intranet vornehmen.
7. Sie müssen auch sicherstellen, dass Sie Ihre CORS in Ihrer Salesforce-Instanz eingerichtet haben.

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 und nicht im Browser des Nutzers abgerufen. 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 über eine andere IP-Adresse (Ihren Browser) verwenden, wird es aufgrund dieser Salesforce-Einstellung nicht funktionieren. 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 dieses Problem nicht auftritt.

Navigieren Sie zu Sitzungseinstellungen und stellen Sie sicher, dass das Kontrollkästchen „Binden von Sitzungen an die IP-Adresse, von der sie stammen“ deaktiviert ist.