Integrationen
Überblick
Integrationen sind die Anbindungen an fremde Systeme — die Stelle, an der die Zugangsdaten für externe Dienste liegen.
Sie unterscheiden sich von den API-Token in der Richtung: Ein Token lässt ein fremdes System zu uns herein, eine Integration lässt uns nach draußen. Beide Richtungen werden getrennt verwaltet, weil sie getrennt widerrufen werden müssen.
Kernaufgaben
Integration anlegen. Neue Integration verlangt einen Namen, einen Anbieter und die Konfiguration als Schlüssel/Wert-Paare.
Anbieter-Vorlage nutzen. Für bekannte Dienste — LinkedIn, Meta (Facebook/Instagram) und X — füllt eine Vorlage den Anbieter und die erwarteten Konfigurationsschlüssel vor. Das erspart das Nachschlagen, wie ein Schlüssel genau heißen muss. Der freie Weg ohne Vorlage bleibt für alles andere nutzbar.
Zugangsdaten hinterlegen. Token-Schlüssel wie access_token oder page_access_token werden verschlüsselt und nur schreibend gespeichert: Beim erneuten Laden erscheinen sie maskiert als ********. Sie können sie überschreiben, aber nicht auslesen — auch nicht als Administrator.
Aktiv schalten. Der Aktiv-Zustand entscheidet, ob die Anbindung verwendet wird. Die Liste zeigt Name, Anbieter, Status und Änderungsdatum.
Hinweise der Anbindungen beachten. Über der Liste melden sich Anbindungen, deren Einrichtung nicht mehr trägt — etwa Sendcloud, solange als Versandart noch eine Nummer der alten Schnittstelle eingetragen ist: damit entstehen keine Etiketten mehr. Der Hinweis nennt die Nummer und was stattdessen einzutragen ist; derselbe Hinweis steht nach einem System-Update im Protokoll. Genauso gemeldet werden Versandkosten-Regeln, die eine solche Nummer als Versandart vorschreiben (mit Kennung, Zone und Dienstleister — nachbessern unter Einstellungen → Versand, Feld Versandart), und Sendungen ohne Etikett mit einer solchen Nummer: deren Etikett-Nachkauf scheitert, sie sind zu stornieren und mit dem Code der Versandoption neu anzulegen. Ebenso OctiConnect-Abläufe, deren Versand-Baustein eine solche Nummer gespeichert hat — der Hinweis nennt den Ablauf und springt hinein.
Felder im Detail
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Anbieter provider | ja | verfügbarer Anbieter, max. 100 Zeichen | Womit verbunden wird. Der Anbieter bestimmt, welche Einstellungen darunter erscheinen und welche Anmeldung nötig ist. |
Name name | ja | Text, max. 255 Zeichen | Wie die Verbindung heißt. Bei mehreren Konten desselben Anbieters die einzige Unterscheidung — „Google Workspace Buchhaltung" statt „Google". |
Einstellungen config | nein | je nach Anbieter | Zugangsdaten, Schlüssel, Ziele. Geheimnisse werden verschlüsselt abgelegt und nie wieder angezeigt; erneutes Eintragen ersetzt sie. |
Marke brandId | nein | eine Ihrer Marken | Für welche Marke die Verbindung gilt. Je Marke ein eigenes Konto ist möglich und oft nötig. |
Aktiv active | nein | Ja/Nein | Ob die Verbindung genutzt wird. Aus hält sie an, ohne die Einrichtung zu verlieren — der erste Griff, wenn ein Anbieter Ärger macht. |
Läuft eine Anmeldung ab, ruht die Verbindung sichtbar und meldet sich, statt still nichts mehr zu tun. Das ist der Unterschied zwischen „seit drei Wochen kommt nichts an" und einer Meldung am ersten Tag.
Einstellungen & Rechte
- Kein eigenes Routen-Recht. Die Seite ist erreichbar; das Anlegen und Ändern prüft der Server.
- Zugangsdaten sind nicht wieder lesbar. Wer den Wert braucht, holt ihn beim Anbieter, nicht
hier.
- KI-Anbieter gehören nicht hierher. Deren Zugänge liegen unter
- Ein Anbieter kann mehrfach vorkommen — etwa je Marke oder je Konto.
FAQ & Fehlerbilder
Die Anbindung schlägt fehl, obwohl der Schlüssel stimmt. Prüfen Sie die Schlüsselnamen in der Konfiguration. Eine Anbieter-Vorlage benennt sie richtig; von Hand eingetragen schleichen sich hier Tippfehler ein, die nach außen wie ein falsches Passwort aussehen.
Ein Token ist abgelaufen. Erneuern Sie ihn beim Anbieter und tragen Sie den neuen Wert ein. Der alte lässt sich nicht einsehen — ein Vergleich ist also nicht möglich.
Ich sehe den hinterlegten Wert nicht mehr. So gewollt. Zugangsdaten werden verschlüsselt und maskiert dargestellt.
Wir wollen die Anbindung vorübergehend stoppen. Deaktivieren Sie sie, statt die Zugangsdaten zu löschen.