Zusammenfassung: Diese Anleitung richtet sich an Administratoren und Personalmanager, die Speakap mit Awardco verbinden möchten. Die Integration zeigt Mitarbeiteranerkennungen in einem Widget im Feed an. Wir behandeln die erforderliche Vorbereitung der Benutzersynchronisation, die Installationsschritte und wie man häufige Einrichtungsfehler behebt.
Über die Integration
Die Awardco-Integration zeigt automatisch Mitarbeiteranerkennungen, sowohl erhaltene als auch gegebene, in einem eigenen Widget im Feed an. Speakap verknüpft das Profil eines Nutzers basierend auf dessen einzigartiger Externer ID (XID), die oft die Mitarbeiter-ID ist, mit dessen Awardco-Konto.
Vor der Installation: XID in der Benutzersynchronisation angleichen
Bevor Sie die App installieren, muss Ihr IT- oder HR-Systemadministrator einen wichtigen Zuordnungsschritt in Ihrer Benutzersynchronisation abschließen:
- Abgleich der eindeutigen ID: Die eindeutige Mitarbeiter-ID, die Ihr HR-System an Speakap sendet, muss identisch mit der ID sein, die für denselben Mitarbeiter in Awardco verwendet wird.
- Die Rolle der XID: Speakap verwendet diese gemeinsame eindeutige ID als die XID des Nutzers.
Wichtig: Wenn die Speakap XID eines Nutzers und dessen Awardco-Mitarbeiter-ID nicht exakt übereinstimmen, führt die Integration zu Zuordnungsfehlern. Nutzer könnten dann die Anerkennungsdaten einer anderen Person in ihrem Feed-Widget sehen.
Schritt-für-Schritt-Installation
- Öffnen Sie den Speakap Market: Melden Sie sich mit einem Administrator-Konto in Ihrem Netzwerk an, öffnen Sie den Speakap Market und wählen Sie die Awardco-Anwendung aus.
- Fügen Sie die App hinzu: Klicken Sie auf die Schaltfläche, um die Anwendung zu Ihrem Netzwerk hinzuzufügen.
- Wählen Sie Ihre Zielgruppe: Wählen Sie die Zielgruppe oder Gruppen aus, die Zugriff auf diese Integration haben sollen. Nach Bestätigung der Zielgruppe wird die Anwendung installiert.
- Öffnen Sie die Konfigurationseinstellungen: Finden Sie Awardco in Ihrer Liste der installierten Anwendungen und klicken Sie auf das Zahnradsymbol, um die Einrichtung abzuschließen.
- Geben Sie Ihre Zugangsdaten ein: Der Konfigurationsbildschirm fragt nach Ihrem Awardco API-Schlüssel und Ihrer einzigartigen Awardco-URL.
- Hinweis: Der Awardco-Administrator Ihres Unternehmens findet diese Zugangsdaten im Dashboard seines Awardco-Kontos.
- Fertig: Wenn die Zugangsdaten gültig sind, erscheinen Mitarbeiteranerkennungen automatisch im Widget im Feed.
Fehlerbehebung
Wenn das Widget keine Anerkennungsdaten anzeigt, klicken Sie auf das Zahnradsymbol der App-Konfiguration und prüfen Sie diese drei häufigen Fehler:
- Fehlender API-Schlüssel: Das Schlüsselfeld ist leer. Geben Sie Ihren gültigen API-Schlüssel im Konfigurationsbildschirm der Anwendung ein.
- Fehlende Awardco-URL: Stellen Sie sicher, dass die genaue Webadresse Ihrer Awardco-Umgebung in den Einstellungen eingetragen und gespeichert ist.
- XID nicht konfiguriert: Die Integration kann die Zuordnung des Nutzers nicht finden. Überprüfen Sie Ihre Benutzersynchronisation, um sicherzustellen, dass für alle Konten passende XID-Werte eingetragen werden.
Immer noch Probleme?
Schreiben Sie uns eine E-Mail an technicalimplementations@speakap.nl mit dem Namen Ihres Netzwerks, dem Fehler, den Sie in der App-Konfiguration sehen, und einem Screenshot, und wir helfen Ihnen gerne weiter.