Skip to content
ONE LOOP / Documentation / Platform guides

The source documentation is currently available in German. No English translation is implied.

Platform guides

Integrationen verbinden und verwalten

Finde, verbinde und verwalte externe Dienste im Bereich Integrationen und prüfe Konten, Feldzuordnungen sowie Fehler zuverlässig.

Im Bereich Integrationen verbindest du externe Dienste mit deinem Standort und verwaltest vorhandene Verbindungen. Jede Integration erscheint als Karte. So erkennst du schnell, ob ein Dienst noch verbunden werden muss, bereits eingerichtet ist oder Aufmerksamkeit braucht.

Eine Integration kann Daten übernehmen, zum Beispiel Formularangaben aus einem externen Dienst. Verbinde und ändere sie deshalb bewusst: Eine falsche Feldzuordnung oder eine voreilige Trennung kann bestehende Abläufe unterbrechen.

Integrationskarten verstehen

Jede Karte enthält die wichtigsten Angaben auf einen Blick:

Bestandteil

Bedeutung

Was du damit machst

Name und Symbol

Kennzeichnet den externen Dienst.

Prüfe, dass du den richtigen Dienst auswählst.

Kurzbeschreibung

Erklärt kurz den Zweck der Verbindung.

Nutze sie zur Unterscheidung ähnlicher Dienste.

Hauptaktion

Zeigt Verbinden oder Verwalten.

Wähle die passende Aktion abhängig vom Verbindungszustand.

Drei-Punkte-Menü

Öffnet weitere, dienstspezifische Optionen.

Prüfe Hilfe, Feldzuordnung, Fehleranalyse oder Einstellungen.

Fehleranzeige

Kennzeichnet ein Problem an der Verbindung oder an einem Konto.

Öffne die Anzeige und prüfe zuerst, was genau betroffen ist.

Die Suche oben auf der Seite filtert Integrationen bereits während der Eingabe. Das spart Zeit, wenn mehrere Dienste vorhanden sind.

Verbinden oder verwalten: der Unterschied

  • Verbinden erscheint, wenn noch kein Konto mit diesem Dienst verknüpft ist. Die Aktion startet die Einrichtung einer neuen Verbindung.

  • Verwalten erscheint, wenn bereits mindestens ein Konto verbunden ist. Dort prüfst und änderst du die vorhandenen Konten und deren Einstellungen.

  1. Öffne Einstellungen → Integrationen.

  2. Suche nach dem gewünschten Dienst.

  3. Lies die Kurzbeschreibung auf der Karte.

  4. Wähle Verbinden, wenn noch kein Konto verknüpft ist.

  5. Folge den angezeigten Schritten des jeweiligen Dienstes.

  6. Wähle danach Verwalten, um die Verbindung zu kontrollieren.

Tipp: Wenn Verwalten statt Verbinden erscheint, lege nicht vorschnell eine zweite Verbindung an. Prüfe zuerst, ob das gewünschte Konto bereits vorhanden ist.

Mehrere Konten sicher verwalten

Das Verwaltungsfenster bündelt alle Konten einer Integration an einer Stelle. Je nach Dienst kannst du dort:

  • alle verbundenen Konten sehen;

  • ein Hauptkonto festlegen;

  • weitere Konten hinzufügen;

  • ein einzelnes Konto erneut verbinden;

  • Einstellungen eines einzelnen Kontos öffnen;

  • ein Konto entfernen;

  • Fehleranzeigen pro Konto prüfen.

Mehrere Konten sind nur sinnvoll, wenn dein tatsächlicher Ablauf sie benötigt. Markiere das Konto als Hauptkonto, das in deinem normalen Arbeitsablauf verwendet werden soll. So reduziert sich das Risiko, Daten versehentlich an die falsche Verbindung zu senden.

Formularfelder zuordnen

Eine Feldzuordnung legt fest, in welches Kontakt- oder CRM-Feld eine Angabe aus einem externen Formular geschrieben wird. Sie ist wichtig, damit Daten nicht nur ankommen, sondern auch am richtigen Platz stehen.

  1. Öffne die betreffende Integrationskarte.

  2. Wähle im Drei-Punkte-Menü die Feldzuordnung, falls diese für den Dienst verfügbar ist.

  3. Prüfe die Liste der verfügbaren Formulare.

  4. Aktiviere nur die Formulare, die wirklich Daten übertragen sollen.

  5. Wähle Felder bearbeiten.

  6. Ordne jedes benötigte Formularfeld dem passenden Ziel-Feld zu.

  7. Speichere die Zuordnung.

  8. Sende ein Testformular und prüfe den neuen oder aktualisierten Kontakt.

