Files
HiveGrid-Wireframes/hivegrid-cloud/_bmad-output/pflichtenheft/blocks/block5.md
T

65 KiB
Raw Blame History

Block 5: Kommunikation

Sechs Module, die alle Kommunikations-Kanäle in HiveGrid abbilden: Email-Posteingang mit Sync zu Gmail und Outlook, Email-Marketing als HubSpot-Marketing-Ablösung, Telefonie über AirCall, interner Team-Chat, Push-/Email-/In-App-Benachrichtigungen, und bidirektionale Kalender-Synchronisation.


Modul 9: Email-Inbox

Was es tut: Verbindet die Email-Postfächer der Mitarbeiter (Gmail, Outlook) mit HiveGrid, sodass jede ein- und ausgehende Mail automatisch dem richtigen Kontakt, Deal oder Projekt zugeordnet wird und im Aktivitäts-Verlauf sichtbar ist. Schickt eigene Mails über das verbundene Postfach des Mitarbeiters raus, sodass die Mail nativ im "Gesendet"-Ordner des Mitarbeiters landet.

Löst ab: HubSpot-Email-Tools (Posteingang-Anbindung, Mail-Tracking, Verknüpfung mit CRM).

Warum es wichtig ist: Ohne Mailbox-Anbindung bleibt das CRM blind für 70% der Kundenkommunikation. Jede Mail manuell ins CRM kopieren ist genau die Sklaverei, von der HiveGrid den Handwerker befreien soll.

9.1 Welche Email-Anbieter werden unterstützt

9.1.1 Phase 1 unterstützt Gmail (inkl. Google Workspace) und Microsoft Outlook / Microsoft 365. 9.1.2 Andere Anbieter (eigene IMAP-Server, T-Online, GMX, Web.de) sind in Phase 1 nicht unterstützt, Hinweis im Setup: "Aktuell nur Gmail und Outlook. Andere Anbieter folgen in einer späteren Version." 9.1.3 Pro Mitarbeiter können mehrere Postfächer verbunden werden (z.B. privat + dienstlich), eines wird als "Standard-Postfach" markiert. 9.1.4 Die Anmeldung an Gmail/Outlook erfolgt einmalig per offiziellem Login-Fenster des Anbieters; HiveGrid sieht das Passwort des Mitarbeiters nie.

9.2 Was im Posteingang sichtbar ist

9.2.1 Eine Listen-Ansicht aller verbundenen Mails mit Absender, Betreff, ersten Zeilen der Mail, Empfangsdatum, Lese-Status und Anhang-Anzeige. 9.2.2 Filter nach: Postfach (wenn mehrere), Eingang/Ausgang, gelesen/ungelesen, verknüpft mit Kontakt/Deal/Projekt/nicht verknüpft, Datums-Bereich, Anhang vorhanden. 9.2.3 Volltext-Suche über Betreff, Inhalt und Absender. 9.2.4 Detail-Ansicht zeigt die komplette Mail (mit Anhängen herunterladbar), den verknüpften Kontakt/Deal/Projekt, den kompletten Mail-Verlauf (Thread, alle Antworten chronologisch) und Funktionen "Antworten / Allen antworten / Weiterleiten". 9.2.5 Externe Bilder in Mails sind aus Sicherheitsgründen erst nach explizitem Klick "Bilder anzeigen" sichtbar (Schutz vor Tracking-Pixeln). 9.2.6 Mails, die HiveGrid keinem Kontakt zuordnen konnte, zeigen einen Hinweis: "Diese Mail ist keinem Kontakt zugeordnet, [Zu Kontakt zuordnen] [Neuen Kontakt anlegen]". 9.2.7 Mark-as-read und Archivieren werden zum Postfach zurück synchronisiert (was im HiveGrid als gelesen markiert wird, ist auch in Gmail/Outlook gelesen).

9.3 Verknüpfung mit Kontakten und Deals (Auto-Zuordnung)

