Funktionen

1. Wofuer ist diese Funktion

Der Bereich "Funktionen" in der Octoserv-Navigation buendelt fuenf spezialisierte Erweiterungen (Plugins), die ueber die CRM-Kernfunktionen hinausgehen. Jede Funktion wird als eigenstaendiges Groundhogg-Plugin bereitgestellt und ueber ein iFrame nahtlos in die Octoserv-Oberflaeche integriert. Falls ein Plugin nicht installiert oder aktiviert ist, zeigt die jeweilige Seite einen entsprechenden Hinweis an.

Die fuenf Funktionen sind:

Dubletten -- Erkennung und Verwaltung doppelter Kontakte
Connector -- Datenverbindung und Integrationshub fuer externe Systeme
AI-Connector -- KI-gestuetzte Automatisierungsverbindungen
PLZ-Verteilung -- Automatische Zuordnung von Kontakten zu Verkaeufer anhand der Postleitzahl
PLZ-Klassifizierung -- Einteilung von Kontakten in Entfernungsklassen (A/B/C)

Screenshot: Funktionen-Untermenue mit den fuenf Erweiterungen

Wird in einer zukünftigen Version ergänzt

2. Ziel und Vorteil

Modularitaet: Jede Funktion ist ein eigenstaendiges Plugin. Kunden koennen nur die Module nutzen, die sie benoetigen.
Nahtlose Integration: Obwohl die Plugins im WordPress-Backend laufen, werden sie ueber iFrames in das Octoserv-Design eingebettet. WordPress-Menueleisten und Admin-Elemente werden automatisch ausgeblendet.
Automatisierung: PLZ-Verteilung und PLZ-Klassifizierung automatisieren wiederkehrende Zuordnungsaufgaben, die sonst manuell erledigt werden muessten.
Datenqualitaet: Die Dublettenpruefung sorgt dafuer, dass keine doppelten Kontakte im System verbleiben, was die Datenqualitaet und Vertriebseffizienz erhoeht.
Erweiterbarkeit: Ueber den Connector und den AI-Connector lassen sich externe Systeme und KI-Dienste anbinden, ohne den Octoserv-Kern zu veraendern.

3. Detaillierte Funktionsbeschreibung

3.1 Dubletten (octo-doublets)

Plugin: Octo Dublettenpruefung (Version 1.1.0)
Namespace: OctoDoublets
Abhaengigkeit: Groundhogg >= 3.4

Die Dublettenpruefung erkennt und verwaltet doppelte Kontakte im CRM basierend auf mehreren Kriterien:

Erkennungsmethoden:

Telefonnummer-Abgleich: Identische oder aehnliche Telefonnummern werden erkannt.
Adress-Abgleich: Kontakte mit gleicher Strasse, PLZ und Ort werden als potenzielle Dubletten markiert.
E-Mail-Aehnlichkeit: Aehnliche E-Mail-Adressen (z.B. Tippfehler) werden identifiziert.

Funktionsweise im Funnel:
Das Plugin stellt einen eigenen Funnel-Step in Groundhogg bereit. Wenn ein neuer Kontakt durchlaeuft, prueft der Step, ob bereits ein aehnlicher Kontakt existiert. Bei einem Treffer werden Tags gesetzt und der Kontakt als potenzielle Dublette markiert.

Wartungsaufgaben (via Cron):

Bereinigung alter Log-Eintraege (aelter als 90 Tage)
Auto-Deaktivierung abgelaufener Dubletten nach konfiguriertem Timeout
Taeglicher Report per E-Mail (nur wenn neue Dubletten vorhanden)

Einbettung in Octoserv:
Die Seite laedt die Plugin-Oberflaeche als iFrame. Die URL wird entweder aus der Octoserv-Option feature_dubletten_url gelesen oder faellt auf die Standard-Admin-URL admin.php?page=octo-doublets zurueck. Die Funktion octo_is_dubletten_available() prueft, ob das Plugin verfuegbar ist.

3.2 Connector (octo-connector)

