Eine Verbindung einrichten

Kurz gesagt: Jede Verbindung mit einem eurer Systeme, zum Beispiel einem Webshop, Lagersystem, Aktensystem oder Planungssystem, richtest du unter Organisation > Plugins ein. Du klickst auf die Karte der Verbindung, legst fest, für wen die Verbindung gilt, trägst die Daten eures Systems ein (oder meldest dich bei diesem System an) und speicherst. Danach verwaltest du jede Verbindung unter Verbundene Konten.

Wo du das findest

Gehe zu Organisation > Plugins. Klicke auf die Karte der Verbindung, die du einrichten willst. Du kommst auf die Seite dieser Verbindung, mit dem Namen als Titel, der aktiven Version darunter, dem Symbol und der Erklärung, die zur Verbindung gehört. Mit Zurück gehst du zur Übersicht.

Wer: ab der Rolle Organisationsadministrator. Eine Verbindung gilt standardmäßig für die Organisation, in der du sie anlegst. In einem Konto mit mehreren Organisationen kann ein Kontoadministrator eine Verbindung mit dem gesamten Konto teilen.

Welche Verbindungen verfügbar sind, unterscheidet sich pro Konto. Ist die Verbindung, die du suchst, nicht dabei? Wende dich dafür an das aishaa-Team über den aishaa-Support-Chat in aishaa (Menü Chat, Unterhaltung aishaa support) oder per E-Mail an support@aishaa.nl.

Das Verbindungsformular

Gibt es noch keine Verbindung, steht das Formular {Name} verbinden direkt auf der Seite, mit der Erklärung Geben Sie die Daten des Anbieterkontos ein und testen Sie die Verbindung, bevor Sie speichern. Gibt es schon eine Verbindung, klicke zuerst rechts über dem Block Verbundene Konten auf Weitere Verbindung mit {Name}.

Du brauchst die Daten des Systems selbst: eine Adresse, einen API-Schlüssel, ein Token oder eine Anmeldung, je nachdem, was das System verlangt. Diese Daten holst du aus dem System selbst oder fragst sie beim Anbieter davon ab. aishaa kann sie nicht für dich nachschlagen.

1. Wähle bei Verfügbar für, ob die Verbindung für Nur diese Organisation oder für Alle Organisationen des Kontos gilt. Diese Wahl siehst du nur in einem Konto mit mehreren Organisationen, wenn du Kontoadministrator bist und wenn die Verbindung die Wahl freilässt. Steht fest, dass die Verbindung immer für das gesamte Konto gilt, steht dort stattdessen Dieses Plugin wird für das gesamte Konto verbunden: Die Verbindung ist in jeder Organisation verfügbar.
2. Wähle bei Verbindungsmethode, wie aishaa mit eurem System verbindet. Diese Auswahlliste steht nur da, wenn die Verbindung mehr als eine Methode anbietet. Unter der Auswahlliste steht, wo nötig, eine kurze Erklärung der gewählten Methode.
3. Trage bei Name einen erkennbaren Namen für diese Verbindung ein, zum Beispiel den Namen des Kontos in eurem System. Dieses Feld ist ein Pflichtfeld.
4. Fülle die Felder aus, die die Verbindung selbst verlangt.
5. Schließe mit Verbindung testen und Speichern ab, oder mit Mit {Name} verbinden. Welche Schaltflächen du siehst, hängt von der Verbindungsmethode ab.

Das Verbindungsformular auf einer Plugin-Seite (Menü Organisation > Plugins, Karte anklicken) mit Verfügbar für, Verbindungsmethode, dem Feld Name, den Feldern der Verbindung selbst und den Schaltflächen Verbindung testen und Speichern.

Die Felder unterscheiden sich pro Verbindung

Nach Name folgen die Felder, die die Verbindung selbst angibt. Jede Verbindung bestimmt ihre eigenen Felder, Bezeichnungen, Erklärungen und welche Felder Pflichtfelder sind. Es gibt also keine festen Felder in aishaa: Bei der einen Verbindung trägst du eine Adresse und einen API-Schlüssel ein, bei der anderen eine Kundennummer, ein Token und einen Schalter.

