Ein Helpdesk-Tool über die API anbinden
Wenn Familien immer wieder dasselbe fragen, etwa „Hat Alex einen Platz?“, kann ein Helpdesk-Tool die Antwort selbst in fepli nachschlagen. Dafür nutzt es die API, die Schnittstelle von fepli. Für das Team von Elmsbrück geben Sie dem Tool einen eigenen Zugang, der nur lesen darf und mit den Sommerferien endet. Das Tool antwortet nur Familien, bei denen feststeht, wer fragt. Ihr Teil dauert etwa 30 Minuten. Das Tool selbst richtet die IT oder der Anbieter ein.
Was Sie brauchen
- Ein Konto mit der Kontoart Admin und der Rolle Super-Admin. Nur Super-Admins legen Zugänge für Programme an.
- Ein Helpdesk-Tool oder einen Support-Agenten mit künstlicher Intelligenz, der eine API abfragen kann.
- Die Person, die das Tool einrichtet: die IT der Kommune oder den Anbieter des Tools.
- Einen Auftragsverarbeitungsvertrag mit dem Anbieter des Tools. Nutzt das Tool ein Sprachmodell, also eine KI, die Texte schreibt, brauchen Sie auch einen mit dessen Anbieter.
- Eine geprüfte Rechtsgrundlage für jede Übermittlung in ein Drittland, z. B. wenn das Sprachmodell außerhalb der Europäischen Union läuft.
- Eine Datenschutz-Folgenabschätzung, abgestimmt mit der Stelle für Datenschutz Ihrer Verwaltung.
- Einen Hinweis an die Familien, dass das Tool ihre Fragen mit Daten aus fepli beantwortet, z. B. in Ihrer Datenschutzerklärung.
- Einen sicheren Weg, Passwörter weiterzugeben, z. B. den Passwort-Manager Ihrer Verwaltung.
- Ein Teilnahmekonto zum Testen mit einer E-Mail-Adresse, deren Postfach Sie lesen, z. B.
helpdesk-test@example.org. Darin steht die Teilnehmer:in Alex Beispiel mit einer Anmeldung zur Kanutour. - Eine eingeschaltete Schnittstelle. Die App API ist ab Werk eingeschaltet: App-Store.
Schritt 1 – Einen Zugang für das Tool anlegen
Das Tool braucht einen eigenen Zugang, einen Service-Account. Er gehört keiner Person und bleibt bestehen, wenn jemand das Team verlässt; im Verlauf steht sein Name. Ein persönlicher Schlüssel hätte dagegen alle Ihre Rollen und würde mit Ihrem Konto gelöscht.
- Öffnen Sie Einstellungen.
- Wechseln Sie zu Integrationen.
- Wählen Sie Neuer Service-Account.
- Geben Sie als Name
Helpdeskein. - Geben Sie unter Beschreibung ein, wofür der Zugang da ist und wer für ihn verantwortlich ist, z. B.
Helpdesk-Tool für Fragen von Familien. Verantwortlich: Kim Beispiel.
Das Formular zeigt Name und Beschreibung. Unter Zugriff und Rollen stehen noch die Vorgaben von fepli.
Schritt 2 – Zugriff und Rollen festlegen
Mit Nur lesen ändert das Tool nichts, auch wenn eine Familie darum bittet. Um Konten und Anmeldungen zu finden, braucht es die Rolle Admin. Mit Teilnehmer:innen erkennt es, wer zu einem Konto gehört; jede weitere Rolle gäbe ihm Zugriff auf mehr Daten.
Achtung
Mit diesen Rollen liest das Tool Namen, Anschriften und Kontaktdaten von Familien und Teilnehmer:innen. Geben Sie den Schlüssel aus Schritt 3 erst weiter, wenn Auftragsverarbeitungsvertrag und Datenschutz-Folgenabschätzung vorliegen.
- Wählen Sie unter Zugriff Nur lesen.
- Aktivieren Sie unter Rollen Teilnehmer:innen. Admin bleibt aktiviert, die übrigen Rollen bleiben deaktiviert.
- Bestätigen Sie mit Speichern.
Die Seite des Zugangs öffnet sich mit der Meldung „Der Service-Account ist angelegt. Erstellen Sie jetzt einen Token dafür.“ Neben dem Namen Helpdesk steht Nur lesen.
Schritt 3 – Einen Schlüssel erstellen
Das Tool meldet sich mit einem Schlüssel an, den fepli API-Token nennt. Er ist eine lange Zeichenfolge und wirkt wie ein Passwort. Weil das Tool nur in den Sommerferien hilft, soll der Schlüssel am letzten Ferientag von selbst ablaufen.
- Geben Sie im Abschnitt Neuer API-Token unter Bezeichnung
Helpdesk-Toolein. - Geben Sie unter Gültig bis
31.08.2027ein. Unter Zugriff steht nur Nur lesen zur Auswahl, weil der Zugang nur lesen darf. - Bestätigen Sie mit Neuer API-Token.
Der Kasten Ihr neuer API-Token zeigt den Schlüssel. Er beginnt mit svc-. Darunter steht unter So wird er verwendet ein Befehl zum Testen.
Schritt 4 – Den Schlüssel sicher weitergeben
fepli zeigt den Schlüssel nur dieses eine Mal. Wer ihn hat, kann alle Konten, Anmeldungen und Teilnehmer:innen lesen. Geben Sie ihn deshalb weiter wie ein Passwort.
- Kopieren Sie den Schlüssel aus dem Kasten Ihr neuer API-Token.
- Kopieren Sie den Befehl unter So wird er verwendet. Er enthält die Adresse der API.
- Übergeben Sie beides über den Passwort-Manager an die Person, die das Tool einrichtet.
Sobald Sie die Seite verlassen, zeigt fepli den Schlüssel nicht mehr an. In der Liste Tokens steht er gekürzt, mit „Gültig bis {Datum}“ und dem Vermerk Noch nie verwendet.
Schritt 5 – Festlegen und prüfen, wem das Tool antwortet
Das Tool liest die Daten aller Familien, aber einen Namen kann jeder nennen. Es antwortet deshalb nur, wenn feststeht, wer fragt: Die Familie ist im Tool angemeldet, oder sie schreibt von einer bestätigten Adresse ihres Kontos. Zwei Testfragen zeigen, dass Schlüssel, Rollen und diese Regel zusammenpassen.
- Bitten Sie die Person, die das Tool einrichtet, den Befehl aus So wird er verwendet auszuführen und danach der Anleitung Support-Agenten zu folgen.
- Vereinbaren Sie mit ihr, dass das Tool nur Auskunft zu dem Konto gibt, mit dem die Familie angemeldet ist oder von dessen bestätigter Adresse sie schreibt. Nennt jemand nur einen Namen, antwortet das Tool nicht.
- Fragen Sie das Tool per E-Mail von
helpdesk-test@example.org, ob Alex Beispiel einen Platz in der Kanutour hat. - Vergleichen Sie die Antwort mit der Teilnahmeliste der
Kanutour. - Stellen Sie dieselbe Frage von Ihrer eigenen E-Mail-Adresse. Sie gehört nicht zum Konto von Alex Beispiel.
- Öffnen Sie Einstellungen und wechseln Sie zu Integrationen.
- Wählen Sie in der Zeile
HelpdeskÖffnen.
In der Zeile des Schlüssels steht jetzt „Zuletzt verwendet {Datum}“. Die Antwort an das Testkonto stimmt mit der Teilnahmeliste überein, und auf die Frage von Ihrer eigenen Adresse nennt das Tool keine Daten zu Alex Beispiel.
Schritt 6 – Den Zugang beenden, wenn das Tool wegfällt
Der Schlüssel läuft am 31.08.2027 von selbst ab. Widerrufen Sie ihn früher, wenn Elmsbrück das Tool abschaltet. Dasselbe gilt, wenn der Schlüssel in falsche Hände geraten sein könnte.
- Öffnen Sie die Seite des Zugangs
Helpdeskwie in Schritt 5. - Wählen Sie in der Zeile des Schlüssels
Helpdesk-ToolWiderrufen. - Bestätigen Sie die Rückfrage „Integrationen, die den Token verwenden, verlieren sofort den Zugriff.“
Die Meldung „Der Token wurde widerrufen.“ erscheint, und der Schlüssel steht nicht mehr in der Liste. fepli weist jede weitere Anfrage mit diesem Schlüssel ab.
Was Sie erreicht haben
Das Helpdesk-Tool von Elmsbrück schlägt Anmeldungen und Teilnehmer:innen über einen eigenen Zugang nach und kann nichts ändern. Es antwortet nur Familien, bei denen feststeht, wer fragt, und nur zu ihrem eigenen Konto. Der Zugang gehört keiner Person im Team und endet mit den Sommerferien von selbst.
Wenn Ihr Fall anders aussieht
- Wenn Sie selbst ein kleines Programm schreiben, z. B. für eine Auswertung, genügt ein persönlicher Schlüssel unter Sicherheit > API-Tokens: Sicherheit: API-Tokens.
- Wenn das Tool auch Fragen zu Belegen und offenen Beträgen beantworten soll, aktivieren Sie zusätzlich die Rolle Zahlungen: Rollen und Rechte.
- Wenn Elmsbrück das Tool nach den Sommerferien weiter nutzt, erstellen Sie vor dem 31.08.2027 einen neuen Schlüssel mit einem späteren Datum unter Gültig bis.
- Wenn das Tool eine Zeit lang ruhen soll, wählen Sie auf der Seite des Zugangs Deaktivieren. fepli weist seine Schlüssel dann ab, bis Sie Aktivieren wählen: Service-Accounts.
- Wenn das Tool auch Notizen für das Team schreiben oder nach Ihrer Entscheidung Anmeldungen abmelden soll, braucht es einen Zugang mit Lesen und schreiben: Support-Agenten.
- Wenn Elmsbrück noch keinen Super-Admin hat, legt der Betrieb von fepli den Zugang mit einem Befehl auf dem Server an: Service-Accounts in den fepli developers.