Funktion: Datenverbindung und Integrationshub fuer externe Systeme

Der Connector dient als zentrale Schnittstelle, ueber die Octoserv mit externen Systemen kommunizieren kann. Er wird als iFrame in Octoserv eingebettet und bietet eine eigenstaendige Verwaltungsoberflaeche.

Einbettung in Octoserv:
Die Seite nutzt die Octoserv-Option feature_connector_url oder die Standard-URL admin.php?page=octo-connector. Die Verfuegbarkeit wird ueber octo_is_connector_available() geprueft.

Anwendungsfaelle:

Import/Export von Kontaktdaten aus/zu externen CRM-Systemen
Synchronisation mit Buchhaltungs- oder ERP-Software
Anbindung von Webformularen und Landing-Pages

3.3 AI-Connector

Funktion: KI-gestuetzte Automatisierungsverbindungen
Backend-Plugin: Bit Pi (Bit Apps)

Der AI-Connector nutzt das Plugin "Bit Pi" als Backend und integriert es nahtlos in Octoserv. Er ermoeglicht die Erstellung automatisierter Workflows zwischen verschiedenen Diensten und KI-Systemen.

Einbettung in Octoserv:
Die Seite nutzt die Octoserv-Option feature_ai_connector_url oder die Standard-URL admin.php?page=bit-pi#/. Die Verfuegbarkeit wird ueber octo_is_ai_connector_available() geprueft. Zusaetzlich werden Bit-Pi-spezifische Branding-Elemente (Logo, Lizenz-Link, externe Links zu bitapps.pro) per CSS ausgeblendet.

Anwendungsfaelle:

Automatische Kontaktanreicherung durch KI-Analyse
Intelligente Lead-Scoring-Workflows
Automatisierte Datenverarbeitung zwischen mehreren Diensten

Screenshot: Dubletten-Verwaltung mit erkannten Duplikaten

Wird in einer zukünftigen Version ergänzt

3.4 PLZ-Verteilung (octo-plz-ap)

Plugin: Octo PLZ Ansprechpartner (Version 3.0.1)
Namespace: OctoPlzAp
Abhaengigkeit: Groundhogg >= 3.4

Dieses Plugin weist Kontakte automatisch einem Verkaeufer/Ansprechpartner zu, basierend auf der Postleitzahl des Kontakts. Die Zuweisung erfolgt im Round-Robin-Verfahren, sodass Kontakte gleichmaessig auf die verfuegbaren Verkaeufer verteilt werden.

Funktionsweise:

Ein neuer Kontakt tritt in einen Groundhogg-Funnel ein.
Der PLZ-AP-Funnel-Step (oder der Legacy-Filter plz_ap) wird ausgefuehrt.
Das Plugin liest die PLZ des Kontakts und bestimmt anhand der konfigurierten PLZ-Zuordnungstabelle, welche Verkaeufer fuer diese Region zustaendig sind.
Per Round-Robin wird der naechste Verkaeufer ausgewaehlt und als Owner des Kontakts eingetragen.

Legacy-Kompatibilitaet:
Der Filter-Hook plz_ap ermoeglicht die Nutzung in bestehenden Custom-Code-Actions innerhalb von Funnels. Aeltere Funnels, die den Filternamen plz_ap verwenden, funktionieren weiterhin.

Datenbank:
Das Plugin erstellt eigene Datenbanktabellen bei der Aktivierung (DCS_PLZ_AP_Activator::activate()).

Einbettung in Octoserv:
Die Seite nutzt die Option feature_plz_url oder die Standard-URL admin.php?page=dcs-plz-ap. Die Verfuegbarkeit wird ueber octo_is_plz_verteilung_available() geprueft.

3.5 PLZ-Klassifizierung (octo-plz-class)

Plugin: Octo PLZ Klassifizierung (Version 1.0.1)
Namespace: OctoPlzClass
Abhaengigkeit: Groundhogg >= 3.4

Dieses Plugin klassifiziert Kontakte anhand ihrer Postleitzahl in Entfernungsklassen relativ zum Firmenstandort:

Klasse	Bedeutung
A	Nahbereich -- Kontakt befindet sich in unmittelbarer Naehe zum Standort
B	Mittlere Entfernung -- Kontakt ist in erreichbarer Distanz
C	Fernbereich -- Kontakt ist weit entfernt vom Standort

Funktionsweise:

Das Plugin berechnet die Entfernung zwischen der PLZ des Kontakts und dem konfigurierten Firmenstandort.
Basierend auf konfigurierbaren Entfernungsschwellen wird der Kontakt in Klasse A, B oder C eingeordnet.
Die Klassifizierung wird als Custom Field oder Tag am Kontakt gespeichert.

Integration mit Dublettenpruefung:
Die PLZ-Klassifizierung laeuft auch bei Kontakten, die eine Dublettenwarnung ausgeloest haben. Nur die PLZ-Verteilung (Verkaeufer-Zuweisung) wird bei Dublettenwarnung uebersprungen.

Einbettung in Octoserv:
Die Seite nutzt die Standard-URL admin.php?page=octo-plz-class. Die Verfuegbarkeit wird ueber octo_is_plz_class_available() geprueft.

3.6 Gemeinsame iFrame-Integration

Alle fuenf Funktionsseiten verwenden dasselbe Integrationsmuster:

Verfuegbarkeitspruefung: Eine PHP-Funktion (octo_is_*_available()) prueft, ob das jeweilige Plugin aktiv ist.
Loading-Overlay: Waehrend das iFrame laedt, wird ein Spinner mit dem Text "Einen Moment bitte. Die Ansicht wird geladen." angezeigt.
CSS-Injection: Nach dem Laden des iFrames wird per JavaScript CSS in das iFrame-Dokument injiziert, das WordPress-Admin-Elemente (Adminbar, Seitenmenue, Footer, Benachrichtigungen) ausblendet und die Buttons/Tabellen im Octoserv-Stil (Orange-Akzent #e09000) formatiert.
Fallback: Wenn ein Plugin nicht verfuegbar ist, wird ueber octo_get_plugin_not_available_html() ein Hinweis angezeigt.

4. Benutzerdokumentation / Anwendung

4.1 Funktionsseite aufrufen

Klicken Sie in der Seitennavigation auf Funktionen.
Das Untermenue zeigt die fuenf verfuegbaren Funktionen.
Klicken Sie auf die gewuenschte Funktion.
Falls das Plugin installiert und aktiv ist, laedt die Ansicht im integrierten Rahmen.
Falls das Plugin nicht verfuegbar ist, erscheint ein Hinweistext.

4.2 Dubletten verwenden

Navigieren Sie zu Funktionen > Dubletten.
Die Plugin-Oberflaeche zeigt eine Liste erkannter Dubletten.
Fuer jede Dublette koennen Sie entscheiden:
- Zusammenfuehren: Die Daten beider Kontakte werden in einem vereint.
- Ignorieren/Freigeben: Die Dublette wird als "kein Duplikat" markiert.
- Deaktivieren: Der doppelte Kontakt wird deaktiviert.
Die Konfiguration der Erkennungsregeln erfolgt in den Plugin-Einstellungen innerhalb der Dubletten-Ansicht.

4.3 PLZ-Verteilung konfigurieren

Navigieren Sie zu Funktionen > PLZ-Verteilung.
In der Plugin-Oberflaeche definieren Sie PLZ-Bereiche und ordnen ihnen Verkaeufer zu.
Legen Sie fest, welche Verkaeufer fuer welche PLZ-Gebiete zustaendig sind.
Das Round-Robin-Verfahren stellt sicher, dass neue Kontakte gleichmaessig verteilt werden.
Die Zuweisung erfolgt automatisch, wenn ein Kontakt den entsprechenden Funnel-Step durchlaeuft.

Screenshot: PLZ-Verteilung mit Gebiets- und Verkaeufer-Zuordnung

Wird in einer zukünftigen Version ergänzt

4.4 PLZ-Klassifizierung einrichten

Navigieren Sie zu Funktionen > PLZ-Klassifizierung.
Konfigurieren Sie den Firmenstandort (PLZ).
Definieren Sie die Entfernungsschwellen fuer die Klassen A, B und C.
Die Klassifizierung erfolgt automatisch fuer neue Kontakte im Funnel und kann auch nachtraeglich fuer bestehende Kontakte ausgefuehrt werden.

4.5 Connector und AI-Connector

Navigieren Sie zu Funktionen > Connector bzw. Funktionen > AI-Connector.
Die jeweilige Plugin-Oberflaeche oeffnet sich im integrierten Rahmen.
Konfigurieren Sie Ihre Integrationen, Workflows und Verbindungen direkt in der Plugin-Oberflaeche.
Aenderungen werden sofort wirksam.

5. Anwendungsbeispiele

Beispiel 1: "Automatische Verkaeufer-Zuweisung fuer neue Kontakte"

Ein Unternehmen mit 5 Aussendienst-Mitarbeitern moechte neue Kontakte automatisch dem zustaendigen Verkaeufer zuweisen:

In der PLZ-Verteilung werden die PLZ-Bereiche den 5 Mitarbeitern zugeordnet (z.B. PLZ 10000-19999 an Verkaeufer A, PLZ 20000-29999 an Verkaeufer B, etc.).
Im Groundhogg-Funnel wird der PLZ-AP-Step nach dem Formular-Eingang eingefuegt.
Jeder neue Kontakt wird automatisch dem richtigen Verkaeufer zugewiesen.
Bei PLZ-Bereichen mit mehreren zustaendigen Verkaeufer erfolgt die Zuweisung per Round-Robin.

Beispiel 2: "Kontakte nach Entfernung priorisieren"

Ein Handwerksunternehmen moechte Kontakte nach Entfernung vom Firmensitz priorisieren:

In der PLZ-Klassifizierung wird der Firmensitz (z.B. PLZ 80331 Muenchen) konfiguriert.
Die Schwellen werden festgelegt: A = bis 50 km, B = 50-150 km, C = ueber 150 km.
Im Funnel wird der PLZ-Class-Step eingefuegt.
Kontakte der Klasse A werden bevorzugt bearbeitet, Klasse C erhaelt z.B. nur ein digitales Angebot.

Beispiel 3: "Dubletten nach Messe-Import bereinigen"

Nach einem Messe-Import mit 500 neuen Kontakten sollen Dubletten identifiziert werden:

Oeffnen Sie Funktionen > Dubletten.
Die Dublettenpruefung zeigt alle potentiellen Doppeleintraege an.
Fuer jeden Treffer sehen Sie die Uebereinstimmungskriterien (Telefon, Adresse, E-Mail).
Entscheiden Sie pro Fall: Zusammenfuehren, Ignorieren oder Deaktivieren.
Der taegliche Cron-Report informiert Sie ueber neu erkannte Dubletten.

Beispiel 4: "KI-gestuetzte Lead-Bewertung einrichten"

Ueber den AI-Connector soll eine automatische Lead-Bewertung integriert werden:

Oeffnen Sie Funktionen > AI-Connector.
Erstellen Sie einen neuen Workflow in Bit Pi.
Konfigurieren Sie den Trigger (z.B. neuer Kontakt in Groundhogg).
Verbinden Sie einen KI-Dienst zur Analyse der Kontaktdaten.
Das Ergebnis wird als Custom Field oder Tag am Kontakt gespeichert.

Beispiel 5: "Daten mit externem System synchronisieren"

Ueber den Connector sollen Kontaktdaten mit einem externen ERP-System abgeglichen werden:

Oeffnen Sie Funktionen > Connector.
Konfigurieren Sie die Verbindung zum externen System.
Definieren Sie die Feldmappings (welche Octoserv-Felder auf welche ERP-Felder abgebildet werden).
Legen Sie den Synchronisationsintervall fest.
Starten Sie die initiale Synchronisation.