Was dir aber immer begegnet:

Unter einem Feld steht die Erklärung, die zu diesem Feld gehört, wenn die Verbindung sie mitgibt. Weißt du nicht, welcher Wert irgendwo hingehört, schlage ihn in eurem System nach oder frage den Anbieter dieses Systems.

Verbindungsmethoden

Verbindung testen und Speichern

Bei Manuell mit Schlüsseln schließt du so ab:

1. Klicke auf Verbindung testen. Funktioniert die Verbindung, siehst du Die Verbindung funktioniert!. Klappt es nicht, siehst du Verbindung fehlgeschlagen: mit dem Grund dahinter.
2. Klicke auf Speichern. Die Verbindung erscheint danach unter Verbundene Konten.

Bei einer Fehlermeldung steht manchmal Referenz: mit einem Code. Nenne diesen Code, wenn du das aishaa-Team kontaktierst; damit ist das Problem schneller zu finden.

Mit Abbrechen schließt du das Formular ohne zu speichern. Diese Schaltfläche steht nur da, wenn es schon eine Verbindung gibt.

Bei eurem System anmelden

Bei den Verbindungsmethoden Mit Ihrem Konto anmelden und Freigabe durch Administrator steht nur eine Schaltfläche: Mit {Name} verbinden. Du wirst zu eurem System geschickt, um dich anzumelden oder die Erlaubnis zu geben, und kommst danach mit einer Meldung in aishaa zurück.

Verbundene Konten verwalten

Jede Verbindung steht als Karte unter Verbundene Konten, mit dem Namen, den du gegeben hast, und dem Chip Verbunden.

• Verwalten klappt die Details auf. Du siehst dort die Version, mit der die Verbindung arbeitet.
• Im Menü mit den drei Punkten neben der Verbindung steht Trennen, und in einem Konto mit mehreren Organisationen auch Mit dem gesamten Konto teilen oder Auf diese Organisation beschränken.
• In einem Konto mit mehreren Organisationen steht auf der Karte der Chip Kontoweit oder der Name der Organisation, für die die Verbindung gilt.
• Unter der Karte stehen die Einstellungen der Verbindung: Kundendaten, und wenn die Verbindung das anbietet, auch Kataloge und Aktionen. Siehe Plugin-Einstellungen: Kundendaten, Kataloge und Aktionen.

Eine Karte unter Verbundene Konten auf der Plugin-Seite mit dem Namen der Verbindung, dem Chip Verbunden, der Schaltfläche Verwalten und dem Menü mit Mit dem gesamten Konto teilen und Trennen.

Eine weitere Verbindung hinzufügen

Du kannst dieselbe Verbindung mehrmals einrichten, zum Beispiel für ein zweites Konto in eurem System oder pro Marke ein eigenes Konto. Klicke rechts über dem Block Verbundene Konten auf Weitere Verbindung mit {Name} und fülle das Formular erneut aus. Gib jeder Verbindung einen eigenen Namen, damit du sie später unterscheidest. Dasselbe Konto eures Systems kannst du nicht zweimal verbinden: Du siehst dann Dieses Anbieterkonto ist bereits als {Name} verbunden.

Mit dem gesamten Konto teilen

In einem Konto mit mehreren Organisationen kann ein Kontoadministrator eine Verbindung mit allen Organisationen teilen. Wähle im Menü der Verbindung Mit dem gesamten Konto teilen. Die Verbindung bekommt dann den Chip Kontoweit und ist in jeder Organisation des Kontos verfügbar. Mit Auf diese Organisation beschränken machst du das wieder rückgängig. Nach der Änderung siehst du Die Verfügbarkeit der Verbindung wurde aktualisiert.

