Die Beekeeper-Integration in Innform ermöglicht es dir, Benutzer zwischen Beekeeper und Innform zu synchronisieren (hinzufügen/entfernen). Mit dieser Integration kannst du auch Web-Hooks verwenden, um Aktionen zu automatisieren, wenn Benutzer in Beekeeper erstellt, aktualisiert oder gelöscht werden. Befolge die folgenden Schritte, um dein Beekeeper-Konto zu verbinden und den Synchronisierungsprozess zu verwalten.
Voraussetzungen
Bevor du beginnst, stelle sicher, dass du Folgendes hast:
Ein Innform-Administratorkonto mit Zugriff auf Kontoeinstellungen.
Deine Beekeeper-API-URL.
Dein Beekeeper-Bot-Account-Token.
Schritt 1: Zugriff auf die Beekeeper-Integrationseinstellungen
Melde dich bei Innform an.
Navigiere zum Seitenmenü und wähle Kontoeinstellungen aus.
Klicke im Einstellungsmenü auf Integrationen.
Suche und wähle die Beekeeper-Integration aus der Liste aus.
Schritt 2: Beekeeper-Konto verbinden
Klicke auf der Beekeeper-Integrationsseite auf die Schaltfläche „Beekeeper-Konto verbinden“.
Es erscheint ein Formular, in dem du nach deiner Beekeeper-API-URL und deinem Bot-Konto-Token gefragt wirst.
Beekeeper-API-URL: Gib die von Beekeeper bereitgestellte URL ein (https://<your_subdomain>.beekeeper.io/api/2/).
Bot-Konto-Token: Gib das mit deinem Beekeeper-Bot-Konto verknüpfte Token ein.
Sobald beide Felder ausgefüllt sind, klicke auf „Beekeeper-Konto verbinden“, um die Verbindung herzustellen.
Hinweis: Zu diesem Zeitpunkt ist die Verbindung erfolgreich, aber die Benutzer werden nicht automatisch synchronisiert.
Schritt 3: Konfigurieren der Web-Hook-Optionen
Nach dem Verbinden deines Beekeeper-Kontos kannst du Web-Hook-Optionen aktivieren, um den Synchronisierungsprozess zu automatisieren. Die verfügbaren Web-Hook-Ereignisse sind:
USER.CREATED: Wird ausgelöst, wenn ein neuer Benutzer in Beekeeper erstellt wird.
USER.UPDATED: Wird ausgelöst, wenn bestimmte Benutzerfelder aktualisiert werden.
USER.DELETED: Wird ausgelöst, wenn ein Benutzer gelöscht wird.
So aktivierst du diese Optionen
Auf derselben Seite mit den Integrationseinstellungen den Abschnitt „Web Hook-Optionen“ suchen.
Die Web Hook-Optionen, die du aktivieren möchtest, je nach Bedarf umschalten oder auswählen.
Änderungen speichern
Schritt 4: Nutzer mit einem benutzerdefinierten Beekeeper-Feld filtern (optional)
Wenn du nur bestimmte Beekeeper-Nutzer mit Innform synchronisieren möchtest, kannst du ein benutzerdefiniertes Profilfeld verwenden, um zu steuern, wer hinzugefügt wird. Nutzer ohne dieses Feld mit dem Wert YES werden beim Sync ignoriert, auch wenn sie in Beekeeper vorhanden sind.
4a — Benutzerdefiniertes Profilfeld in Beekeeper erstellen
Gehe in deinem Beekeeper-Admin-Dashboard zu Einstellungen → Profilfelder.
Füge ein neues Profilfeld mit folgenden Details hinzu:
Feldname:
Add to InnformFeldschlüssel:
add_to_innform
Speichere das Feld.
4b — Whitelist-Key in Innform konfigurieren
Gehe in Innform zu den Beekeeper-Integrationseinstellungen und suche das Feld Whitelist Key.
Gib
add_to_innformals Whitelist-Key ein.Speichere deine Einstellungen.
4c — Nutzer in Beekeeper markieren
Öffne für jeden Nutzer, der mit Innform synchronisiert werden soll, dessen Profil in Beekeeper.
Suche das Feld Add to Innform und setze den Wert auf
YES.Nur Nutzer mit diesem Feld auf
YESwerden beim Sync zu Innform hinzugefügt.
Hinweis: Nutzer ohne das Feld add_to_innform mit dem Wert YES werden beim Sync ignoriert, auch wenn sie in Beekeeper vorhanden sind.
Schritt 5: Synchronisierung von Benutzern und Gruppen
Sobald dein Beekeeper-Konto verbunden und deine Web-Hook-Optionen eingerichtet sind, hast du die volle Kontrolle über den ersten Synchronisierungsprozess.
Manuelle Synchronisierung:
Um die Benutzer manuell zu synchronisieren, klicke auf die Schaltfläche „Benutzer synchronisieren“.
Benutzer und Gruppen synchronisieren (falls zutreffend):
Wenn du auch Beekeeper-Gruppen verwendest, klicke auf „Benutzer und Gruppen synchronisieren“, um sicherzustellen, dass sowohl Benutzer als auch die ihnen zugeordneten Gruppen synchronisiert werden.
Wichtig: Bei der ersten Verbindung werden deine Benutzerdaten nicht automatisch synchronisiert. Die Synchronisierung wird nur ausgelöst, wenn du den Synchronisierungsprozess manuell startest.
Final Notes
Kontrolle: Du hast die volle Kontrolle darüber, wann die Synchronisierung stattfindet. So kannst du die Integrationseinstellungen und -daten überprüfen, bevor die eigentliche Synchronisierung stattfindet.
Automation: Wenn Web-Hooks aktiviert sind, kann deine Integration Innform automatisch aktualisieren, wenn Änderungen in Beekeeper auftreten, sodass dein System immer auf dem neuesten Stand bleibt.
Fehlerbehebung: Wenn während der Integration Probleme auftreten, überprüfe, ob die API-URL und das Bot-Account-Token korrekt eingegeben wurden. Weitere Unterstützung findest du in unserer Support-Dokumentation oder wende dich an unseren Helpdesk.