Connector

Der Connector verbindet Octoserv mit der Schnittstelle eines anderen Systems, zum Beispiel einem anderen CRM. Kontakte, Firmen und Deals gehen in beide Richtungen: Octoserv liest Datensätze aus dem anderen System, sendet eigene dorthin und nimmt Änderungen entgegen, sobald das andere System sie meldet. Angebote gehen nach außen. Jede Änderung steht im Journal des Datensatzes und trägt als Herkunft den Namen der Verbindung. Sie richten alles in der Oberfläche ein, ohne Programmierung.

Typische Fälle: ein anderes CRM parallel weiterführen, Leads aus einem Drittsystem übernehmen, Stammdaten zwischen zwei Systemen abgleichen.

Voraussetzungen und Rechte

Seite Connector mit zwei Verbindungen: eine eingeschaltet mit letztem Lauf, eine pausiert, und dem Knopf Neue Verbindung
Die Seite Connector listet alle Verbindungen mit Zustand und letztem Lauf

Verbindung anlegen

  1. Öffnen Sie Funktionen › Connector und klicken Sie auf Neue Verbindung.
  2. Wählen Sie eine Vorlage für ein bekanntes System (zum Beispiel HubSpot, Pipedrive, Salesforce, Zoho und weitere) oder tragen Sie alles selbst ein. Eine Vorlage bringt die Art der Anmeldung, die Pfade und eine Zuordnung der Felder mit.
  3. Geben Sie einen Namen ein.
  4. Tragen Sie die Adresse der Schnittstelle ein. Sie muss eine https-Adresse im Internet sein; Adressen im eigenen Netz und Adressen mit Zugangsdaten werden abgelehnt. Bei einer Vorlage ersetzen Sie den Platzhalter (Ihr Konto oder Ihre Instanz) durch den eigenen Namen.
  5. Klicken Sie auf Verbindung anlegen.

Die Verbindung startet angehalten. Sie führt nichts aus, bis Sie sie einschalten.

Fenster Neue Verbindung mit Vorlage Pipedrive, Name und Adresse der Schnittstelle
Neue Verbindung aus einer Vorlage

Verbindung und Schlüssel

Karte Verbindung mit Name, Adresse, Authentifizierung Bearer-Token, Zugangsschlüssel, Weiteren Headern, Haken Eingeschaltet und den Knöpfen Speichern, Verbindung testen, Schlüssel entfernen und Verbindung löschen
Name, Adresse, Anmeldung und Schlüssel einer Verbindung

Anmeldung mit OAuth 2.0 (Ihre eigene App)

Viele Systeme erlauben keinen festen Schlüssel, sondern nur eine Anmeldung über OAuth 2.0. Dafür legen Sie beim anderen System eine eigene App an. Octoserv bringt keine App mit, die für alle gilt: Der Zugang bleibt bei Ihnen.

  1. Wählen Sie bei der Verbindung unter Authentifizierung den Eintrag Anmeldung mit OAuth 2.0.
  2. Legen Sie beim anderen System eine App an. Tragen Sie dort die Rücksprungadresse ein, die Octoserv im Feld darunter anzeigt. Das ist einmalig.
  3. Tragen Sie in Octoserv ein: die Client-ID, das Client-Secret (es kommt in den Tresor, wie jeder Schlüssel), die Adresse der Anmeldung, die Adresse des Tokens und den Scope.
  4. Speichern Sie und klicken Sie auf Anmelden. Sie gehen zum anderen System, stimmen zu und kommen zu Octoserv zurück.
Karte Verbindung mit der Authentifizierung Anmeldung mit OAuth 2.0, den Feldern Client-ID, Client-Secret, Adresse der Anmeldung, Adresse des Tokens, Scope und der Rücksprungadresse, darunter der Knopf Anmelden
OAuth 2.0 mit eigener App: Zugangsdaten eintragen, dann Anmelden

Zuordnung der Felder