Eine Verbindung, die mit dem gesamten Konto geteilt ist, ist für alle außer einem Kontoadministrator nur lesbar. Unter dem Namen steht dann Für das gesamte Konto geteilt, mit dem Hinweis, dass nur Kontoadministratoren das ändern können. Die Auswahllisten bei Kundendaten, Kataloge und Aktionen sind dann nicht änderbar, und das Menü mit Trennen fehlt.

Teilen klappt nicht, wenn eine andere Organisation schon eine eigene Verbindung mit demselben Konto eures Systems hat. Du siehst dann Die Verbindung kann nicht geteilt werden: {Organisation} hat noch eine eigene Verbindung mit demselben Anbieterkonto. Trennen Sie sie dort zuerst.

Bei einigen Verbindungen liegt die Verfügbarkeit fest. Dann siehst du Die Verfügbarkeit der Verbindungen dieses Plugins ist festgelegt und kann nicht geändert werden. Versucht ein Organisationsadministrator, eine geteilte Verbindung zu ändern, erscheint Nur Kontoadministratoren können Verbindungen verwalten, die mit dem gesamten Konto geteilt sind.

Erneute Verbindung erforderlich

Bei einer Verbindung über Mit Ihrem Konto anmelden oder Freigabe durch Administrator kann die Erlaubnis in eurem System ablaufen oder zurückgezogen werden. Die Verbindung bekommt dann den Chip Erneute Verbindung erforderlich und daneben die Schaltfläche Erneut verbinden. Klicke auf diese Schaltfläche und melde dich erneut bei eurem System an. Bis dahin kann aishaa keine Daten aus diesem System abrufen.

Bei einer Verbindung, die mit dem gesamten Konto geteilt ist, kann nur ein Kontoadministrator erneut verbinden.

Trennen

Wähle im Menü der Verbindung Trennen. Die Verbindung verschwindet aus der Liste und du siehst Das Plugin wurde getrennt und die Daten wurden entfernt.

Ist die Verbindung mit dem gesamten Konto geteilt, bittet aishaa zuerst um eine Bestätigung mit dem Dialog Für das gesamte Konto trennen? und dem Hinweis, dass die Verbindung von allen Organisationen des Kontos verwendet wird und danach in keiner Organisation mehr funktioniert. Klicke auf Trennen, um fortzufahren, oder auf Abbrechen.

Nach dem Trennen siehst du keine Datensätze aus diesem System mehr an Tickets, und aishaa kann die Daten und Aktionen dieses Systems nicht mehr verwenden.

Gut zu wissen

• Die Felder, die du ausfüllst, sind die Daten eures Systems, nicht die von aishaa. Welche du brauchst, steht in eurem System oder beim Anbieter davon.
• Schlüssel und Passwörter werden nach dem Speichern nicht mehr angezeigt und sind nicht änderbar. Ändert sich ein Schlüssel in eurem System, trenne die Verbindung und lege sie mit den neuen Daten erneut an.
• Eine Verbindung, die du anlegst, gilt nur für die Organisation, in der du sie anlegst, es sei denn, sie ist mit dem gesamten Konto geteilt.
• Welche Felder, Kataloge und Aktionen eine Verbindung anbietet, liegt pro Verbindung fest. Du kannst das in aishaa nicht selbst anpassen.
• Du kannst selbst keine Verbindungen bauen, hochladen oder in aishaa installieren. Möchtest du eine Verbindung mit einem System, das es noch nicht gibt? Wende dich dafür an das aishaa-Team über den aishaa-Support-Chat in aishaa (Menü Chat, Unterhaltung aishaa support) oder per E-Mail an support@aishaa.nl.

Verwandte Artikel

• Plugins: Übersicht der Verbindungen
• Plugin-Einstellungen: Kundendaten, Kataloge und Aktionen
• Kataloge einer Verbindung
• Datensätze aus verbundenen Systemen am Ticket
• Fähigkeiten und Aktionen eines KI-Agenten
• Mit mehreren Organisationen arbeiten