Anhang A1: Plugin-Uebersicht
Einfuehrung
Octoserv basiert auf einer modularen Plugin-Architektur. Jedes Plugin erweitert das System um eine spezifische Funktion -- von der Datenqualitaet ueber die Kontaktbewertung bis hin zur CRM-Synchronisation. Die Plugins sind als WordPress-Plugins realisiert und bauen auf Groundhogg als CRM-Kern auf.
Alle Plugins werden unabhaengig voneinander installiert und aktiviert. Sie kommunizieren ueber gemeinsame Custom Fields, Tags und Meta-Daten miteinander. So laesst sich das System flexibel an unterschiedliche Anforderungen anpassen, ohne dass ungenutzte Funktionen Ressourcen verbrauchen.
Plugin-Verzeichnis
| Plugin | Version | Beschreibung | Kategorie |
|---|---|---|---|
| Octo-Connector | 4.2.1 | CRM-Synchronisation zwischen Groundhogg und externem CRM | Integration |
| Octo Dublettenpruefung | 1.1.0 | Erkennung und Verwaltung von Kontakt-Dubletten | Datenqualitaet |
| Octo Activity Logger | 2.1.0 | Dateibasiertes Activity-Logging mit automatischer Archivierung | System |
| Octo Opt-In Status | 1.0.0 | Opt-In Status in Funnels aendern | Kontakt-Management |
| Octo PLZ Ansprechpartner | 3.0.1 | Automatische Ansprechpartner-Zuweisung nach PLZ | Automatisierung |
| Octo PLZ Klassifizierung | 1.0.1 | Entfernungsklassifizierung (A/B/C) nach PLZ-Distanz | Datenqualitaet |
| Octo Ranking | 1.0.1 | Kontaktbewertung mit Score und Ampelsystem | Scoring & Qualifizierung |
| Octoserv Appointment | 1.0.1 | Termin-Erstellung aus Amelia Webhook-Daten | Automatisierung |
| Octoserv Field Transfer | 2.0.0 | Feldwert-Uebertragung zwischen Kontakt- und Auftragsfeldern | Automatisierung |
| Octoserv Pipeline | 2.0.0 | Native Sales-Pipeline Integration | Vertrieb |
| Octoserv Status | 1.0.1 | Status-Verwaltung fuer status_octo, quelle_octo und statuslevel | Kontakt-Management |
| OctoCP Post Visibility | 1.0.4 | Sichtbarkeitssteuerung fuer Posts und Plugins nach User/Rolle | Berechtigungen |
Plugin-Beschreibungen
Octo-Connector (v4.2.1)
Kategorie: Integration
Der Octo-Connector ist die zentrale Datendrehscheibe zwischen Groundhogg und einem externen CRM-System. Er synchronisiert Leads, Kontakte, Firmen, Notizen und Custom Fields bidirektional. Das Plugin verwaltet dafuer eigene Datenbanktabellen fuer die Zuordnung zwischen den Systemen (Connection-Tables, User-Mapping). Ohne den Connector arbeitet Octoserv ausschliesslich innerhalb der WordPress-/Groundhogg-Umgebung.
Octo Dublettenpruefung (v1.1.0)
Kategorie: Datenqualitaet
Erkennt und verwaltet Dubletten in Groundhogg-Kontakten anhand von Telefonnummer, Adresse und Email-Aehnlichkeit. Das Plugin stellt einen eigenen Funnel Step bereit, der bei neuen Kontakten automatisch eine Dublettenpruefung durchfuehrt. Bei einem Treffer werden Tags gesetzt, Meta-Daten geschrieben und der Anwender benachrichtigt. Ein Timeout-Mechanismus per Cron sorgt dafuer, dass nicht bearbeitete Dubletten-Warnungen nach einer definierten Frist automatisch aufgeloest werden.
Octo Activity Logger (v2.1.0)
Kategorie: System
Protokolliert Kontakt- und Funnel-Aenderungen in einem dateibasierten Logging-System mit automatischer Archivierung. Im Gegensatz zu Datenbank-Logging skaliert dieser Ansatz besser bei hohem Schreibaufkommen und belastet die Datenbank nicht. Der Logger wird vor allem fuer die Nachvollziehbarkeit von Aenderungen und fuer das Debugging eingesetzt. Er unterstuetzt verschiedene Tracker-Klassen fuer unterschiedliche Ereignistypen.
Octo Opt-In Status (v1.0.0)
Kategorie: Kontakt-Management
Ermoeglicht das Aendern des Opt-In Status direkt innerhalb von Groundhogg Funnels. Kontakte koennen auf die Werte Bestaetigt (confirmed), Abgemeldet (unsubscribed), Bounced, Spam oder Complained gesetzt werden. Das Plugin ist besonders nuetzlich fuer Automatisierungen, in denen der Opt-In Status als Reaktion auf bestimmte Ereignisse angepasst werden muss -- beispielsweise bei einer Abmeldung ueber ein Formular oder bei einem Spam-Report.
Octo PLZ Ansprechpartner (v3.0.1)
Kategorie: Automatisierung
Weist Kontakten automatisch einen Ansprechpartner (Owner) basierend auf ihrer Postleitzahl zu. Die Zuordnung erfolgt ueber konfigurierbare PLZ-Gebiete mit einem Round-Robin-Verfahren, das die gleichmaessige Verteilung auf mehrere Ansprechpartner sicherstellt. Das Plugin beruecksichtigt die Dublettenwarnung: Kontakte mit aktiver Warnung werden uebersprungen, um fehlerhafte Zuweisungen zu vermeiden. Legacy-Funnels mit dem Filter-Namen plz_ap werden weiterhin unterstuetzt.
Octo PLZ Klassifizierung (v1.0.1)
Kategorie: Datenqualitaet
Klassifiziert Kontakte anhand der Entfernung zwischen ihrer Postleitzahl und einem konfigurierten Standort in die Klassen A (nah), B (mittel) und C (fern). Die Klassifizierung wird als Meta-Feld gespeichert und steht anschliessend fuer Segmentierung, Filterung und als Eingangswert fuer das Ranking zur Verfuegung. Das Plugin laeuft auch bei Kontakten mit Dublettenwarnung, da die geographische Einordnung unabhaengig vom Dubletten-Status relevant ist.
Octo Ranking (v1.0.1)
Kategorie: Scoring & Qualifizierung
Bewertet Kontakte mit einem numerischen Score (0-100) und ordnet sie einem Ampelsystem zu (Gruen, Gelb, Orange, Rot). Die Bewertung basiert auf Aktivitaet, Engagement und weiteren konfigurierbaren Kriterien. Der Ranking-Score fliesst in die Priorisierung von Kontakten ein und unterstuetzt Vertriebsteams bei der Entscheidung, welche Leads zuerst bearbeitet werden sollen. Die PLZ-Klassifizierung kann als einer der Bewertungsfaktoren herangezogen werden.
Octoserv Appointment (v1.0.1)
Kategorie: Automatisierung
Erstellt Termine aus Amelia Webhook-Daten innerhalb von Groundhogg Funnels. Wenn ein Kunde ueber das Buchungssystem Amelia einen Termin vereinbart, empfaengt dieses Plugin die Webhook-Daten und legt den Termin als strukturierten Datensatz in Groundhogg an. So koennen Termine automatisch in Funnels weiterverarbeitet werden -- etwa fuer Erinnerungsmails oder Nachfass-Aktionen.
Octoserv Field Transfer (v2.0.0)
Kategorie: Automatisierung
Uebertraegt Feldwerte zwischen Kontakt-Feldern und Auftrags-Feldern innerhalb von Groundhogg Funnels. Typische Anwendungsfaelle sind das Kopieren von Kontaktdaten in einen Auftragsdatensatz oder umgekehrt. Das Plugin stellt einen Funnel Step bereit, in dem die Quell- und Zielfelder konfiguriert werden. So entfaellt die manuelle Datenuebertragung und die Fehlerquote bei wiederholten Prozessen sinkt.
Octoserv Pipeline (v2.0.0)
Kategorie: Vertrieb
Integriert die Groundhogg Sales-Pipeline nativ in Octoserv. Das Plugin setzt das Groundhogg-Pipeline-Addon voraus und erweitert es um Octoserv-spezifische Funktionen fuer die Vertriebssteuerung. Deals koennen automatisiert durch Pipeline-Stufen bewegt werden, und der aktuelle Stand ist direkt in der Octoserv-Oberflaeche sichtbar. Debug-Logging laesst sich ueber eine Konstante aktivieren.
Octoserv Status (v1.0.1)
Kategorie: Kontakt-Management
Ermoeglicht das Aendern der Octoserv-spezifischen Statusfelder (status_octo, quelle_octo, statuslevel) direkt in Groundhogg Funnels. Diese Felder bilden das zentrale Statuskonzept von Octoserv ab und bestimmen, in welchem Stadium sich ein Kontakt befindet (z.B. Interessent, Kunde, Inaktiv). Das Plugin macht separate Custom Code Actions fuer Statusaenderungen ueberfluessig und reduziert die Komplexitaet in Funnels.
OctoCP Post Visibility (v1.0.4)
Kategorie: Berechtigungen
Steuert die Sichtbarkeit von Custom Post Types und Plugins fuer bestimmte WordPress-User oder Rollen. Administratoren koennen ueber ein Modal pro Beitrag festlegen, welche Benutzer oder Rollen den Eintrag nicht sehen sollen. Auch Plugins lassen sich rollenbasiert ausblenden. Das Plugin eignet sich besonders fuer Multi-User-Installationen, in denen nicht alle Inhalte fuer alle Benutzer relevant sind.
Plugin-Zusammenspiel
Die Octoserv-Plugins sind so konzipiert, dass sie unabhaengig funktionieren, aber ueber gemeinsame Datenstrukturen zusammenwirken. Die wichtigsten Zusammenhaenge:
Datenfluss: PLZ-Klassifizierung → Ranking
Die PLZ Klassifizierung ordnet jedem Kontakt eine Entfernungsklasse (A/B/C) zu und speichert diese als Meta-Feld. Das Ranking-Plugin kann diesen Wert als Bewertungsfaktor heranziehen: Kontakte in Klasse A (nah am Standort) erhalten tendenziell einen hoeheren Score als entfernte Kontakte.
Datenfluss: Dublettenpruefung → PLZ-Plugins → Ranking
Die Dublettenpruefung setzt bei einem Treffer eine Warnung als Tag und Meta-Feld. Die PLZ Klassifizierung laeuft unabhaengig davon weiter, aber die PLZ Ansprechpartner-Zuweisung wird bei aktiver Dublettenwarnung uebersprungen. Auch das Ranking beruecksichtigt den Dubletten-Status, damit keine falschen Scores vergeben werden.
Statuskonzept: Opt-In Status + Octoserv Status
Der Opt-In Status steuert die Groundhogg-seitige Kommunikationserlaubnis (confirmed, unsubscribed, etc.), waehrend der Octoserv Status die geschaeftliche Einordnung des Kontakts verwaltet (status_octo, quelle_octo, statuslevel). Beide Plugins arbeiten auf verschiedenen Ebenen und ergaenzen sich: Ein Kontakt kann den Opt-In Status "confirmed" haben, aber im Octoserv-Status als "Inaktiv" gefuehrt werden.
Automatisierungskette in Funnels
In einem typischen Funnel durchlaeuft ein neuer Kontakt mehrere Plugin-Steps nacheinander:
- Octoserv Status -- Setzt den initialen Status und die Quelle
- Dublettenpruefung -- Prueft auf bestehende Kontakte
- PLZ Klassifizierung -- Ordnet die Entfernungsklasse zu
- PLZ Ansprechpartner -- Weist einen Owner zu (sofern keine Dublette)
- Field Transfer -- Uebertraegt Felder in den Auftragsdatensatz
- Ranking -- Berechnet den Score basierend auf allen vorliegenden Daten
Systemunterstuetzung
Der Activity Logger protokolliert die Aktionen aller anderen Plugins und macht Aenderungen nachvollziehbar. Der Octo-Connector synchronisiert die Ergebnisse bei Bedarf mit dem externen CRM. OctoCP Post Visibility steuert, welche Plugins und Inhalte fuer welche Benutzer sichtbar sind, und ermoeglicht so massgeschneiderte Arbeitsbereiche.
Pipeline-Integration
Die Octoserv Pipeline verbindet die Kontaktdaten mit dem Vertriebsprozess. Wenn ein Kontakt ueber das Ranking als qualifiziert eingestuft wird, kann automatisch ein Deal in der Pipeline angelegt und dem zugewiesenen Ansprechpartner (aus PLZ AP) zugeordnet werden. Appointment ergaenzt den Vertriebsprozess um die automatische Terminerstellung aus externen Buchungssystemen.