9.3.1 Über die Email-Adresse: Stimmt die Absender- (oder Empfänger-) Adresse exakt mit der Email eines bestehenden Kontakts oder Leads überein, wird die Mail automatisch dem Kontakt zugeordnet. 9.3.2 Über Betreff-Kürzel: Enthält der Betreff Kennungen wie [Deal #123], [Auftrag #456] oder [Lead #789], wird die Mail automatisch dem entsprechenden Vorgang zugeordnet. 9.3.3 Heuristisch über Kontakt + offene Deals: Hat der zugeordnete Kontakt genau einen offenen Deal, wird die Mail diesem Deal vorgeschlagen (mittlere Sicherheit, sichtbar markiert). 9.3.4 Manuelle Korrektur: Jede Auto-Zuordnung kann der Mitarbeiter im Detail-View überschreiben (Mail einem anderen Kontakt/Deal/Projekt zuordnen). Manuelle Zuordnung wird respektiert und nicht automatisch überschrieben. 9.3.5 Bei mehreren Kontakten mit gleicher Email-Adresse wird der primäre Kontakt gewählt mit Hinweis: "Diese Email gehört zu mehreren Kontakten. Aktuell zugeordnet: [Name]." 9.3.6 Newsletter und Bulk-Mails (erkennbar an Kopfzeilen) werden nicht automatisch verknüpft, sondern als "Newsletter / Bulk" markiert.

9.4 Eigene Sende-Domain mit Echtheits-Schutz

9.4.1 Damit der Handwerker Marketing-Mails (Modul 10) und Bestätigungs-Mails (Booking, Acceptance) unter seiner eigenen Domain (z.B. info@geerkens.de) versenden kann, muss diese Domain einmalig im HiveGrid verifiziert werden. 9.4.2 HiveGrid generiert drei DNS-Einträge (Email-Echtheits-Schutz: DKIM, SPF, DMARC) und zeigt sie als Klartext-Anleitung mit Copy-to-Clipboard-Funktion an: "Diese 3 Einträge bei deinem DNS-Anbieter (Strato, Hetzner, IONOS, Cloudflare) anlegen. Wir prüfen automatisch alle 5 Minuten." 9.4.3 Sobald HiveGrid die Einträge findet, wird die Domain auf "verifiziert" gesetzt und kann für Versand benutzt werden. 9.4.4 Findet HiveGrid die Einträge 7 Tage lang nicht, wird die Verifikation abgebrochen mit Klartext: "DNS-Einträge nach 7 Tagen nicht gefunden. [Anleitung erneut anzeigen] [Support kontaktieren]". 9.4.5 Ohne verifizierte Domain ist Marketing-Versand nicht möglich (Modul 10 blockiert mit Hinweis); transaktionale Mails (Booking-Bestätigung, Passwort-Reset) gehen ersatzweise über die HiveGrid-Standard-Domain mit Tenant-Branding. 9.4.6 Die Einrichtung der Sende-Domain ist ein einmaliger Vorgang pro Handwerksbetrieb (nicht pro Mitarbeiter).

9.5 Mailbox-Synchronisation

9.5.1 HiveGrid empfängt neue Mails über sofortige Push-Benachrichtigungen vom Anbieter (kein verzögertes Abfragen alle 15 Minuten). Eine neue Mail erscheint in der Regel innerhalb weniger Sekunden im HiveGrid-Posteingang. 9.5.2 Beim ersten Verbinden eines Postfachs werden die letzten 90 Tage Mail-Historie geladen (Standard, später konfigurierbar). Während des Initial-Imports zeigt HiveGrid einen Fortschrittsbalken: "Initial-Sync läuft, 1.234 von 5.678 Mails geladen (22%)". 9.5.3 Geht die Verbindung zum Postfach verloren (z.B. weil der Mitarbeiter die HiveGrid-Berechtigung in Gmail widerrufen hat), wird der Status auf "Verbindung unterbrochen" gesetzt und der Mitarbeiter bekommt eine Klartext-Mitteilung: "Deine Gmail-Verbindung wurde unterbrochen, bitte erneut verbinden. [Verbindung erneuern]". 9.5.4 Die automatische Wieder-Anmeldung (Token-Refresh) läuft im Hintergrund, sodass eine einmal verbundene Mailbox monatelang stabil bleibt. 9.5.5 Sollten die Push-Benachrichtigungen länger als 4 Stunden ausbleiben, prüft HiveGrid sicherheitshalber stündlich aktiv nach (Sicherheitsnetz).

9.6 Quotenschutz und Spam

9.6.1 Pro Anbieter gibt es Versand-Limits (Gmail: 1 Milliarde Anfragen pro Tag, Microsoft: 10.000 Mails/Tag pro Postfach). HiveGrid drosselt automatisch, bevor diese Limits gerissen werden. 9.6.2 Schickt Gmail/Outlook eine "Quota überschritten"-Meldung zurück, erscheint Klartext: "Du hast das tägliche Sende-Limit erreicht. Es wird in [X Stunden] zurückgesetzt." 9.6.3 Eingehende Mails, die der Anbieter als Spam markiert hat, werden im HiveGrid mit einem Spam-Hinweis versehen, aber nicht automatisch ausgeblendet (der Mitarbeiter entscheidet).

9.7 Schreiben und Versenden eigener Mails

9.7.1 Mail-Schreiben kann aus dem Kontakt-/Deal-/Projekt-Detail heraus gestartet werden (Empfänger und Betreff werden vorausgefüllt) oder aus dem Posteingang (Antworten / Weiterleiten). 9.7.2 Texteditor mit Formatierung (fett, kursiv, Listen, Bilder einbetten), Anhänge bis 25 MB pro Mail (Anbieter-Limit). 9.7.3 Mehrere Postfächer verbunden: der Absender wird vor dem Senden gewählt (Standard-Postfach des Mitarbeiters voreingestellt). 9.7.4 Die Mail wird nativ über das verbundene Postfach versendet, sie erscheint im "Gesendet"-Ordner des Mitarbeiters in Gmail/Outlook (so als hätte er sie dort geschrieben). 9.7.5 Optional: BCC-Logging-Adresse, damit auch Mails, die der Mitarbeiter aus dem nativen Gmail/Outlook schreibt, automatisch im CRM landen.

9.8 Berechtigungen

9.8.1 Eigene Mails sehen: der Mitarbeiter sieht nur Mails aus seinem eigenen verbundenen Postfach. 9.8.2 Alle Mails sehen: Vorgesetzte/Backoffice können alle Mails aller Postfächer im Betrieb sehen. 9.8.3 Mails schreiben: der Mitarbeiter kann Mails aus dem eigenen Postfach versenden. 9.8.4 Email-Admin: Sende-Domain einrichten, fremde Postfach-Verbindungen trennen. 9.8.5 Die Aktivitäten am Kontakt respektieren diese Berechtigungen: Wer nur "eigene Mails sehen" darf, sieht am Kontakt nur die Mails aus seinem Postfach.

9.9 Phase 2 / bewusst NICHT in Phase 1

9.9.1 Andere Email-Anbieter (T-Online, GMX, eigene IMAP-Server). 9.9.2 Geplanter Versand ("Mail um Datum X versenden"). 9.9.3 Snooze-Funktion (Mail kommt in 3 Tagen wieder in Inbox). 9.9.4 Auto-Weiterleitungs-Regeln (alle Mails von Domain X an Sales-Team). 9.9.5 Shared-Inbox (mehrere Mitarbeiter teilen sich ein Postfach mit Zuweisung). 9.9.6 Tenant-konfigurierbare Betreff-Kürzel für Auto-Zuordnung. 9.9.7 Unified Inbox mit weiteren Kanälen (Email + WhatsApp + perspektivisch weitere Messaging-Quellen) [N15, 09.05.2026]: pro Abteilung oder pro Projekt eine gemeinsame Sicht über alle Kommunikations-Kanäle. Vorbild Superchat. Alle Nachrichten sind dem Projekt/Kontakt zugeordnet, Mitarbeiter sehen, was beim Kollegen angekommen ist (Informations-Redundanz, Transparenz). Bedeutet ein eigenes Sub-Modul mit WhatsApp-Adapter (heute Anti-Liste, siehe Vision V.3.2.3) und Konversations-Threading über Kanal-Grenzen. Phase 2.

9.10 Klartext-Fehlertexte (Beispiele)

9.10.1 "Deine Gmail-Verbindung wurde unterbrochen, bitte erneut verbinden. [Verbindung erneuern]" 9.10.2 "Wir konnten Google nicht erreichen. Wir versuchen es erneut in 5 Min. [Manuell prüfen]" 9.10.3 "Du hast das tägliche Sende-Limit erreicht. Es wird in [X Stunden] zurückgesetzt." 9.10.4 "Outlook-Verbindung abgelaufen, bitte erneut verbinden." 9.10.5 "DNS-Einträge nach 7 Tagen nicht gefunden. [Anleitung erneut anzeigen]" 9.10.6 "Du hast keine Mailbox verbunden. [Mailbox verbinden]" 9.10.7 "Der Kontakt hat keine Email-Adresse hinterlegt. [Email ergänzen]"


Modul 10: Email-Marketing

Was es tut: Versendet Newsletter, Wartungs-Erinnerungen, Service-Aktionen und automatische Trigger-Mails an Empfänger-Listen aus dem CRM. Trackt Öffnungen und Klicks, behandelt automatisch Rückläufer (Bounces), verwaltet Abmeldungen DSGVO-konform und stellt der Automation-Engine (Modul 17) eine Aktion "Marketing-Mail senden" zur Verfügung.

Löst ab: HubSpot-Marketing-Hub.

Warum es wichtig ist: Marketing-Mails sind die Standard-Erinnerungs- und Akquise-Schiene im SHK-Geschäft (Wartungs-Erinnerungen, Saison-Aktionen, Newsletter). Ohne dieses Modul müsste Geerkens HubSpot-Marketing-Hub weiter zahlen oder zu einem fremden Tool wie Brevo/Mailchimp wechseln.

10.1 Newsletter und Sequenzen

10.1.1 Eine Kampagne ist eine einmalige Mail-Aussendung an eine definierte Empfänger-Liste (Sofort-Versand oder geplant für späteren Zeitpunkt). 10.1.2 Der Kampagnen-Builder führt in Schritten durch: Basis-Daten (Name, Betreff, Vorschau-Text, Absender wählen) → Inhalt (Texteditor mit Personalisierungs-Platzhaltern) → Empfänger wählen → Test-Mail an sich selbst senden → Versand-Zeitpunkt → Bestätigung. 10.1.3 Personalisierungs-Platzhalter im Mail-Text werden pro Empfänger ersetzt: {{first_name}}, {{last_name}}, {{company_name}} und beliebige eigene Felder (z.B. {{custom.heizungs_modell}}). 10.1.4 Vorlagen (Templates) sind wiederverwendbare Mail-Designs. SHK-Standard-Vorlagen werden mit dem Account ausgeliefert: "Wartungs-Erinnerung", "Newsletter Q4", "Service-Aktion" (Vorlagen sind anpassbar). 10.1.5 Vorschau-Funktion rendert die Mail Desktop- und Mobile-Breite und zeigt mit Beispieldaten, wie sie beim Empfänger ankommt. 10.1.6 Sequenzen (Mail 1 → 3 Tage warten → Mail 2 → 7 Tage → Mail 3) sind Phase 2, in Phase 1 werden zeitliche Abfolgen über die Automation-Engine (Modul 17) gebaut.

10.2 Empfänger-Listen und Segmentierung

10.2.1 Segmente sind gespeicherte Filter über die Kontakt-Datenbank. Beispiele: "Alle Kontakte mit Wartungsvertrag", "Alle Endkunden mit Lifecycle = Kunde, Sprache Deutsch", "Alle Kontakte mit Tag 'Newsletter' UND letzter Auftrag älter als 365 Tage". 10.2.2 Filter-Kriterien: Tags (UND/ODER), Lifecycle-Stage, eigene Felder, Verantwortlicher Mitarbeiter, Erstellt-Datum, verknüpft mit aktivem Deal, letzte Aktivität, Endkunde-Flag, Sprache. 10.2.3 Verschachtelte UND/ODER-Bäume sind möglich (z.B. "Tag = Newsletter UND (Wartungsvertrag = Ja ODER Lifecycle = Kunde)"). 10.2.4 Live-Vorschau: das Segment zeigt jederzeit die aktuell zutreffende Empfänger-Anzahl und eine Stichprobe von 50 Beispiel-Kontakten. 10.2.5 Statisches vs. dynamisches Segment: Default ist dynamisch (Empfänger wird bei jedem Versand neu berechnet). Statisch friert die Liste zum Anlage-Zeitpunkt ein (Use-Case: "Genau diese 247 Kunden bekommen die Aktion"). 10.2.6 Auto-Ausschluss bei Versand: Empfänger ohne dokumentierte Marketing-Einwilligung, in der Sperrliste, ohne Email-Adresse, archiviert oder bereits abgemeldet werden automatisch ausgeschlossen. Die Versand-Bestätigung zeigt Klartext: "X aus Y Empfängern werden ausgeschlossen (Abmeldung / Hard-Bounce / Sperrliste / fehlende Einwilligung)".

10.3 A/B-Tests

10.3.1 A/B-Tests (Variante A vs. Variante B mit unterschiedlichem Betreff oder Inhalt, automatischer Versand des Gewinners an den Rest) sind Phase 2. 10.3.2 In Phase 1 kann der Betrieb manuell zwei Kampagnen an Test-Segmente versenden und das Ergebnis manuell vergleichen.

10.4 Tracking (Öffnungen, Klicks, Bounces, Beschwerden)

10.4.1 Pro Kampagne werden gezählt: versendet, zugestellt, hart zurückgekommen (Adresse existiert nicht), weich zurückgekommen (Mailbox voll), geöffnet (eindeutig pro Empfänger), geklickt, abgemeldet, Spam-Beschwerden. 10.4.2 Daraus errechnet HiveGrid: Zustellrate, Öffnungsrate, Klickrate, Klick-zu-Öffnungs-Rate, Abmelde-Rate. 10.4.3 Klick-Karte: zeigt welche Links wie oft geklickt wurden (sortiert nach Klick-Häufigkeit). 10.4.4 Pro-Empfänger-Liste: tabellarisch alle Empfänger der Kampagne mit Status (zugestellt, geöffnet wann, geklickt was, abgemeldet wann). 10.4.5 Aggregat am Kontakt: im Kontakt-Detail erscheint "Marketing-Engagement: 12 Mails erhalten, 8 geöffnet (66%), 3 geklickt (25%), 0 abgemeldet", sichtbar auch ohne Marketing-Berechtigung (ohne Detail welche Kampagne). 10.4.6 Datenschutz-Hinweis: Im Mail-Footer steht "Diese Mail enthält einen Tracking-Pixel" (DSGVO-Pflicht).

10.5 Unsubscribe-Pflicht (DSGVO-Pflicht)

10.5.1 Jede Marketing-Mail enthält automatisch einen Abmelde-Link im Footer. Wenn der Mitarbeiter den Link beim Schreiben vergisst, fügt HiveGrid ihn beim Versand zwingend ein. 10.5.2 Klick auf den Abmelde-Link öffnet eine öffentliche Abmelde-Seite (kein Login nötig) mit Klartext: "Du wirst von Marketing-Mails von [Betriebs-Name] abgemeldet. [Abmeldung bestätigen]". 10.5.3 Optional kann der Empfänger einen Grund auswählen (zu häufig / nicht relevant / Spam / sonstiges) und Freitext-Feedback geben. 10.5.4 Nach Bestätigung erscheint: "Du bist abgemeldet. Wir senden keine weiteren Marketing-Mails an [Email]. Falls das ein Versehen war: [Wieder anmelden]". 10.5.5 Abgemeldete Adressen werden dauerhaft auf eine Sperrliste pro Betrieb gesetzt; auch wenn der Kontakt im CRM gelöscht und neu angelegt wird, bleibt die Adresse gesperrt. 10.5.6 Ein-Klick-Abmeldung über speziellen Mail-Header für Gmail/Apple Mail: der Empfänger kann direkt in Gmail "Abmelden" klicken, ohne die Abmelde-Seite zu öffnen.

10.6 Bounce-Handling

10.6.1 Hard-Bounce (Adresse existiert nicht, Domain existiert nicht, Mailbox blockiert): die Adresse wird automatisch auf die Sperrliste gesetzt. Künftige Marketing-Versendungen blockiert. Im Kontakt-Detail erscheint Klartext: "Email-Adresse als ungültig markiert (Hard-Bounce am [Datum]). Marketing-Mails werden nicht mehr an diese Adresse gesendet. [Adresse korrigieren] [Trotzdem verwenden]". 10.6.2 Soft-Bounce (Mailbox temporär voll, Server kurz down): bis zu 3-mal über 24 Stunden erneut versucht. Bleibt es bei 3 Fehlversuchen, wird wie Hard-Bounce behandelt. 10.6.3 Spam-Beschwerden: meldet der Empfänger die Mail als Spam (über sein Mail-Programm), wird der Kontakt automatisch abgemeldet und die Adresse gesperrt. Im Kontakt-Aktivitäts-Verlauf erscheint: "Empfänger hat sich beschwert, automatisch abgemeldet".

10.7 DSGVO-Marketing-Einwilligungen (kritisch)

10.7.1 Einwilligung dokumentieren ist Pflicht: zu jedem Kontakt wird festgehalten WANN, WOHER und MIT WELCHEM TEXT er der Marketing-Kommunikation zugestimmt hat (Form-Submission, manueller Import, bestehender Kunde, Double-Opt-In-Bestätigung). 10.7.2 Kontakte ohne dokumentierte Einwilligung werden beim Versand automatisch ausgeschlossen (kein Versand möglich). 10.7.3 Double-Opt-In: trägt sich ein Endkunde in ein Anmelde-Formular ein, sendet HiveGrid eine Bestätigungs-Mail mit Bestätigungs-Link. Erst nach Klick gilt die Einwilligung als erteilt. Der Bestätigungs-Link ist 7 Tage gültig. 10.7.4 Bei einer Kampagne mit weniger als 50% einwilligenden Empfängern erscheint Warnhinweis: "Nur X% deiner Empfänger haben dokumentierte Einwilligung. Die anderen werden ausgeschlossen. [Mehr lernen]". 10.7.5 Pflicht-Inhalte im Mail-Footer: physische Absender-Adresse (Impressum nach DSGVO), Abmelde-Link. Versand wird blockiert, wenn HiveGrid keine Adresse erkennt, Klartext: "Im Footer fehlt die Absender-Adresse (DSGVO-Pflicht). [Footer ergänzen]".

10.8 Trigger-Mails über die Automation-Engine

10.8.1 Modul 17 (Automation) bietet die Aktion "Marketing-Mail senden" in Wenn-Dann-Regeln. 10.8.2 Konfiguration: Vorlage wählen (Pflicht), Absender wählen, Empfänger aus Auslöse-Kontext bestimmen ("an den Kontakt des ausgelösten Deals"), Personalisierungs-Werte aus dem Auslöser nutzen. 10.8.3 Beispiele für Geerkens: "Wenn neuer Lead aus Formular → 1h später Bestätigungs-Mail mit Terminvorschlag", "Wenn letzte Wartung > 365 Tage → Wartungs-Erinnerung", "Wenn Deal-Stage = 'Angebot offen' für 7 Tage → Erinnerungs-Mail". 10.8.4 Auto-Ausschluss greift auch hier: ist der Empfänger abgemeldet oder gesperrt, wird die Trigger-Mail nicht gesendet (Aktivitäts-Eintrag: "Trigger-Mail blockiert, Empfänger abgemeldet").

10.9 Anti-Spam-Schutz (Schutz für die eigene Sender-Reputation)

10.9.1 Tages-Limit pro Betrieb: Cloud-Plan 10.000 Mails/Tag, Cloud-Plus 50.000/Tag, Enterprise individuell, Trial 200/Tag (gegen Missbrauch). Bei Überschreitung pausiert der Versand mit Klartext: "Tägliches Sende-Limit erreicht. Versand wird morgen 00:00 fortgesetzt". 10.9.2 Frequenz-Schutz pro Empfänger: maximal 5 Marketing-Mails pro Empfänger pro Woche (verhindert Belästigung, anpassbar im Admin-Bereich). 10.9.3 Spam-Check vor Versand: der Mail-Inhalt wird gegen einfache Regeln geprüft (übermäßiger Großschrift-Einsatz, zu viele Ausrufezeichen, Verdachts-Phrasen wie "KOSTENLOS!!!", Bilder/Text-Verhältnis). Spam-Score 0-10 wird mit Empfehlungen angezeigt; ab Score >7 erscheint Warnung.

10.10 Berechtigungen

10.10.1 Marketing lesen: Kampagnen, Statistiken, Vorlagen, Segmente einsehen. 10.10.2 Marketing schreiben: Kampagnen erstellen, bearbeiten, versenden. 10.10.3 Marketing-Admin: Absender verwalten, Sperrliste verwalten, Tages-Limit konfigurieren, Spam-Override, Frequenz-Schutz setzen.

10.11 Phase 2 / bewusst NICHT in Phase 1

10.11.1 A/B-Tests automatisch (Gewinner-Versand an Rest). 10.11.2 Echte Mehrstufen-Sequenzen (Mail 1 → 3 Tage → Mail 2 → ...) im Marketing-Modul (Phase 1 über Automation-Engine machbar). 10.11.3 Erweiterte Analyse: Geräte-Aufschlüsselung, Geo-Map, Klick-Heat-Map. 10.11.4 Bedingter Inhalt (Block X nur wenn Feld Y = Z). 10.11.5 Drag-&-Drop-Email-Builder (Phase 1: Texteditor mit Vorlagen). 10.11.6 KI-optimierter Sende-Zeitpunkt pro Empfänger. 10.11.7 Granulare Abmelde-Kategorien (Newsletter, Aktion, Service-Update getrennt abmeldbar). 10.11.8 Re-Engagement-Kampagnen (Auto-Erkennung inaktiver Empfänger). 10.11.9 Aufwärm-Phase für neue Sende-Domains (Phase 2: Tag 1 = 100, Tag 7 = 1.000, Tag 30 = 10.000).

10.12 Klartext-Fehlertexte (Beispiele)

10.12.1 "Setup deiner Sende-Domain läuft noch. Wir prüfen alle 5 Minuten. [Status anzeigen]" 10.12.2 "Du brauchst eine verifizierte Sende-Domain bevor du Marketing-Mails versendest. [Domain einrichten]" 10.12.3 "Test-Mail an [Email] versendet. Falls nach 5 Min nicht angekommen: Spam-Ordner prüfen." 10.12.4 "Dein Segment liefert aktuell 0 Empfänger. Filter zu eng? [Segment editieren]" 10.12.5 "Tägliches Sende-Limit erreicht (10.000/10.000). Versand wird morgen 00:00 fortgesetzt." 10.12.6 "Versand fehlgeschlagen, Sender-Domain wurde widerrufen. Domain neu verifizieren und erneut starten." 10.12.7 "Im Footer fehlt die Absender-Adresse (DSGVO-Pflicht). [Footer ergänzen]" 10.12.8 "Nur 32% deiner Empfänger haben dokumentierte Einwilligung. Die anderen werden ausgeschlossen."


Modul 12: Telefonie [N16, 09.05.2026]

Was es tut: Bindet vorhandene Telefonie-Anbieter sauber an HiveGrid an. Aus jeder Kontakt-, Lead- oder Deal-Karte kann mit einem Klick angerufen werden. Eingehende Anrufe werden automatisch dem richtigen Kontakt zugeordnet, im Aktivitäts-Verlauf protokolliert, und nach dem Anruf kann der Mitarbeiter eine Notiz hinzufügen.

Phase-1-Anbieter:

  • AirCall (für Mandanten, die AirCall bereits einsetzen, z. B. Geerkens-Vertrieb)
  • HalloPetra (für SHK-Betriebe, die einen telefonischen Erst-Empfang über HalloPetra fahren, ca. 2.000 SHK-Nutzer in Deutschland, sehr etabliert in der Branche)

Optional gehalten (kein Anbieter-Pflicht-Setup): nicht jeder Mandant nutzt einen unterstützten Anbieter. Wer keinen Anbieter verbindet, sieht in HiveGrid die Click-to-Call-Funktion als normalen tel:-Link auf das Standard-Telefon des Geräts; eingehende Anrufe ohne Anbieter-Anbindung werden nicht protokolliert. Vorbild HubSpot, wo Telefonie ebenfalls Add-On ist, nicht Pflicht.

Löst ab: Nichts. AirCall und HalloPetra bleiben als externe Anbieter, HiveGrid bindet sauber an, statt eine eigene Telefonie zu bauen. Andere Anbieter (Sipgate, Auerswald-PBX, weitere) sind Phase 2.

Warum es wichtig ist: Telefon ist im SHK-Geschäft der Haupt-Kommunikationskanal mit Endkunden. Ohne automatisches Anruf-Logging wandert das Wissen "Wer hat wann mit wem worüber telefoniert" in Zettel, Excel-Listen und individuelle Köpfe, nicht ins CRM. HalloPetra-Anbindung in Phase 1 sorgt dafür, dass viele SHK-Betriebe am Tag eins sofort produktiven Mehrwert sehen.

12.1 Anbindung der Telefonie-Anbieter

12.1.1 Phase 1 unterstützte Anbieter: AirCall und HalloPetra. Pro Mandant kann genau einer der beiden verbunden sein, alternativ keiner (siehe Modul-Beschreibung oben). Sipgate, Auerswald, weitere sind Phase 2 (gleiche Architektur, anderer Adapter, siehe Modul 33a). 12.1.2 Pro Betrieb wird AirCall einmalig verbunden (Tenant-Admin oder Integrations-Admin meldet sich beim Setup mit dem AirCall-Account an, gewährt HiveGrid Zugriff). 12.1.3 Nach erfolgreicher Anmeldung listet HiveGrid alle AirCall-Mitarbeiter der Firma auf und schlägt automatisch eine Zuordnung zu HiveGrid-Mitarbeitern vor (basierend auf der Email-Adresse). Manuelle Korrektur möglich. 12.1.4 Klartext-Hinweis: "X von Y AirCall-Mitarbeitern automatisch zugeordnet. [Y] manuell zuordnen." 12.1.5 Funktion "Verbindung testen" prüft die Anbindung; bei Fehler erscheint spezifische Diagnose (Zugriff abgelaufen / Berechtigung fehlt / AirCall nicht erreichbar). 12.1.6 Die automatische Wieder-Anmeldung läuft im Hintergrund. Wird die Verbindung widerrufen, erscheint Klartext: "Deine AirCall-Verbindung wurde unterbrochen, bitte erneut verbinden. [Verbindung erneuern]". 12.1.7 HalloPetra-Anbindung (analog AirCall, eigener Adapter über Modul 33a) [N16, 09.05.2026]: - Anmeldung mit dem HalloPetra-Account einmalig pro Mandant. - Auto-Zuordnung der HalloPetra-Mitarbeiter zu HiveGrid-Mitarbeitern über Email-Adresse. - Eingehende Anrufe (auch verpasste) werden mit Anrufer-Nummer, Anruf-Datum, Mitschnitt-Link, ggf. HalloPetra-Notiz im HiveGrid-Aktivitäts-Verlauf protokolliert. - Click-to-Call ist über HalloPetra technisch möglich, soweit deren API es erlaubt; ansonsten Fallback auf tel:-Link. - HalloPetra-spezifische Funktionen (z. B. Sprach-Bot-Skripte, KI-Vorqualifikation) bleiben in HalloPetra. HiveGrid zeigt das Ergebnis (Anruf-Log, Vorqualifikations-Tags) als Lead/Aktivitäts-Eintrag. - Klartext bei Verbindungs-Verlust: „Deine HalloPetra-Verbindung wurde unterbrochen, bitte erneut verbinden. [Verbindung erneuern]".

12.2 Click-to-Call aus Kontakten

12.2.1 Aus jeder Kontakt-, Deal- und Lead-Detail-Ansicht erreichbare "Anrufen"-Funktion. 12.2.2 Hat der Kontakt mehrere Telefonnummern: Auswahl-Dialog (Standard-Nummer voreingestellt). Bei nur einer Nummer: direkter Anruf. 12.2.3 Nach Klick klingelt das AirCall-Gerät des Mitarbeiters (Web-App, Mobile-App oder Tisch-Telefon). Der Mitarbeiter nimmt in AirCall ab, AirCall ruft den Kontakt. 12.2.4 Der ausgehende Anruf wird automatisch protokolliert (siehe 12.5). 12.2.5 Telefonnummern werden beim Speichern automatisch normalisiert (z.B. 0211 1234567 wird zu +492111234567). Standard-Land ist Deutschland (anpassbar pro Betrieb). 12.2.6 Fallback ohne AirCall: ist AirCall nicht verbunden, zeigt die Anrufen-Funktion einen normalen tel:-Link, der das Standard-Telefon des Geräts/Browsers öffnet. Kein Logging in diesem Fall (außerhalb HiveGrid). 12.2.7 Klartext-Fehler: "Du bist keinem AirCall-User zugeordnet. [Admin kontaktieren]" / "Dieser Kontakt hat keine Telefonnummer. [Nummer hinzufügen]" / "AirCall meldet ['Quote überschritten']. [Erneut versuchen]".

12.3 Anruf-Aufzeichnung

12.3.1 Aufzeichnungen werden bei AirCall gespeichert (kein eigenes Re-Hosting in HiveGrid in Phase 1). 12.3.2 Liegt eine Aufzeichnung vor, erscheint im Anruf-Detail im HiveGrid ein Link "Aufzeichnung anhören (öffnet AirCall)". 12.3.3 Aufzeichnungen haben bei AirCall eine Aufbewahrungsfrist (abhängig vom AirCall-Tarif); HiveGrid zeigt im UI bis wann der Link verfügbar ist.

12.4 KI-Transkription

12.4.1 Phase 1: keine automatische Transkription. Aufzeichnung muss manuell in AirCall gehört werden. 12.4.2 Phase 2: automatische Transkription über EU-konformen Spracherkennungs-Dienst (Whisper-EU auf europäischer Infrastruktur). Das Transkript erscheint als Auto-Notiz am Anruf, durchsuchbar im CRM. 12.4.3 Phase 2 ergänzt: Auto-Klassifikation der Notiz und automatische Tags ("Wartungs-Anfrage", "Reklamation", "Termin-Vereinbarung").

12.5 Anruf-Verknüpfung mit Kontakten (Auto-Match)

12.5.1 Bei eingehendem Anruf normalisiert HiveGrid die Anrufer-Nummer und sucht in der Kontakt-Datenbank. 12.5.2 Exakter Treffer (Nummer stimmt komplett überein): Anruf wird dem Kontakt mit hoher Sicherheit zugeordnet. 12.5.3 Teilweise-Treffer (letzte 8 Ziffern stimmen): Vorschlag mit Klartext "Vermutlich [Kontakt-Name], manuell bestätigen?". 12.5.4 Kein Treffer zur Kontakt-Datenbank: Suche zusätzlich in Leads. Bleibt es bei keinem Treffer, ist die Anrufer-Nummer als "Unbekannte Nummer" sichtbar (mit Funktion "Als neuen Kontakt anlegen"). 12.5.5 Deal-Verknüpfung über Kontakt: ist der Anrufer ein Kontakt mit genau einem offenen Deal, wird der Anruf diesem Deal vorgeschlagen. 12.5.6 Manuelle Korrektur im Anruf-Detail jederzeit möglich (anderem Kontakt/Lead/Deal/Projekt zuordnen). 12.5.7 Push-Benachrichtigung an den zugewiesenen Mitarbeiter beim eingehenden Anruf: "Eingehender Anruf von [Name oder Nummer]. [Kontakt öffnen]", Mitarbeiter kann Notizen vorbereiten, während der Anruf läuft. 12.5.8 Verpasste Anrufe werden als solche markiert (Notification an Mitarbeiter mit Berechtigung) und mit Funktion "Rückruf-Aufgabe anlegen".

12.6 Notizen nach dem Anruf

12.6.1 Direkt nach Anruf-Ende erscheint Hinweis: "Anruf beendet (3:45 Min), Notiz hinzufügen?". 12.6.2 Editor: einfacher Text mit Formatierungs-Möglichkeiten, Speichern. 12.6.3 Notizen werden im Aktivitäts-Verlauf des verknüpften Kontakts/Deals sichtbar. 12.6.4 Editierbar: Phase 1 jederzeit (mit Audit-Eintrag bei Änderung). Phase 2: nach 30 Tagen Read-only (anpassbar).

12.7 Anruf-Liste am Kontakt

12.7.1 Im Kontakt-Detail erscheint im Aktivitäts-Verlauf jeder Anruf mit Klartext: "Eingehender Anruf von Max Mustermann (3:45 Min)" / "Verpasster Anruf von +49..." / "Ausgehender Anruf von [Mitarbeiter] (5:12 Min)". 12.7.2 Aggregat-Statistik im Kontakt-Detail: "12 Anrufe geführt (8 ausgehend, 4 eingehend), Durchschnitt 4:23 Min". 12.7.3 Klick auf den Eintrag öffnet das Anruf-Detail (Notiz, Aufzeichnungs-Link, Tags).

12.8 Trigger für die Automation-Engine

12.8.1 Modul 17 kann auf Anruf-Ereignisse reagieren: Anruf eingegangen, Anruf angenommen, Anruf beendet, Anruf verpasst. 12.8.2 Beispiele für Geerkens: "Wenn Anruf > 2 Min mit unbekannter Nummer → Lead anlegen" / "Wenn verpasster Anruf während Bürozeit → Aufgabe für Backoffice 'Rückruf'" / "Wenn Anruf-Tag = 'Wartung' → Deal in Pipeline 'Service' anlegen". 12.8.3 Filter-Bedingungen pro Trigger (Richtung, Dauer, Kontakt-vorhanden).

12.9 Berechtigungen

12.9.1 Click-to-Call: der Mitarbeiter kann selbst anrufen. 12.9.2 Eigene Anrufe sehen: der Mitarbeiter sieht nur seine eigenen Anrufe. 12.9.3 Alle Anrufe sehen: Vorgesetzte sehen alle Anrufe im Betrieb. 12.9.4 Notizen schreiben (eigene / alle). 12.9.5 Telefonie-Admin: Verbindung einrichten, Mitarbeiter-Zuordnungen verwalten, Trigger konfigurieren.

12.10 Phase 2 / bewusst NICHT in Phase 1

12.10.1 Sipgate-Anbindung als zweiter Anbieter. 12.10.2 Anruf-Aufzeichnungs-Transkription über Whisper-EU. 12.10.3 Telefonieren direkt aus dem HiveGrid-Browser ohne externe AirCall-App. 12.10.4 Massen-Anrufe / Power-Dialer (Listen abarbeiten). 12.10.5 Anruf-Skripte / Vertriebsleitfaden im Click-to-Call-Kontext. 12.10.6 KI-Auto-Tags basierend auf Anruf-Notiz. 12.10.7 Reporting-Dashboard (Anruf-Volumen pro Team, Conversion-Rate).

12.11 Klartext-Fehlertexte (Beispiele)

12.11.1 "Deine AirCall-Verbindung wurde unterbrochen. [Erneut verbinden]" 12.11.2 "AirCall meldet 'Zugriff verweigert', möglicherweise wurde dein AirCall-Account aus der Company entfernt." 12.11.3 "Du bist keinem AirCall-User zugeordnet. [Admin kontaktieren]" 12.11.4 "Dieser Kontakt hat keine Telefonnummer hinterlegt. [Nummer hinzufügen]" 12.11.5 "Die Nummer [wert] konnte nicht angewählt werden. [Korrigieren]" 12.11.6 "AirCall ist nicht verbunden. [Tenant-Admin: Verbindung einrichten]"


Modul 13: Team-Chat

Was es tut: Interner Team-Chat in Echtzeit, der Slack/Teams/Quiply für die interne Kommunikation innerhalb von HiveGrid ablöst. Drei Ebenen: automatische Projekt-Channels (pro Projekt entsteht ein eigener Chat-Raum), Gruppen-Channels (Team-Süd, Außendienst, Lehrlinge, Notfall-Pikett), und Direkt-Nachrichten zwischen zwei Mitarbeitern. Nachrichten können auf Themen verzweigen (Threads), bekommen Reaktionen (Emojis), wichtige Nachrichten werden angeheftet, Dateien und Fotos werden direkt im Chat ausgetauscht und können mit einem Klick zu einer Aufgabe gemacht werden.

Löst ab: Quiply (Mitarbeiter-Chat) und teilweise Slack/Teams für die interne Kommunikation. Wichtige Klarstellung: Dies ist kein Slack-Konkurrent für die breite Welt, sondern eine Projekt-Kommunikations-Schicht direkt in HiveGrid. Das Ziel ist, dass Mitarbeiter HiveGrid nicht verlassen müssen, um über Projekte zu reden.

Warum es wichtig ist: Heute läuft die interne Kommunikation bei Geerkens über WhatsApp-Gruppen, Quiply und Excel-Listen. Wissen verschwindet in Privat-Chats und ist für neue Mitarbeiter nicht auffindbar. Mit Projekt-Chats wird jede Konversation zum Projekt automatisch dokumentiert.

13.1 Drei Ebenen (Projekt-Channel, Gruppe, Direktnachricht)

13.1.1 Projekt-Channel (Projekt): Wird bei jeder Projekt-Anlage automatisch erzeugt. Der Channel-Name ist der Projekt-Titel. Default-Mitglieder sind alle Projekt-Mitarbeiter inklusive Projektleiter. System-Nachricht zur Anlage: "Projekt angelegt von [Mitarbeiter] am [Datum]. PL: [Name]. Mitglieder: [Liste]". 13.1.2 Bei Mitarbeiter-Wechsel im Projekt wird der Channel automatisch synchronisiert (Hinzufügen/Entfernen mit System-Nachricht). 13.1.3 Bei Projekt-Abschluss oder -Stornierung wird der Channel 7 Tage später automatisch archiviert (anpassbar pro Pipeline). Read-only, bisherige Nachrichten bleiben lesbar. 13.1.4 Bei Projekt-Reaktivierung wird der Channel ebenfalls wieder aktiviert. 13.1.5 Pro Projekt maximal ein aktiver Projekt-Chat (kein Doppel-Anlage). 13.1.6 Gruppen-Channel: manuell angelegt durch Mitarbeiter mit Berechtigung. Beispiele: "Team Süd", "Außendienst-Allgemein", "Lehrlinge", "Notfall-Pikett". Optional privat (nur Mitglieder sehen) oder öffentlich (im Channel-Browser sichtbar, jeder kann beitreten). 13.1.7 Mitglieder-Verwaltung durch Channel-Admins; einzelne Mitglieder können verlassen (außer der letzte Admin, Klartext-Block: "Du bist der einzige Admin. Bitte einen anderen Mitarbeiter zum Admin ernennen oder den Channel archivieren, bevor du gehst"). 13.1.8 Direkt-Nachricht (DM): Zwei-Personen-Chat. Anlage über User-Auswahl. Existiert bereits ein DM zwischen den beiden, wird er wiederverwendet (kein Duplikat). Lese-Bestätigungen sofort sichtbar pro Nachricht. 13.1.9 Gruppen-DMs (3+ Personen) sind Phase 2. In Phase 1 wird ein Gruppen-Channel angelegt. 13.1.10 Tenant-Admins sehen Direkt-Nachrichten anderer Mitarbeiter nicht standardmäßig. Nur bei explizitem Audit-Antrag mit Pflicht-Begründung (geloggt im Audit-Trail), z.B. bei Compliance-Anfragen.

13.2 Reactions, Threads, Pinned

13.2.1 Reaktionen (Emojis): Per Klick auf eine Nachricht öffnet sich der Emoji-Picker. Andere sehen die Reaktion sofort. Klick auf eigene Reaktion entfernt sie. Maximal 20 verschiedene Emojis pro Nachricht (Anti-Spam), maximal 8 eigene Reaktionen pro Nachricht. 13.2.2 Threads (Themen-Verzweigung): Auf jede Nachricht kann "Im Thread antworten" geklickt werden. Der Thread öffnet sich als Seiten-Bereich oder eigene Ansicht und enthält die Eltern-Nachricht und alle Antworten chronologisch. Im Haupt-Verlauf zeigt die Eltern-Nachricht einen Indikator: "X Antworten, letzte Antwort vor [Zeit]". 13.2.3 Thread-Antworten erscheinen standardmäßig nicht im Haupt-Verlauf (Slack-Pattern). Optionaler Toggle "Auch im Hauptverlauf zeigen". 13.2.4 Thread-Benachrichtigungen gehen nur an Thread-Teilnehmer und bei expliziter Erwähnung. 13.2.5 Angeheftete Nachrichten (Pinned): Wichtige Nachrichten werden an den Channel angeheftet (Adressen, Material-Listen, Notrufnummern, Zugangsdaten Baustelle). Maximal 50 Pins pro Channel. Pinnen erfordert Channel-Admin-Status oder eigene Nachricht des Verfassers.

13.3 Erwähnungen (Mentions)

13.3.1 Tipp-Trigger ist @. Auto-Vervollständigung schlägt vor: Mitarbeiter (im Channel + im Betrieb), Projekte, Deals, Kontakte, Firmen. 13.3.2 Erwähnung eines Mitarbeiters erzeugt eine sofortige Benachrichtigung an ihn (auch wenn der Channel auf "stumm" steht, DMs und Erwähnungen kommen immer durch). 13.3.3 Erwähnung eines Projekts/Deals/Kontakts/Firma wird zu einem klickbaren Chip. Klick navigiert zur Detail-Ansicht. Zusätzlich entsteht im Aktivitäts-Verlauf der erwähnten Entität ein Eintrag: "[Mitarbeiter] hat im Chat [Channel-Name] über dich gesprochen: [Snippet]". 13.3.4 Spezial-Erwähnungen: @channel benachrichtigt alle Mitglieder, @here nur die aktuell online sind. Bei Channels mit mehr als 25 Mitgliedern erscheint eine Bestätigungs-Frage: "Damit benachrichtigst du 47 Personen. Trotzdem?". 13.3.5 Berechtigungs-bewusst: nicht-sichtbare Entitäten erscheinen nicht in der Auto-Vervollständigung.

13.4 Datei-Anhänge

13.4.1 Datei-Upload aus dem Schreib-Bereich (Drag-&-Drop oder Datei-Auswahl). Mehrfach-Upload möglich. 13.4.2 Bilder werden inline als Vorschau angezeigt (Klick öffnet Vollbild-Ansicht). Videos zeigen Vorschau mit Abspiel-Schaltfläche. PDFs/Office-Dateien als Karte mit Vorschau-Link. Andere Dateitypen mit allgemeinem Datei-Symbol. 13.4.3 In Projekt-Channels werden hochgeladene Dateien automatisch zusätzlich in der Projekt-Datei-Übersicht (Modul 4 / 23) abgelegt, sie tauchen also auch im Datei-Tab des Projekts auf. 13.4.4 In Gruppen- und DM-Channels gibt es eine Funktion "In Projekt-Dateien speichern", die die Datei in einen wählbaren Projekt-Datei-Bereich kopiert. 13.4.5 Dateigrößen- und Typ-Limits werden zentral in Modul 23 (Dateien) konfiguriert. 13.4.6 Foto-Direkt-Aufnahme auf dem Mobiltelefon: Kamera öffnen, Foto machen, mit einem Tippen senden. Optional: Datum/Uhrzeit/GPS-Koordinaten als Auto-Bildunterschrift (Default aus, GPS nur mit Mitarbeiter-Erlaubnis). 13.4.7 Sprach-Notizen auf dem Mobiltelefon: Aufnahme-Schaltfläche gedrückt halten, loslassen sendet. Audio als Anhang. Phase 2 ergänzt automatisches Transkript (Whisper-EU).

13.5 Echtzeit-Verbindung und Lese-Bestätigungen

13.5.1 Nachrichten erscheinen bei allen Mitgliedern in Echtzeit (Echtzeit-Verbindung im Hintergrund). 13.5.2 Lese-Bestätigungen: Bei DMs sichtbar "gelesen um [Zeit]". Bei Gruppen/Projekt-Chats Aggregat "X von Y gelesen" (Klick zeigt Liste der Gelesen-/Ungelesen-Personen). 13.5.3 Tipp-Indikator: "Max tippt..." erscheint, während ein anderer Mitarbeiter schreibt. 13.5.4 Anwesenheitsstatus: Online / Abwesend (5 Min ohne Aktivität) / Offline. Sichtbar in Mitglieder-Listen. 13.5.5 Verbindungs-Verlust: Banner "Verbindung unterbrochen, versuche Neuaufbau...". Bei erfolgreicher Wiederherstellung: kurzer Hinweis "Wieder verbunden", verpasste Nachrichten werden nachgeladen.

13.6 Übersicht und Suche

13.6.1 Sidebar-Punkt "Chat" mit Ungelesen-Zähler über alle eigenen Channels. 13.6.2 Channel-Übersicht zeigt pro Channel: Name, letzte Nachricht (gekürzt), Zeitstempel, Ungelesen-Zähler, Erwähnungs-Indikator (separat hervorgehoben), Anpinnen-Marker, Stumm-Marker. 13.6.3 Default-Sortierung: Letzte Nachricht oben, angepinnte Channels ganz oben. 13.6.4 Filter: Channel-Typ (Projekt/Gruppe/DM), nur ungelesene, nur mit Erwähnungen, Projekt-Status, Tag. 13.6.5 Cross-Channel-Suche durchsucht alle eigenen Channels (Volltext über Nachrichten und Channel-Namen). 13.6.6 Eigener Bereich "Meine Erwähnungen" listet alle aktiven @-Erwähnungen auf den Mitarbeiter über alle Channels. 13.6.7 Channel-Browser zeigt öffentliche Gruppen-Channels zum Beitreten.

13.7 Bearbeiten und Löschen

13.7.1 Eigene Nachrichten können innerhalb von 24 Stunden nach Versand editiert werden. Editiert-Marker erscheint. Nach 24h ist Editieren gesperrt (außer Tenant-Admin). 13.7.2 Eigene Nachrichten können vom Verfasser, Channel-Admin oder Tenant-Admin gelöscht werden. Im Verlauf bleibt ein Lösch-Platzhalter "Nachricht gelöscht".

13.8 Aufgabe aus Nachricht erstellen ("Mark as Task")

13.8.1 Pro Nachricht erreichbare Funktion "Aus Nachricht Aufgabe erstellen". 13.8.2 Öffnet ein Aufgabe-Anlage-Fenster mit voreingestelltem Titel (erste Zeile / 80 Zeichen) und Beschreibung (kompletter Nachrichten-Text). 13.8.3 Bei Projekt-Channel: Aufgabe wird automatisch dem Projekt zugeordnet. 13.8.4 Nach Bestätigung erscheint unter der Quell-Nachricht eine System-Antwort: "[Mitarbeiter] hat aus dieser Nachricht eine Aufgabe erstellt: [Titel] → [Link]". 13.8.5 Erfordert Aufgaben-Schreib-Berechtigung (Modul 26).

13.9 Mobile-First für Monteure (LP-2)

13.9.1 Monteur-Smartphone-Bedienung mit Handschuhen optimiert: Schreib-Bereich prominent in der Daumen-Zone. 13.9.2 Ein-Tipp-"Foto senden" (öffnet Kamera direkt). 13.9.3 Sprach-Notiz-Funktion (gedrückt halten, loslassen sendet). 13.9.4 Reduzierte Channel-Übersicht: Default-Filter "Aktive Projekt-Chats + DMs mit Erwähnungen". 13.9.5 Vereinfachte Threads (linear statt Seiten-Bereich). 13.9.6 Push-Benachrichtigungen mit Schnell-Antwort-Funktion (direkt aus der Benachrichtigung schreiben, Phase 2 nativ, Phase 1 öffnet Channel). 13.9.7 Benachrichtigungs-Inhalt enthält nur: Channel-Name, Absender-Vorname, max. 100 Zeichen Vorschau. Keine Adressen, keine Kunden-Details (Datenschutz auf dem Sperrbildschirm). 13.9.8 Tenant-Einstellung "Push-Vorschau im Sperrbildschirm" (Default an, Aus = nur "Neue Nachricht").

13.10 Berechtigungen

13.10.1 Eigene Channels lesen: der Mitarbeiter sieht Channels, in denen er Mitglied ist. 13.10.2 Schreiben: der Mitarbeiter kann Nachrichten senden, reagieren, Threads, Datei-Uploads, Aufgaben aus Nachrichten erstellen. 13.10.3 Channels anlegen: Gruppen-Channels erstellen. 13.10.4 DMs starten. 13.10.5 Chat-Admin: globale Admin-Rechte über alle Channels (Force-Edit, Force-Archive, Force-Delete). 13.10.6 Alle Channels lesen (Audit): Tenant-Admin-Sicht für Compliance-Zwecke. Jeder Lese-Zugriff wird audit-geloggt mit Pflicht-Begründung.

13.11 Phase 2 / bewusst NICHT in Phase 1

13.11.1 Gruppen-DMs mit 3+ Personen ohne Channel-Anlage. 13.11.2 Eigene Emoji-Codes pro Betrieb (in Phase 1 nur Standard-Emojis). 13.11.3 Tägliche Email-Zusammenfassung verpasster Erwähnungen. 13.11.4 Sprach-/Video-Anrufe direkt im Chat. 13.11.5 Slack-/Teams-Brücke. 13.11.6 Bots / Slash-Befehle (/befehl). 13.11.7 Ende-zu-Ende-Verschlüsselung (Phase 1: serverseitige Verschlüsselung im Ruhezustand). 13.11.8 Erweiterte Suche (nach Verfasser, Datum, Erwähnungs-Typ). 13.11.9 "Später senden" für Nachrichten. 13.11.10 Drag-Reorder von angepinnten Nachrichten. 13.11.11 KI-Auto-Übersetzung (DE↔PL/EN/UA für mehrsprachige Teams, PL-Monteur schreibt PL, Büro liest DE). 13.11.12 KI-Tageszusammenfassung "Was war heute wichtig?". 13.11.13 KI-Schnell-Antwort-Vorschläge. 13.11.14 Sprach-Notiz-Volltextsuche im Transkript. 13.11.15 Native iOS/Android-Apps (Phase 1: PWA mit Web-Push). 13.11.16 Native Schnell-Antwort aus Push-Benachrichtigung.

13.12 Klartext-Fehlertexte (Beispiele)

13.12.1 "Du bist noch in keinem Channel. Lege einen neuen an oder warte auf eine Einladung." 13.12.2 "Noch keine Nachrichten. Schreib die erste!" 13.12.3 "Du bist kein Mitglied dieses Channels." 13.12.4 "Dieser Channel ist archiviert. Du kannst lesen, aber nicht mehr schreiben. [Reaktivieren]" 13.12.5 "Verbindung unterbrochen, versuche Neuaufbau..." 13.12.6 "Damit benachrichtigst du 47 Personen. Trotzdem?" 13.12.7 "Editieren ist nur innerhalb 24 Stunden möglich." 13.12.8 "Datei [Name] ist zu groß ([X] MB von max. [Y] MB)." 13.12.9 "Dateityp [.exe] ist nicht erlaubt." 13.12.10 "Du bist der einzige Admin in diesem Channel. Bitte einen anderen Mitarbeiter zum Admin ernennen, bevor du gehst." 13.12.11 "Browser-Benachrichtigungen sind deaktiviert. In den Browser-Einstellungen aktivieren um wichtige Erwähnungen zu erhalten."


Modul 22: Notifications

Was es tut: Drei-Kanal-Benachrichtigungs-System: Push aufs Mobiltelefon, Email und In-App-Glocke (Notification-Center). Pro Mitarbeiter pro Ereignis-Typ einstellbar (welche Kanäle, welche Priorität). Eigene Ruhezeiten (z.B. 22:00–07:00 keine Push). Anti-Spam-Bündelung (statt 23 Einzel-Pushes "23 neue Leads").

Löst ab: Notification-Funktionen aus HubSpot, Quiply, Slack, vereinheitlicht in einer zentralen Stelle.

Warum es wichtig ist: Ohne klare Benachrichtigungs-Strategie wird HiveGrid zur Lärm-Quelle (Mitarbeiter werden 100x am Tag gepiept und schalten alles aus). Mit Pro-Mitarbeiter-Einstellungen und Bündelung bleibt das System nützlich.

22.1 Kanäle (Push, Email, In-App)

22.1.1 In-App (Glocke): Glocken-Symbol in der Kopfzeile mit Ungelesen-Zähler. Klick öffnet das Notification-Center mit allen Benachrichtigungen. Default-Kanal, der für jede Benachrichtigung aktiv ist und nicht deaktiviert werden kann (er ist "die Wahrheit"). Aktualisierung in Echtzeit. 22.1.2 Email: Versand über die in Modul 9 verifizierte Sende-Domain mit Betriebs-Branding (Logo, Hauptfarbe). Pro gebündeltes Ereignis eine Email mit zusammengefasstem Inhalt. Standard-Footer "Du bekommst diese Email weil [...], [Benachrichtigungs-Einstellungen]". 22.1.3 Mobile-Push: Push aufs Smartphone (iPhone via Apple-Push, Android via Google-Push) über die HiveGrid-Mobile-App. Push-Inhalt enthält Kurz-Titel, Beschreibung, Vertiefungs-Link und (wenn gebündelt) Anzahl. Apple-konformer Berechtigungs-Ablauf: Ersteinsatz-Erklärungs-Screen "Warum brauchen wir Push?", danach Standard-Berechtigungs-Dialog. 22.1.4 Bei verweigerter Push-Berechtigung erscheint Klartext im Einstellungs-Bereich: "Push ist auf diesem Gerät deaktiviert. [Geräte-Einstellungen öffnen]".

22.2 Anti-Spam-Bündelung (kritisch: verhindert Notification-Storm)

22.2.1 Grundregel: Mehrere gleichartige Benachrichtigungen an denselben Mitarbeiter innerhalb von 5 Minuten werden zu einer Sammel-Benachrichtigung gebündelt. Beispiel: Statt 23 einzelner Pushes "Neuer Lead" kommt eine Push: "23 neue Leads in den letzten 5 Min, [Lead-Inbox öffnen]". 22.2.2 Im Notification-Center: alle Einzel-Benachrichtigungen bleiben einzeln sichtbar (Wahrheit), aber der Echtzeit-Hinweis (Toast/Badge) erscheint nur einmal. 22.2.3 Bei Email: eine Sammel-Email pro Bündel, nicht 23 einzelne. 22.2.4 Bündel-Fenster ist gleitend: Bei jedem neuen Ereignis innerhalb von 5 Min wird der Zähler erhöht. Nach 5 Min ohne neues Ereignis wird das Bündel geschlossen und (falls Push noch nicht raus war) versendet. 22.2.5 Maximale Bündel-Größe: 100 Ereignisse, danach wird ein neues Bündel begonnen. 22.2.6 Beispiele für Bündelung: - 23 neue Leads in 4 Min → 1 Push: "23 neue Leads in den letzten 5 Minuten" - 7 Aufgaben in 5 Min an Monteur zugewiesen → 1 Push: "7 neue Aufgaben" - 50 Chat-Nachrichten in 5 Min im Projekt-Channel → 1 Push: "50 neue Nachrichten in 'Müller Heizung'" 22.2.7 Bündelungs-Ausnahmen: Dringende Benachrichtigungen (urgent-Priorität) werden nie gebündelt, sofortiger Versand. Direkt-Erwähnungen im Chat (@user) werden nie mit anderen Erwähnungen gebündelt. Sicherheits-Benachrichtigungen (Login von neuem Gerät, Passwort geändert, 2FA deaktiviert) werden nie gebündelt. 22.2.8 Pro-Mitarbeiter-Limit: maximal 10 Pushes pro Stunde (Rest gebündelt), verhindert auch bei kaputten Automationen einen Push-Sturm aufs Smartphone. 22.2.9 Tenant-Admin-Konfiguration des Bündel-Fensters pro Ereignis-Gruppe ist Phase 2.

22.3 Ruhezeiten

22.3.1 Pro Mitarbeiter konfigurierbar: Wochentag(e), Start-Zeit, End-Zeit, optional "Auch dringende Benachrichtigungen zurückhalten" (Default aus, dringende kommen durch). 22.3.2 Schnell-Auswahl: "Werktags", "Wochenende", "Täglich". Mehrere Ruhezeiten parallel möglich. 22.3.3 Ein Master-Schalter "Ruhezeiten aktiv" für Urlaub-Aussetzen. 22.3.4 Default-Ruhezeit beim Onboarding für Mobile-Push: täglich 22:00–07:00 + Wochenende ganztägig, dringende Benachrichtigungen kommen trotzdem durch. 22.3.5 Wirkung: Während Ruhezeit eingehende Benachrichtigungen werden: - In-App: sofort sichtbar im Center (kein Pop-up, kein Sound) - Email + Push: gepuffert bis Ruhezeit-Ende, dann mit aktualisiertem Bündel-Zähler versendet 22.3.6 Override-Hierarchie (höchste Priorität zuerst): Channel-Stumm → Ruhezeit → Mitarbeiter-Standard → Channel-Standard.

22.4 Notification-Center

22.4.1 Listen-Anzeige aller Benachrichtigungen (Drawer oder Seite) mit pro Eintrag: Titel, kurzer Beschreibungs-Text, Datum/Zeit, Auslöser (Avatar oder System-Marker), Vertiefungs-Indikator, Lese-Status, Priorität, bei Bündel "X Ereignisse, [Alle anzeigen]". 22.4.2 Tabs/Filter: Alle / Ungelesen / Markiert. Filter nach Ereignis-Typ, Auslöser, Zeitraum, Priorität. Suche über Titel + Beschreibung. 22.4.3 Aktionen pro Eintrag: Als gelesen / ungelesen markieren, Wegklicken, Klick öffnet Vertiefungs-Link (markiert automatisch als gelesen). Bündel-Eintrag "Alle anzeigen" expandiert. 22.4.4 Bulk-Aktionen: Alle markieren, alle gelesen, mehrere wegklicken. Bei mehr als 50 ungelesenen Bestätigungs-Frage: "124 Benachrichtigungen als gelesen markieren? [Bestätigen] [Abbrechen]". 22.4.5 Alter-Filter: Default zeigt 90 Tage. Älter wird ausgeblendet (Auto-Hard-Lösch ist Phase 2).

22.5 Abo-Verwaltung pro Nutzer

22.5.1 Pro Mitarbeiter Übersicht aller Ereignis-Typen, gruppiert nach Modul (CRM, Leads, Projekte, Aufgaben, Termine, Chat, ...). 22.5.2 Pro Ereignis-Typ: Schalter pro Kanal (In-App, Email, Push) und Prioritäts-Schwelle (Alle / Normal+ / Hoch+ / Nur dringend). 22.5.3 Master-Schalter "Alle Email aus" mit Klartext: "Du erhältst keine Email-Benachrichtigungen mehr, auch nicht für neue Ereignis-Typen, die wir später hinzufügen. Wichtige Sicherheits-Mails (Login, Passwort) bleiben immer aktiv." 22.5.4 Funktion "Auf Standard für meine Rolle zurücksetzen". 22.5.5 Standard-Sets pro Rolle beim Onboarding: - Vertriebler: In-App + Push für Lead-/Deal-Ereignisse - Projektleiter: In-App + Push für Projekt-/Aufgaben-Ereignisse, Email für Termin-Erinnerungen - Monteur: In-App + Push für Aufgaben-Zuweisungen, Plantafel-Änderungen, Abnahme-Anfragen; Email aus - Büro/Backoffice: alle Kanäle für Eingang-Ereignisse (Lead, Mail, Formular) - GF: tägliche Email-Zusammenfassung (Phase 2), Push für Eskalationen - Marketing: Email für Kampagnen-Status, In-App für Lead-Ereignisse 22.5.6 Standards sind als deklarative Branchen-Vorlagen austauschbar (LP-3).

22.6 Mobile-Geräte-Verwaltung

22.6.1 Übersicht aller registrierten Mobile-Geräte des Mitarbeiters (iPhone-X, Samsung-Y) mit Status (aktiv / inaktiv > 30 Tage / abgemeldet). 22.6.2 Pro Gerät: Test-Push senden, Umbenennen, Abmelden. 22.6.3 Bei keinem Gerät: "Noch kein Mobile-Gerät verbunden, installiere die HiveGrid-App und logge dich ein, um Push zu erhalten. [App-Store-Link]". 22.6.4 Auto-Abmelde bei: Push-Versand-Fehler "Token ungültig", Mitarbeiter-Logout, Mitarbeiter-Deaktivierung. 22.6.5 Tenant-Admin sieht nicht die Geräte anderer Mitarbeiter (Privatsphäre).

22.7 Was kann eine Benachrichtigung auslösen (Auszug)

22.7.1 Lead: angelegt, mir zugewiesen, Antwort erhalten, als Spam markiert, Quell-Anomalie. 22.7.2 Deal: mir zugewiesen, Stufenwechsel, gewonnen, verloren, Eskalation bei Stillstand. 22.7.3 Projekt/Aufgabe: mir zugewiesen, Stufenwechsel, Abnahme-Anfrage, Aufgabe fällig, Aufgabe überfällig. 22.7.4 Termin: geplant, 24h-Erinnerung, 1h-Erinnerung, abgesagt, verschoben. 22.7.5 Chat: Direkt-Erwähnung, DM erhalten, Thread-Antwort. 22.7.6 Email/Anruf: persönliche Mail erhalten, Mail-Bounce, verpasster Anruf, Sprach-Nachricht. 22.7.7 Automation: Ausführung fehlgeschlagen, Vorschau-Lauf abgeschlossen, Limit erreicht. 22.7.8 Sicherheit: Login von neuem Gerät (hoch), Passwort geändert (hoch), 2FA deaktiviert (dringend), diese sind nie deaktivierbar und nie gebündelt. 22.7.9 Customer-Portal: Endkunde hat kommentiert / freigegeben / Datei hochgeladen. 22.7.10 Integrations: KWP-Synchronisation fehlgeschlagen, KWP-Schema-Abweichung erkannt. 22.7.11 Abrechnung: Tenant eingefroren, Zahlung fehlgeschlagen, Audit-Export fertig.

22.8 Versand-Pipeline (knapp)

22.8.1 Bei Versand-Fehler werden transiente Fehler bis zu 3-mal mit Pause wiederholt (SMTP-Timeout, Push-Server-Überlast). Permanente Fehler (Token ungültig, Adresse nicht existent) werden nicht wiederholt. 22.8.2 Bei wiederholtem Email-Bounce eines Mitarbeiters wird der Email-Kanal für ihn 7 Tage pausiert mit Klartext im Notification-Center: "Emails an dich kommen aktuell nicht an, bitte Email-Adresse prüfen". 22.8.3 EU-Versand (LP-13): SMTP über EU-Provider, Push über EU-gehosteten Vermittler (Apple/Google sind die letzten Endpunkte und nicht vermeidbar, Push-Inhalt enthält aber keine sensiblen Personen-Daten).

22.9 Berechtigungen

22.9.1 Self-Scope ist Standard: jeder Mitarbeiter sieht und verwaltet nur eigene Benachrichtigungen, Einstellungen und Geräte. 22.9.2 Notification-Admin: Email-Vorlagen ansehen, Test-Benachrichtigungen senden, in Phase 2 Bündel-Einstellungen ändern.

22.10 Phase 2 / bewusst NICHT in Phase 1

22.10.1 Tägliche Email-Zusammenfassung (statt Einzel-Mails). 22.10.2 Schlummern-Funktion (Benachrichtigung in X Stunden wieder im Center). 22.10.3 WhatsApp als 4. Kanal. 22.10.4 Tenant-Admin-konfigurierbare Bündel-Fenster. 22.10.5 Tenant-Admin-konfigurierbare Email-Vorlagen. 22.10.6 Zeitfenster-Regeln ("Lead-Benachrichtigungen nur Mo-Fr 8-18"). 22.10.7 Cross-Geräte-Lesen-Sync (Mark-as-read auf Desktop schließt Push-Banner auf Mobile). 22.10.8 Anomalie-Auto-Pause (KI erkennt Notification-Storms). 22.10.9 Custom-Sounds pro Priorität. 22.10.10 Anpinnen wichtiger Benachrichtigungen im Center. 22.10.11 Auto-Aufräumen alter Benachrichtigungen (>90 Tage hart löschen). 22.10.12 Web-Push als 4. Kanal (für Mitarbeiter ohne Mobile-App).

22.11 Klartext-Fehlertexte (Beispiele)

22.11.1 "Keine Benachrichtigungen, sobald etwas Wichtiges passiert, erscheint es hier." 22.11.2 "Emails an dich kommen aktuell nicht an, bitte Email-Adresse prüfen. [Profil]" 22.11.3 "Push ist auf diesem Gerät deaktiviert. [Geräte-Einstellungen]" 22.11.4 "Du bekommst keine Email-Benachrichtigungen mehr (außer Sicherheit). [Wieder aktivieren]" 22.11.5 "Diese Ruhezeit überschneidet sich mit '[X]', Vereinigung der Fenster aktiv." 22.11.6 "Push-Test fehlgeschlagen, möglicherweise wurden Push-Berechtigungen am Gerät widerrufen." 22.11.7 "Benachrichtigungs-Versand zeigt ungewöhnliches Aufkommen (5x normal). Bitte Automationen prüfen, möglicherweise Loop. [Automation-Studio]"


Modul 25: Calendar-Sync

Was es tut: Bidirektionale Synchronisation zwischen HiveGrid-Terminen (Booking, Projekt-Termine, Plantafel-Einträge) und externen Kalendern (Google Calendar, Microsoft Outlook). Termine, die im HiveGrid entstehen, erscheinen automatisch im Google-/Outlook-Kalender des Mitarbeiters. Externe Termine (private Termine, andere Meetings) kommen umgekehrt nur als "belegt" ins HiveGrid, damit das Booking-Modul keine Doppel-Buchungen anbietet. Die Anbindung erfolgt pro Mitarbeiter (jeder verbindet seinen eigenen Kalender), nicht pro Betrieb.

Löst ab: Standalone-Nutzung von Google Calendar bei Geerkens (teilweise, Geerkens behält Google Workspace, aber HiveGrid wird die Termin-Wahrheit).

Warum es wichtig ist: Ohne Kalender-Sync sind Mitarbeiter gezwungen, Termine in beiden Systemen zu pflegen, was in der Praxis dazu führt, dass nur einer aktuell ist. Doppelt-Eintragungen, Doppel-Buchungen und verpasste Termine sind die Folge.

25.1 Bidirektional Google + Microsoft (Pflicht in Phase 1)

25.1.1 Phase 1 unterstützt Google Calendar (inkl. Google Workspace) und Microsoft Outlook / Microsoft 365 Calendar. Beide voll bidirektional. 25.1.2 Bidirektional ist Phase-1-Pflicht (nicht Phase 2): HiveGrid → extern UND extern → HiveGrid sind beide ab Tag 1 verfügbar. 25.1.3 Der Mitarbeiter kann pro Anbieter eine Verbindung haben (z.B. Google + Microsoft parallel, falls geschäftlich Outlook und privat Gmail). Ein interner HiveGrid-Termin wird dann in beide externe Kalender gespiegelt. 25.1.4 Phase 2: Apple/iCloud-Calendar, FastMail, iCal-Feed (read-only).

25.2 OAuth pro Nutzer (jeder verbindet selbst)

25.2.1 Verbindung wird pro Mitarbeiter in Einstellungen → Integrationen → Kalender aufgebaut. Keine Tenant-zentrale Verbindung in Phase 1. 25.2.2 Mitarbeiter klickt "Google Calendar verbinden" / "Outlook verbinden" → offizielles Anbieter-Login-Fenster → erteilt HiveGrid Zugriff auf die Kalender. 25.2.3 Notwendige Berechtigungen: Lesen und Schreiben von Kalender-Events, Email + Profil zur Identifikation. 25.2.4 Nach erfolgreicher Verbindung listet HiveGrid alle verfügbaren externen Kalender (Primary, weitere) auf und fragt, welche synchronisiert werden sollen. Standard: Haupt-Kalender. 25.2.5 Bei Microsoft mit IT-Admin-gesperrtem Tenant erscheint Klartext: "Dein IT-Admin muss diese Verbindung zuerst genehmigen. [Admin-Genehmigungs-Link kopieren]". 25.2.6 Übersicht zeigt verbundene Konten mit Email, Anbieter, Status (aktiv / pausiert / Fehler / widerrufen) und Datum der letzten Synchronisation. 25.2.7 Verbindung trennen widerruft den Zugriff beim Anbieter und löscht den Kalender-Cache. Optional kann der Mitarbeiter wählen, ob die bisher synchronisierten Termine im externen Kalender bleiben oder dort gelöscht werden. 25.2.8 Die Anmeldungs-Tokens sind verschlüsselt im Ruhezustand gespeichert. Refresh läuft automatisch im Hintergrund. 25.2.9 Bei Token-Widerruf durch den Mitarbeiter (z.B. in den Google-Sicherheitseinstellungen) erscheint Klartext-Banner und Email: "Verbindung zu Google Calendar ist abgelaufen, bitte erneut verbinden, damit deine Termine weiter synchronisiert werden. [Neu verbinden]". 25.2.10 Beim Off-Boarding eines Mitarbeiters (Modul 27) werden seine Kalender-Verbindungen automatisch pausiert; bei Hard-Lösch hart entfernt.

25.3 Welche Events synchronisiert werden

Von HiveGrid in den externen Kalender (Schreib-Pfad):

25.3.1 Booking-Termine (Modul 6): Bei jedem Booking gegen einen Mitarbeiter mit aktiver Kalender-Verbindung wird automatisch ein Spiegel-Event im externen Kalender erstellt. 25.3.2 Projekt-Termine (Modul 4): Pro Termin entscheidet der Mitarbeiter über eine Schalter-Funktion "In meinen Kalender eintragen". 25.3.3 Plantafel-Einträge (Modul 4): Wenn der Mitarbeiter über Mitarbeiter-Einstellung "Plantafel auch im externen Kalender" aktiv hat (Default an). 25.3.4 Aufgaben mit Fälligkeit (Modul 26): optional als ganztägiger Eintrag (Default aus, anpassbar pro Mitarbeiter). 25.3.5 Termine aus Verkaufsfällen / Setter-Closer-Workflow (Modul 3, siehe 3.9.5) [N17, 09.05.2026]: aus dem Verkaufsfall-Detail wird ein Termin für eine andere Person im Mandanten angelegt. Verkaufsfall-Daten (Kunde, Adresse, Volumen, Anlagen-Typ, Fotos) werden in einem mandanten-konfigurierbaren festen Layout in den Termin übernommen. Setter terminiert in 30 Sekunden, Closer hat alle Infos beim Vor-Ort-Termin im Kalender. 25.3.6 Übertragene Felder: Titel (z.B. "Kundentermin Schmidt", "Projekt Heizung Schmidt, Montage Tag 2"), Beschreibung mit Link zurück zu HiveGrid, Adresse aus Projekt/Kunde/Verkaufsfall, Start/Ende/Zeitzone, Teilnehmer (bei Booking wird der Endkunde als Teilnehmer eingeladen, konfigurierbar pro Booking-Seite).

Vom externen Kalender ins HiveGrid (Lese-Pfad, nur für Verfügbarkeits-Berechnung):

25.3.6 Externe Termine werden read-only ins HiveGrid übernommen, ausschließlich um die Verfügbarkeit für Booking und Plantafel zu berechnen. 25.3.7 Sync-Fenster: vergangene 7 Tage + nächste 60 Tage (rollend, in Phase 2 anpassbar). 25.3.8 Privatsphäre: Externe private Termine (mit "Privat"-Markierung beim Anbieter) werden synchronisiert, aber der Titel wird auf "Privat" reduziert. Sie zählen als "belegt" für die Verfügbarkeits-Berechnung. 25.3.9 Nicht synchronisiert: externe Termine mit Status "Frei", abgesagte Termine, Termine außerhalb des Sync-Fensters. 25.3.10 Sichtbarkeit: Externe Event-Inhalte sind nur für den Mitarbeiter selbst und einen Tenant-Admin mit Audit-Berechtigung sichtbar. Niemals für andere Mitarbeiter im Betrieb. Im Booking-/Plantafel-Kontext erscheinen externe Termine nur als "belegt zwischen X und Y", kein Titel-/Inhalts-Leak.

25.4 Konflikt-Auflösung

25.4.1 Synchronisation läuft über Push-Benachrichtigungen vom Anbieter (kein Polling). Push-Abos werden automatisch erneuert (Google ~1 Woche, Microsoft ~3 Tage). 25.4.2 Bei Push-Ausfall Fallback auf 30-Minuten-Polling mit Klartext-Hinweis: "Push-Benachrichtigungen von [Anbieter] sind gerade nicht aktiv. Synchronisation läuft alle 30 Minuten als Sicherheitsnetz.". 25.4.3 Konflikt-Szenario 1: Mitarbeiter editiert Termin im HiveGrid, gleichzeitig editiert ihn jemand im externen Kalender. - HiveGrid versucht den Update zu pushen, wird vom Anbieter mit "Termin wurde inzwischen geändert" abgelehnt. - Standard-Auflösung: externer Stand gewinnt. Der HiveGrid-Edit wird verworfen, der Mitarbeiter bekommt Klartext-Notification: "Dein Termin '[Titel]' wurde gleichzeitig in [Anbieter] geändert, die externe Version wurde übernommen. Du kannst die Änderung manuell wieder einarbeiten. [Original-HiveGrid-Stand anzeigen]". - Der Mitarbeiter kann den verworfenen Stand einsehen und manuell nachziehen. 25.4.4 Konflikt-Szenario 2: Externer Termin gelöscht, HiveGrid hat noch eine Spiegelung. - Spiegelung wird entfernt, der interne Termin (z.B. Booking) bleibt in HiveGrid bestehen. - Klartext: "Der Termin wurde im externen Kalender gelöscht. In HiveGrid bleibt er bestehen. [Im externen Kalender wieder anlegen]". 25.4.5 Konflikt-Szenario 3: HiveGrid-Termin gelöscht. - HiveGrid pusht den Lösch-Befehl an alle gespiegelten externen Kalender. - Falls der externe Termin bereits geändert/gelöscht wurde, wird das stillschweigend hingenommen. 25.4.6 Konflikt-Übersicht in der Kalender-Verbindungs-Detail-Ansicht: Liste der letzten 50 Konflikte mit Klartext und Auflösung. 25.4.7 Wichtige Konflikte (z.B. extern überschriebener Booking-Termin) erzeugen zusätzlich eine Push-Benachrichtigung an den Mitarbeiter (Modul 22).

25.5 Anti-Doppel-Buchung beim Booking

25.5.1 Die Booking-Seite (Modul 6) berechnet verfügbare Slots eines Mitarbeiters auf Basis von: dessen Arbeitszeiten, eigene HiveGrid-Termine, externe Termine mit "Belegt"-Status, Plantafel-Einträge. 25.5.2 Endkunden bekommen niemals den Inhalt externer Termine zu sehen, die Booking-Seite erhält nur "Slot ist frei / belegt". 25.5.3 In seltenen Fällen kann ein externer Termin während eines reservierten Slots erscheinen (Sync-Verzögerung). Der Endkunde wird mit Klartext-Notification informiert und um Re-Buchung gebeten. Realistisch nur bei extremer Sync-Latenz, akzeptable Phase-1-Toleranz.

25.6 Berechtigungen

25.6.1 Eigenen Kalender verbinden: jeder Mitarbeiter darf den eigenen Kalender verbinden und verwalten (Standard). 25.6.2 Kalender-Admin: Tenant-Admin sieht alle Verbindungen (Status-Übersicht), kann gestörte Verbindungen anzeigen und beim Mitarbeiter-Off-Boarding zwangs-trennen. 25.6.3 Ein Mitarbeiter sieht nicht die Verbindungen anderer Mitarbeiter (Privatsphäre), und auch der Tenant-Admin sieht nicht die Inhalte fremder externer Termine, nur die Verbindungs-Status.

25.7 Aktivitäts-Verlauf

25.7.1 Folgende Ereignisse erzeugen einen Aktivitäts-Eintrag: Kalender verbunden, Kalender getrennt, Synchronisations-Fehler (bei wiederholtem Auftreten), Termin extern synchronisiert. 25.7.2 Bewusst nicht im Aktivitäts-Verlauf: jedes einzelne externe Termin-Update (würde den Stream zumüllen).

25.8 Phase 2 / bewusst NICHT in Phase 1

25.8.1 iCal-Feed-URL (read-only Feed für Kalender-Apps ohne OAuth-Anbindung). 25.8.2 Apple/iCloud-Calendar. 25.8.3 FastMail. 25.8.4 Ressourcen-Kalender (Kran, Werkstatt-Heber, Pool-Fahrzeuge als buchbare Ressource). 25.8.5 Tenant-zentrale Verbindung für Ressourcen-Kalender. 25.8.6 Konfigurierbares Sync-Fenster (Phase 1 fest -7/+60 Tage). 25.8.7 Pro-Kalender-Einstellungen (mehrere externe Kalender pro Verbindung mit unterschiedlichen Settings). 25.8.8 Kalender-Farben-Sync. 25.8.9 Smarte Konflikt-Auflösung mit KI-Vorschlag (statt nur "extern gewinnt"). 25.8.10 Erweiterte Zeitzonen-Behandlung (Mitarbeiter in unterschiedlichen Zeitzonen). 25.8.11 Detaillierte Bearbeitung von Serien-Terminen (nur diesen einen Termin vs. komplette Serie).

25.9 Klartext-Fehlertexte (Beispiele)

25.9.1 "Verbindung zu [Anbieter] ist abgelaufen. Bitte neu verbinden, damit deine Termine weiter synchronisiert werden. [Neu verbinden]" 25.9.2 "Du hast HiveGrid die Kalender-Berechtigung im [Anbieter]-Konto entzogen. Synchronisation pausiert. [Neu verbinden]" 25.9.3 "[Anbieter] ist gerade nicht erreichbar, wir holen die letzten Termine sobald die Verbindung wieder steht. Letzte erfolgreiche Synchronisation: [Zeit]." 25.9.4 "[Anbieter] bremst unsere Anfragen, Synchronisation läuft langsamer. Termine erscheinen mit etwas Verzögerung." 25.9.5 "[Email] ist bereits verbunden. Stattdessen die existierende Verbindung anpassen?" 25.9.6 "Dein Termin '[Titel]' wurde gleichzeitig in [Anbieter] geändert, die externe Version wurde übernommen. [Original-Stand anzeigen]" 25.9.7 "Push-Benachrichtigungen von [Anbieter] sind gerade nicht aktiv. Synchronisation läuft alle 30 Minuten als Fallback." 25.9.8 "Dein IT-Admin muss diese Verbindung im [Anbieter]-Tenant zuerst genehmigen. [Admin-Genehmigungs-Link kopieren]" 25.9.9 "Verbindung zu [Email] wird getrennt. [N] synchronisierte Termine bleiben in HiveGrid. Auch in [Anbieter] entfernen? [Nur trennen] [Trennen + extern entfernen]" 25.9.10 "Synchronisation läuft, kann beim ersten Mal ein paar Minuten dauern."


Ende Block 5