Je Objektart (Kontakte, Firmen) legen Sie fest, aus welchem Pfad gelesen und an welchen gesendet wird und welches Feld in Octoserv zu welchem Feld im anderen System gehört.

  1. Öffnen Sie die Karte Zuordnung und wählen Sie den Reiter Kontakte oder Firmen.
  2. Tragen Sie Lesen von (Pfad) ein, unterhalb der Adresse der Schnittstelle, zum Beispiel contacts, und Senden an (Pfad). Ein neuer Datensatz wird dort mit POST angelegt, ein verknüpfter unter Pfad und Kennung aktualisiert.
  3. Mit Felder des anderen Systems laden bekommen Sie dessen Feldnamen zur Auswahl.
  4. Klicken Sie auf Zeile hinzufügen: links Feld hier, mitte Feld dort (ein Punkt baut verschachtelte Felder, zum Beispiel properties.email), dann optional ein Fester Wert, der das Feld im anderen System ersetzt.
  5. Wählen Sie die Richtung je Zeile: in beide Richtungen, nur hinein oder nur hinaus.
  6. Klicken Sie auf Zuordnung speichern.

Es werden nur Felder geschrieben, die das andere System wirklich sendet. Ein leerer Name, Kontaktweg oder Adressteil löscht nie etwas. Vorschau der ersten Seite zeigt, was ein Lesen tun würde (angelegt, aktualisiert, ausgelassen), ohne etwas zu schreiben.

Karte Zuordnung mit Reitern Kontakte und Firmen, Pfaden zum Lesen und Senden und einer Tabelle Feld hier, Feld dort, Fester Wert und Richtung
Die Zuordnung der Felder mit Pfaden und Richtung

Abgleich, Lesen und Senden

Karte Abgleich, Lesen und Senden mit Schlüssel eines Kontakts, Schlüssel einer Firma, Seiten, Datensätzen je Aufruf und dem Haken Änderungen sofort senden
Einstellungen zum Abgleich, zu den Seiten der Antwort und zum Senden

Datenschutz: Hat jemand die Löschung seiner Daten oder den Widerspruch verlangt, wird die Person nicht wieder angelegt. Gehört ein Kontaktweg schon einem anderen Kontakt, wird er nicht übernommen und im Lauf vermerkt, mit der Nummer des anderen Kontakts.

Werte für neue Kontakte

Status, Statuslevel, Quelle und Verantwortlicher werden nur beim Anlegen eines Kontakts über diese Verbindung gesetzt. Ein vorhandener Kontakt behält sie, was auch immer das andere System sendet. Ohne Verantwortlichen entscheiden die Regeln der Verteilung (siehe Außendienst-Zuordnung). Sendet das andere System ausdrücklich einen Status oder einen Verantwortlichen und ist das in der Zuordnung eingetragen, gilt das auch beim Aktualisieren.

Karte Werte für neue Kontakte mit Status, Statuslevel, Quelle und Verantwortlichem
Was neue Kontakte über diese Verbindung bekommen

Übersetzung von Werten

Hier legen Sie fest, was ein Wert des anderen Systems hier bedeutet: die Mitarbeiterkennung 17 wird zu einem Benutzer, ein Statustext zu einem Status. Ein Verantwortlicher muss ein Benutzer von Octoserv sein; ist er es nicht, wird er weggelassen und im Lauf vermerkt. Die Übersetzung gilt je Feld hier: Beim Verantwortlichen wählen Sie den Benutzer, bei einem Status schreiben Sie dessen Text.

Karte Übersetzung von Werten mit zwei Zeilen: Verantwortlicher mit Wert dort 17 und 18 und den zugeordneten Benutzern
Die Kennung 17 aus dem anderen System wird zu einem Benutzer von Octoserv

Deals und Angebote

Neben Kontakten und Firmen kennt die Zuordnung zwei weitere Reiter: Deals und Angebote.

Deals gehen in beide Richtungen

Ein Deal des anderen Systems wird in Octoserv angelegt oder aktualisiert, mit Ereignissen im Journal und der Wahrscheinlichkeit der Phase. Umgekehrt gehen Deals aus Octoserv an das andere System.

Beispiel: Der Deal Website kommt mit der Phase Angebot und der E-Mail-Adresse von Frau Meier. Octoserv legt ihn bei Frau Meier in der Phase Angebot an.

Angebote gehen nur nach außen

Ein Angebot ist ein Dokument mit Nummer, Positionen und PDF, das in Octoserv entsteht. Das andere System bekommt die Zahlen: Nummer, Titel, Status, Summen, Gültigkeit, den Kunden und, wenn bekannt, den Deal drüben. Es schreibt nie ein Angebot zurück.