Beispiel: Ein externes Formular enthält Vorname, E-Mail-Adresse und Telefonnummer. Ordne diese Angaben jeweils dem passenden Kontaktfeld zu. Vertausche nicht Telefon und E-Mail – ein erfolgreicher Testeintrag ist erst vollständig, wenn alle Werte korrekt angekommen sind.

Fehler richtig einordnen

Fehleranzeigen können zwei Ebenen betreffen:

Fehlerart

Bedeutung

Sinnvolle erste Prüfung

Kontofehler

Ein bestimmtes verbundenes Konto hat ein Problem.

Öffne genau dieses Konto, prüfe Zugriffsrechte und verbinde es bei Bedarf erneut.

Integrationsfehler

Die gesamte Verbindung oder deren Einrichtung braucht Aufmerksamkeit.

Prüfe die Karte, die Fehlermeldung und die dienstspezifischen Hilfen.

Entferne keine funktionierende Verbindung nur, um eine Fehleranzeige schneller verschwinden zu lassen. Prüfe zuerst, welches Konto betroffen ist und ob bestehende Abläufe davon abhängen.

Verbindung bewusst trennen

Über das Drei-Punkte-Menü oder das Verwaltungsfenster kannst du – wenn der Dienst diese Möglichkeit anbietet – ein Konto oder die gesamte Verbindung trennen. Das System verlangt dabei eine Bestätigung.

Vor dem Trennen solltest du:

  1. alle betroffenen Formulare und Abläufe identifizieren;

  2. prüfen, ob ein anderes verbundenes Konto weiterarbeiten soll;

  3. wichtige Feldzuordnungen dokumentieren;

  4. erst danach die Verbindung entfernen;

  5. den betroffenen Ablauf anschließend testen.

Eine reine Überarbeitung der Integrationsoberfläche verändert vorhandene Verbindungen nicht automatisch. Trotzdem ist ein kurzer Test sinnvoll, wenn du eine Karte, ein Konto oder eine Zuordnung selbst änderst.

Ergebnis zuverlässig prüfen

  1. Kontrolliere die Integrationskarte: Zeigt sie Verwalten und keine Fehleranzeige?

  2. Öffne das richtige Konto im Verwaltungsfenster.

  3. Prüfe, ob das gewünschte Konto als Hauptkonto markiert ist, falls dein Dienst diese Auswahl anbietet.

  4. Sende über ein freigegebenes Testformular einen Testeintrag.

  5. Kontrolliere Kontakt und Feldwerte im Standort.

  6. Prüfe, ob der Eintrag dem erwarteten Formular und Konto zugeordnet ist.

  7. Halte intern fest, welche Formulare und Felder aktiv verbunden sind.

Typische Fehler und ihre Lösung

Ich sehe „Verwalten“, wollte aber eine Verbindung anlegen

Das bedeutet, dass bereits mindestens ein Konto verbunden ist. Öffne Verwalten und prüfe, ob du dieses Konto verwenden oder ein weiteres hinzufügen möchtest.

Daten kommen an, stehen aber im falschen Feld

Öffne die Feldzuordnung, wähle Felder bearbeiten und kontrolliere jedes Quell- und Ziel-Feld. Sende danach erneut einen Testeintrag.

Eine Fehleranzeige bleibt sichtbar

Prüfe, ob sie ein einzelnes Konto oder die gesamte Integration betrifft. Kontrolliere Zugriffsrechte und starte eine erneute Verbindung nur für das betroffene Konto.

Ich möchte eine Verbindung entfernen

Prüfe vorher, ob Formulare oder andere Abläufe von ihr abhängen. Trenne erst nach dieser Prüfung und bestätige die Aktion bewusst.

Praxisbeispiel

Ein Team verbindet einen externen Formulardienst. Zuerst aktiviert es nur ein Testformular und ordnet Vorname, E-Mail-Adresse sowie Telefonnummer den passenden Kontaktfeldern zu. Nach einem Testeintrag prüft das Team, dass alle Werte am richtigen Kontakt angekommen sind.

Erst danach aktiviert es weitere Formulare. Monate später erscheint eine Fehleranzeige bei einem einzigen Konto. Das Team öffnet genau dieses Konto, prüft die Verbindung und richtet sie erneut ein, ohne die übrigen funktionierenden Konten oder Feldzuordnungen zu verändern.

← Back to articles