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. Wenn Sie diese Funktion konfiguriert haben, können Sie jede Showpad-E-Mail oder jeden Link zum entsprechenden Kontakt, Lead, zur Gelegenheit oder zum Konto in Salesforce protokollieren. In Salesforce lassen wir zunächst Anfragen zu, die von der Showpad-Domäne kommen. Anschließend konfigurieren wir die Einstellungen in der Online Plattform von Showpad.

Sie benötigen dies, um erfolgreich zu sein

• Aktive Admin-Rechte sowohl auf der Showpad-, als auch auf der Salesforce-Plattform
• Showpad Ultimate Plan
• Salesforce Enterprise oder Unlimited Plan
• Die Benutzer, die ihre Aktivitäten in Salesforce protokollieren, benötigen einen
  • API-Zugang
  • Zugriff auf die Datensätze, für die Sie eine Protokollierung wünschen (z. B. Konto, Gelegenheit, Lead und Kontakt)
  • Berechtigung für Aufgaben erstellen, bearbeiten und anzeigen
• Bevor Sie diese Schritte ausführen, vergewissern Sie sich bitte, dass Ihre Salesforce-Instanz mit Showpads Online Platform verbunden ist. Lesen Sie hier, wie Sie dies tun können.

Sehen Sie, wie es gemacht wird

• 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 Nutzer auf einer beliebigen mobilen App ein Meeting mit Salesforce protokollieren möchte.

1. Rufen Sie die Einrichtungsseite unter Salesforce.com als Salesforce Admin auf.
2. Suchen Sie im linken Menü nach „CORS". Sie können auch manuell "Sicherheitskontrollen" auswählen und dann "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 Showpads 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 Kundenerfolgs-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. In den CRM Daten zum Showpad-Abschnitt, klicken Sie 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 des Nutzers (d. h. nur die Kontakte, für die Sie in Salesforce als Eigentümer eingetragen sind).
3. Klicken Sie auf "Speichern".
4. Um die erweiterte Protokollierung für benutzerdefinierte Objekte zu aktivieren, navigieren Sie bitte zum Abschnitt "Showpad-Daten zu CRM" und klicken Sie dann auf "Bearbeiten". "Konto und Gelegenheit" werden standardmäßig ausgewählt. Sie können weitere Kästchen markieren, um andere relevante benutzerdefinierte Objekte für das Feld "Zugehörig zu" anzugeben. Dadurch können Ihre Nutzer bei der Erfassung/Protokollierung von Aufgaben Freigaben mit anderen Objekten als Konten oder Gelegenheiten 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 die gleichen Objekte, die in der Instanz des verbundenen SFDCs im Feld „Zugehörig zu einer Aufgabe“ verfügbar sind. Nutzer können keine Besprechungen in einem benutzerdefinierten Objekt protokollieren.
7. Es ist möglich zu steuern, welche Nutzer-Gruppen Aktivitäten in Salesforce Integration protokollieren können. In den Admin-Einstellungen klicken Sie im Menü auf der linken Seite auf "Funktionen". Scrollen Sie nach unten zu Salesforce Activity Login und wählen Sie "Alle Benutzer" oder wählen Sie bestimmte Gruppen aus. Wählen Sie, falls gewünscht, die Gruppen aus, auf die Sie Zugriff haben möchten, und klicken Sie dann auf "Anwenden".
   
8. Wenn eine Freigabe protokolliert 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 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 Ihre Salesforce-Instanz bereits mit Showpad verbunden haben, bevor Sie diese Option aktiviert haben, kehren Sie bitte zu dem CRM zurück, das Sie in Showpads Online Platform eingerichtet haben. Klicken Sie im Abschnitt Protokollierung auf "Bearbeiten", um sie zu öffnen, und speichern Sie Ihre protokollieren Objekte 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 des protokollierten Teilens basiert (Showpad teilen, Showpad E-Mail, Shared Space usw.), was bei der Berichterstattung 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 weiter oben bereits 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 IP-Adresse der Nutzer 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 aufheben" zu ändern. 

Die   Einstellung "IP-Beschränkungen aufheben" ermöglicht es Benutzern, die verbundene Showpad-App ohne IP-Beschränkungen auszuführen. Sie können diese Einstellungen im Salesforce Administer-Abschnitt finden.

1. Suchen Sie unter „Einrichtung“ nach „Verbundene Apps“. Öffnen Sie die Optionen „OAuth-Verwendung für verbundene Apps“ in der Registerkarte „Apps verwalten“.
   
2. Suchen Sie die App „Showpad Salesforce Integration“ und klicken Sie dann auf „Installieren“.
3. Klicken Sie in der Liste "Verbinden der Apps OAuth Nutzungsliste" auf "App Richtlinien verwalten".
4. Klicken Sie auf „Richtlinien bearbeiten“. Klicken Sie auf das Drop-down-Menü „IP-Lockerung“ und ändern Sie dann „IP-Einschränkungen erzwingen“ in „IP-Einschrä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. Für eine vollständige Übersicht über unsere Anforderungen an den Browser:  Klicken  Sie bittehier.
Vergewissern Sie sich, dass in den Sicherheitseinstellungen die Option "Sonstiges" sowohl für das Internet, als auch für das Intranet aktiviert ist. Wenn dies nicht der Fall sein sollte, wird der Internet Explorer es der Showpad-Seite nicht gestatten, eine Verbindung mit der Salesforce-Domäne herzustellen. Die Kontakt- und Lead-Daten können dann nicht abgerufen werden.

1. Gehen Sie zu „Einstellungen“, „Internetoptionen“, „Sicherheit“.
2. Sie sollten dann ein Internet-Symbol sehen können. Stellen Sie bitte sicher, dass dieses ausgewählt ist. Wenn sie das lokale Intranet nutzen, sollten Sie auch dort die gleichen Änderungen vornehmen.
3. Wählen Sie „Benutzerdefiniert“.
4. Vergewissern Sie sich bitte, dass die Option "Zugriff auf Datenquellen über Domains hinweg" 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  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 einen gültigen Zugriffstoken. Der Zugriffstoken wird auf den Servern von Showpad eingeholt und nicht im Browser des Nutzers. Wenn die Salesforce-Einstellung "sperrt die Sitzung aufgrund der IP-Adresse" 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 diesen Zugriffstoken über eine andere IP-Adresse (Ihren Browser) verwenden, wird dieser auf Grund der Salesforce-Einstellung nicht funktionieren. Wenn Sie diese Einstellung deaktivieren, kann der Zugriffstoken auch im Browser verwendet werden. Sie können Salesforce-Anfragen in der Web-App stellen.
Beachten Sie bitte, dass die mobilen Apps nicht unsere Server verwenden, um einen neuen Zugangstoken anzufordern, sodass sie nicht auf dieses Problem stoßen werden.

Navigieren Sie zu den Sitzungseinstellungen und stellen Sie bitte sicher, dass das Kontrollkästchen "Sperren von Sitzungen für die IP-Adresse, von der sie stammen" nicht markiert ist.