Mit Änderungen sofort senden wandern Deals und die Statusänderungen der Angebote automatisch.

Vorlage Vtiger

Die Vorlage Vtiger CRM liest Kontakte, Organisationen und Potentiale. Als Authentifizierung wählen Sie Vtiger-Sitzung.

  1. Tragen Sie den Namen Ihrer Vtiger-Installation als Adresse ein.
  2. Tragen Sie Ihren Benutzernamen in das Feld Benutzername ein.
  3. Tragen Sie den Zugriffsschlüssel als Schlüssel ein. Sie finden ihn in Vtiger unter Meine Einstellungen.

Octoserv holt sich die Sitzung beim anderen System selbst und erneuert sie, wenn sie abgelaufen ist.

Änderungen aus dem anderen System

  1. Klicken Sie in der Karte Änderungen aus dem anderen System auf Adresse anlegen. Die Verbindung bekommt eine eigene Adresse.
  2. Tragen Sie die Adresse im anderen System als Ziel für Änderungen ein. Dieses sendet jede Änderung, sobald sie passiert.
  3. Der Zugangsschlüssel der Adresse wird einmal angezeigt. Er gehört im anderen System in den Header Authorization: Bearer …, nie in die Adresse.
  4. Mit Neuen Schlüssel anlegen wechseln Sie ihn. Der bisherige gilt noch 24 Stunden, damit das andere System ohne Lücke umgestellt werden kann.

Unter Letzte Lieferungen sehen Sie, was angenommen oder abgelehnt wurde. Adresse löschen beendet den Empfang.

Karte Änderungen aus dem anderen System mit Adresse, Zugangsschlüssel, Knöpfen Neuen Schlüssel anlegen und Adresse löschen und der Liste Letzte Lieferungen
Die Adresse für eingehende Änderungen mit Schlüssel und letzten Lieferungen

Läufe

Mit Alles aus dem anderen System lesen und Alles an das andere System senden starten Sie einen Lauf. Speichern Sie vorher die Zuordnung. Ein Lauf arbeitet im Hintergrund in Abschnitten und läuft weiter, wenn Sie den Browser schließen. Pro Verbindung läuft immer nur einer, und er lässt sich abbrechen.

Die Karte Läufe zeigt, wie viele Datensätze angelegt, aktualisiert, ausgelassen oder fehlgeschlagen sind. Details nennt, was ausgelassen wurde und warum, ohne Namen und Adressen.

Karte Läufe mit zwei Läufen: gelesen mit 48 Datensätzen und gesendet mit 64 Datensätzen, jeweils mit Zahlen für angelegt, aktualisiert, ausgelassen und fehlgeschlagen
Die Läufe einer Verbindung mit Ergebnis je Datensatz

Beispiel aus dem Alltag

Beispiel: Die Muster GmbH führt ihr Pipedrive weiter und will neue Interessenten auch in Octoserv haben. Sie legt die Verbindung aus der Vorlage Pipedrive an, trägt Namen und Schlüssel ein und testet. In der Zuordnung nutzt sie E-Mail, Vorname, Nachname und Telefon in beide Richtungen. Bei Werte für neue Kontakte steht Status Neuer Interessent und Quelle Pipedrive. Die Vorschau der ersten Seite zeigt, wie viele Kontakte angelegt und wie viele aktualisiert würden. Dann schaltet sie die Verbindung ein und startet Alles aus dem anderen System lesen. Ab jetzt meldet Pipedrive jede Änderung an die eigene Adresse, und Octoserv sendet seine Änderungen innerhalb einer Minute zurück.

Was im Hintergrund passiert

Zusammenspiel mit anderen Funktionen

Häufige Fragen

Nach dem Anlegen passiert nichts.

Die Verbindung startet angehalten. Setzen Sie den Haken Eingeschaltet und speichern Sie.

Entstehen doppelte Kontakte?

Lassen Sie Datensätze über den Schlüssel abgleichen an und tragen Sie bei Suchen, bevor im anderen System angelegt wird den Suchpfad ein. Dann werden vorhandene Datensätze verknüpft.

Der Verantwortliche fehlt am Kontakt.

Der Wert des anderen Systems muss in der Übersetzung einem Benutzer von Octoserv zugeordnet sein. Sonst wird er weggelassen und im Lauf vermerkt.