# Best-Practice-Installateurportal anhand unseres Blueprints "Installateurportal"
Source: https://help.epilot.cloud/de/portale/installateurportal-best-practices/best-practice-installateurportal-anhand-unseres-blueprints-installateurportal
Last updated: 2026-10-13
Das **Best-Practice-Installateurportal** ist epilots Referenz für ein vollständiges Portal für Installateure. Es bündelt die Erfahrung aus Netzbetreiber- und Stadtwerke-Projekten in einem empfohlenen Portal-Aufbau — mit den Seiten, Features und Flows, die sich in der Praxis bewährt haben. Diese Dokumentation erklärt, wie das Portal aufgebaut ist, welche Funktionen es bietet und wie du dein eigenes Portal nach diesem Muster umsetzt.
## Was ist das Best-Practice-Installateurportal? [#was-ist-das-best-practice-installateurportal-0]
Ein Installateurportal ist mehr als eine Sammlung von Formularen. Es ist der zentrale digitale Anlaufpunkt für zugelassene Installateure — und wenn es gut gebaut ist, spart es beiden Seiten massiv Zeit: Installateure erledigen Anträge, Konzessionsverlängerungen und Dokumenten-Uploads ohne Anruf oder E-Mail, und dein Team bekommt Prozesse strukturiert und nachverfolgbar ins Haus.
Das Best-Practice-Portal zeigt, wie diese Funktionen sauber ineinandergreifen. Es basiert auf realen Setups bei Stadtwerken und Netzbetreibern und deckt die Kernprozesse ab, die du typischerweise brauchst:
* **Zwei Registrierungs-Flows** — für Stamm- und Gastinstallateure, mit unterschiedlichen Datenanforderungen und Freigabe-Prozessen
* **Antragsmanagement** — Anmeldungen und Inbetriebsetzungen einreichen, nachverfolgen, ergänzen
* **Konzessionsmanagement** — Ablaufdaten im Blick, rechtzeitige Verlängerung direkt im Portal
* **Dokumentenverwaltung** — zentrale Ablage für Nachweise, Zertifikate und Korrespondenz
* **Support & Tickets** — direkter Draht zum Stadtwerk, ohne Telefon oder E-Mail-Weiterleitung
* **Rollenbasierte Sichtbarkeit** — jeder Installateur sieht nur, was für ihn relevant ist
### Warum ein Best-Practice-Modell? [#warum-ein-best-practice-modell-1]
Portal-Setups ohne Vorlage neigen dazu, wichtige Details zu übersehen — etwa die feine Unterscheidung zwischen Stamm- und Gastinstallateuren, die 3-Monats-Regel bei Konzessionsverlängerungen oder die Auswirkung von §14a EnWG auf Informationsseiten. Das Best-Practice-Portal bringt diese Erfahrungswerte zusammen, damit du sie nicht jedes Mal neu erarbeiten musst. Du startest auf Experten-Niveau und schärfst von dort aus für deine Organisation nach.
## Die zwei Installateur-Typen als zentrales Konzept [#die-zwei-installateur-typen-als-zentrales-konzept-2]
Die wichtigste konzeptionelle Entscheidung im Portal ist die Unterscheidung zwischen **Stamminstallateuren** und **Gastinstallateuren**. Diese Trennung zieht sich durch Registrierung, Sichtbarkeit, Dokumentenanforderungen und Konzessionslogik.
| | |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Typ** | **Merkmale** |
| **Stamminstallateur** | Hauptsitz innerhalb deines Netzgebiets. Eingetragen im Installateurverzeichnis. Regelmäßige Konzessionsverlängerungen, volle Dokumentenpflicht. |
| **Gastinstallateur** | Hauptsitz außerhalb deines Netzgebiets. Arbeitet temporär oder projektbezogen in deinem Netz. Reduzierter Umfang — braucht z. B. oft keine Konzessionsverwaltung bei dir, da die Konzession vom Heimat-Netzbetreiber kommt. |
## Der Portal Builder — deine Arbeitsoberfläche [#der-portal-builder-deine-arbeitsoberflche-3]
Dein Portal baust und pflegst du im **Portal Builder** — der Low-Code-Oberfläche in epilot. Seiten, Blöcke und Einstellungen konfigurierst du per Drag-and-Drop und Formular-Eingaben, ohne eine Zeile Code zu schreiben.
### Portal Builder öffnen [#portal-builder-ffnen-4]
1. Melde dich in deiner epilot Organisation an
2. Gehe zu **Konfiguration > Portale > Portal Konfiguration**
3. Wähle in der Liste dein **Installateurportal** aus
4. Du landest in der Builder-Ansicht
### Das Drei-Spalten-Layout verstehen [#das-drei-spalten-layout-verstehen-5]
Die Builder-Oberfläche ist in drei Spalten aufgeteilt. Jede hat eine klare Aufgabe — sobald du das Layout verinnerlicht hast, arbeitest du schnell.
| | |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Spalte** | **Was du dort machst** |
| **Links — Seitenbaum** | Oben wählst du die Seite aus. Darunter siehst du alle Blöcke dieser Seite, gegliedert in **Kopfbereich**, **Hauptinhalt** und **Fußbereich**. Per Drag-and-Drop änderst du die Reihenfolge. |
| **Mitte — Live-Vorschau** | Zeigt die Seite so, wie sie der Installateur später sieht. Klicke auf einen Block in der Vorschau, und rechts öffnen sich dessen Einstellungen. |
| **Rechts — Einstellungen** | Kontext-abhängig. Ist kein Block ausgewählt, siehst du **Seiten-Einstellungen**. Ist ein Block ausgewählt, siehst du dessen Block-Einstellungen. |
### Die Top-Toolbar [#die-top-toolbar-6]
* **Dokumentation** — öffnet die epilot HelpJuice-Artikel zum Portal Builder
* **Einstellungen** — globale Portal-Einstellungen (Branding, Login-Domains, E-Mail-Absender)
* **Speichern** — übernimmt alle Änderungen der aktuellen Session
* **Desktop / Mobile** — wechselt die Vorschau zwischen den Layouts
* **Anmelden als** — Test-Login, um das Portal aus Installateurs-Sicht zu sehen
## Seitenstruktur des Best-Practice-Portals [#seitenstruktur-des-best-practice-portals-7]
Das Portal teilt sich in **öffentliche Seiten** (ohne Login erreichbar) und **geschützte Seiten** (nur nach Anmeldung).
### Öffentliche Seiten [#ffentliche-seiten-8]
| | |
| ----------------------------- | -------------------------------------------------------------------------------------- |
| **Anmelden** | Login-Formular plus Einstiegs-Buttons für die Neu-Registrierung. |
| **Registrieren** | Registrierungsassistent — unterschiedlich für Stamm und Gast. |
| **Ausstehendes Konto** | Wird angezeigt, wenn ein Konto registriert, aber noch nicht manuell freigegeben wurde. |
| **Aktivierungslink gesendet** | Bestätigung nach der Registrierung. |
| **Registrierung erfolgreich** | Erscheint nach Klick auf den Aktivierungslink aus der E-Mail. |
| **E-Mail bestätigen** | Bestätigt eine E-Mail-Adress-Änderung. |
| **Passwort vergessen** | Formular zum Anfordern eines Reset-Links. |
| **Kennwort ändern** | Formular zum Vergeben eines neuen Passworts. |
### Geschützte Seiten (nach Login) [#geschtzte-seiten-nach-login-9]
| | |
| --------------------------- | ------------------------------------------------------------ |
| **Startseite** | Dashboard mit Schnellzugriff auf die wichtigsten Funktionen. |
| **Meine aktuellen Anträge** | Liste aller laufenden und abgeschlossenen Anträge. |
| **Konzessionsmanagement** | Übersicht der Konzession plus Verlängerungs-Journey. |
| **Aktuelles** | Informationen nach §14a EnWG und andere Mitteilungen. |
| **Dokumente** | Zentrale Dokumenten-Ablage. |
| **Support** | Ticket-Formular und Kontakt. |
| **Mein Konto** | Persönliche Daten, Zertifizierungen, Benutzerverwaltung. |
## Anatomie einer Seite [#anatomie-einer-seite-10]
Jede Seite besteht aus drei Bereichen, die du im Seitenbaum links wiederfindest:
* **Kopfbereich** — Logo, Navigation, Top-Banner
* **Hauptinhalt** — der eigentliche Seiteninhalt; hier lebt der Großteil deiner Arbeit
* **Fußbereich** — Impressum, Datenschutz, Kontakt — identisch auf allen Seiten
In jedem Bereich stapelst du **Blöcke**. Ein Block ist die kleinste inhaltliche Einheit — ein Titel, ein Textabsatz, eine Liste, ein Formular. Neue Blöcke fügst du über das **+** neben dem Bereichsnamen hinzu.
### Block-Typen im Überblick [#block-typen-im-berblick-11]
| | |
| -------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Titel** | Überschrift als H1/H2/H3. |
| **Text** | Fließtext mit einfachem Formatting und Variablen-Support. |
| **Attribute Gruppe** | Zeigt Felder einer Entität als Informationsfelder dar— z. B. „Ihre hinterlegten persönlichen Daten". |
| **Entitätenliste** | Filter- und suchbare Liste von Entitäten wie Opportunities, Bestellungen, Dokumenten. |
| | |
| **Schnellaktionen** | Karten-Kacheln, die den Installateur direkt zu häufigen Aktionen führen. Hier kann man erstelle Journeys hinterlegen |
| **Kampagnen-Block** | Zielgerichtete Inhalte, gebunden an eine Zielgruppe und eine Kampagne. |
## Kernfeatures im Detail [#kernfeatures-im-detail-12]
Dieser Abschnitt zeigt jedes Kernfeature des Best-Practice-Portals und was dahinter steckt. Jedes Feature kannst du bei dir genauso umsetzen — oder gezielt abweichen, wo es sinnvoll ist.
### Registrierung und Account-Aktivierung [#registrierung-und-account-aktivierung-13]
Die Registrierung ist der erste Berührungspunkt mit dem Portal — und einer der wenigen Momente, in denen ein Installateur aussteigen kann, wenn etwas hakt. Das Best-Practice-Portal reduziert diese Reibung durch zwei getrennte, klar beschriftete Flows:
* **Eintragung als Stamminstallateur** — vollständiger Datensatz inklusive Konzessionsnachweise
* **Eintragung als Gastinstallateur** — reduzierter Datensatz, Fokus auf Identifikation und Kontakt
Nach der Registrierung wird automatisch ein Aktivierungslink per E-Mail verschickt. Optional kann das Portal so konfiguriert werden, dass neue Konten zuerst manuell freigegeben werden müssen — dann landet der Installateur nach Login auf der Seite **Ausstehendes Konto**, bis jemand aus deinem Team die Freigabe erteilt.
### Startseite mit Schnellaktionen [#startseite-mit-schnellaktionen-14]
Die Startseite ist das Dashboard nach dem Login. Statt einer generischen Willkommensseite setzt das Best-Practice-Portal auf **Schnellaktionen** — Karten-Kacheln, die direkt auf die häufigsten Aufgaben verlinken:
* Neuen Antrag stellen
* Ausweisverlängerung beantragen (falls Konzession bald abläuft)
* Dokument hochladen
* Support-Ticket erstellen
Hinter den Schnellaktionen kannst du z. B. Journeys deiner Wahl hinterlegen.
Schnellaktionen sind besonders mächtig in Kombination mit **Zielgruppen-Sichtbarkeit**: Stamminstallateure sehen die Ausweisverlängerungs-Kachel, Gastinstallateure nicht. Wird ein Ausweis in den nächsten 3 Monaten ablaufen, erscheint die Kachel zusätzlich hervorgehoben — so verpasst niemand den Verlängerungstermin.
Mehr dazu später in diesem Artikel.
### Antragsmanagement [#antragsmanagement-15]
Das Antragsmanagement ist das meistbenutzte Feature des Portals. Auf der Seite **Meine aktuellen Anträge** sieht jeder Installateur seine eigenen Anträge — umgesetzt als **Entität\*\*\*\*enliste** mit der Entität **Opportunity**.
Das Best-Practice-Modell zeigt hier:
* Gruppierung nach **Status** — so sieht der Installateur auf einen Blick, was in Bearbeitung, genehmigt oder abgelehnt ist
* Suche nach **Lieferadresse** und **Antragsnummer** (OP-Nummer)
### Konzessionsmanagement [#konzessionsmanagement-16]
Auf der Konzessionsmanagement Seite findest du verschiedene Inhalte:
* Einleitungstext mit Hinweis auf die 3-Monats-Verlängerungs-Regel
* Eine **Schnellaktion „Ausweisverlängerung beantragen"** pro Konzessionsbereich (Gas, Strom, Wasser, Fernwärme), die jeweils einen eigenen Journey startet - jeweils ein eigener Journey-Platzhalter für Stamminstallateure als auch für Gastinstallateure.
* **Attribute Gruppe „Ihre hinterlegten persönlichen Daten"** — zeigt Kontaktdaten
* Mehrere **Attribute Gruppen „Details zur Konzessionierung"**, eine pro Bereich — mit Konzessionsnummer, Gültigkeit, zuletzt geprüftem Datum
* **Dokumente-Block** mit dem aktuellen Installateurausweis
Wir empfehlen dir hier, die jeweilige Schnellaktion der Ausweisverlängerung mit einer Zielgruppe zu hinterlegen. Demenstprechend soll ein Stamminstallateur nur die Journey sehen, die für in bestimmt ist.
### Dokumentenverwaltung [#dokumentenverwaltung-17]
Alle Dokumente eines Installateurs landen zentral auf der Seite **Dokumente**. Umgesetzt als **Entität\*\*\*\*enliste** mit der Entität **Dokumente**. Best-Practice-Features:
* Suche nach Dateiname
* Gruppierung nach Dokumententyp (Konzessionsnachweis, Installateurausweis, Versicherung, …)
* Download direkt über einen Nested-Link — Klick öffnet die Datei
* Upload-Button für Installateure, die selbst neue Dokumente einreichen wollen
### Support und Tickets [#support-und-tickets-18]
Die Support-Seite besteht kann mithilfe von Teasern, die zu einer FAQ Journey führen oder mit Kontaktdetails mit Leben befüllt werden.
### Mein Konto und Benutzerverwaltung [#mein-konto-und-benutzerverwaltung-19]
**Mein Konto** ist der Self-Service-Bereich für persönliche Daten: Kontaktdaten, Firmeninformationen, Zertifizierungen, E-Mail- und Passwort-Änderung. Technisch umgesetzt über mehrere **Attribute-Gruppen** auf Kontakt und Portal-Zugang.
### §14a-Informationen [#14a-informationen-20]
Die Seite **Aktuelles** sammelt gesetzliche Informationen nach §14a EnWG sowie organisationsweite Mitteilungen. Best-Practice ist hier bewusst schlicht — ein Titel, ein Text mit Verlinkung auf relevante Gesetzestexte, optional ein **Kampagnen-Block** für zeitgebundene Ankündigungen.
## Deep-Dive: Die Entitätenliste [#deep-dive-die-entittenliste-21]
Die **Entitätenliste** ist das Rückgrat des Portals. Sie kommt in Anträgen, Bestellungen, Dokumenten, Tickets und jedem anderen Bereich vor, wo Installateure eine Liste von Datensätzen sehen sollen. Weil sie so zentral ist, lohnt es sich, ihre Optionen genau zu verstehen.
### Grundkonzept — ein Block, mehrere Konfigurationen [#grundkonzept-ein-block-mehrere-konfigurationen-22]
Eine Entitätenliste besteht aus **Block-Inhalt** (Rahmen mit Titel) und einer oder mehreren **Konfigurationen**. Jede Konfiguration zeigt einen anderen Entitätstyp oder denselben Typ mit einem anderen Filter. So kannst du in einem Block gleichzeitig Anträge und zugeordnete Dokumente anzeigen.
### Block-Inhalt — Bezeichnung und Titel [#block-inhalt-bezeichnung-und-titel-23]
* **Bezeichnung** — interner Name, dem Installateur nicht sichtbar
* **Titel** — Überschrift über der Liste. Variablen erlaubt (`{{...}}`)
* **Alle Interaktionen deaktivieren** — macht die Liste read-only
### Konfigurationen anlegen [#konfigurationen-anlegen-24]
| | |
| ----------------------------- | ------------------------------------------------------------------- |
| **Feld** | **Beschreibung** |
| **Entität**\*\* auswählen\*\* | Der Entitätstyp, z. B. **Opportunity**, **Bestellung**, **Ticket**. |
| **Konfigurationsname** | Interner Name bei mehreren Konfigurationen. |
| **Seite auswählen** | Ziel-Seite beim Klick auf einen Listen-Eintrag. |
### Templating — was der Eintrag anzeigt [#templating-was-der-eintrag-anzeigt-25]
| | |
| ------------------------ | ----------------------------------------------------- |
| **Slot** | **Typischer Inhalt** |
| **Inhalt oben** | Kleine Overline-Zeile — z. B. Antragsnummer. |
| **Hauptinhalt** | Der prominente Haupttext — z. B. Lieferadresse. |
| **Inhalt unten** | Zusatzinfo unter dem Haupttext — z. B. Status. |
| **Hauptinhalt (rechts)** | Rechtsbündiger Wert — Beträge, Datumsangaben, Labels. |
| **Icon (Leading)** | Optionales Symbol links vom Eintrag. |
**💡 Variablen-Picker nutzen**
Neben jedem Template-Feld siehst du ein `{}`-Icon. Klicke es, um den Variablen-Picker zu öffnen. Dort siehst du alle Felder der ausgewählten Entität — du musst nichts auswendig lernen.
### Filter — welche Einträge erscheinen [#filter-welche-eintrge-erscheinen-26]
1. **Filtern nach Ziel** — filtert nach Zuordnung. Beispiel: „Opportunity zur Ansicht freigegeben". Das bedeutet, dass du hier festlegen kannst, welche z. B. Opportunties hier angzeigt werden.
2. **Benutzerfilter** — weitere Filter nach Feldwerten (**+ Feld**) oder Zielgruppen (**+ Zielgruppe**).
### Ergebnisse organisieren [#ergebnisse-organisieren-27]
| | |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **Option** | **Wirkung** |
| **Aktiven Workflow anzeigen** | Zeigt den aktuellen Workflow-Schritt pro Entität. |
| **Gruppieren nach** | Kategorisiert die Liste nach einem Attribut aus der jweiligen Entiät |
| **Sortieren nach** | Aufsteigend/absteigend nach einem Attirubt. |
| **Sichtbare Ergebnisse** | 5, 10, 25, 50, 75 oder 100 pro Seite. |
| **Anzahl änderbar** | Installateur darf Batch-Größe selbst wählen. |
| **Suche anzeigen** | Blendet das Suchfeld ein. |
| **Suche nach** | Welche Felder durchsucht werden dürfen. Mit dieser Option werden in der Suche nur Ergebnisse anzeigt, die hier definiert sind. |
| **Endbenutzer können Attribute auswählen** | Installateur darf selbst Suchfelder setzen, basierend auf den Attributen von der “Suche nach” Optionen. |
## Zielgruppen und Sichtbarkeit [#zielgruppen-und-sichtbarkeit-28]
Die Trennung zwischen Stamm- und Gastinstallateuren wird technisch über **Zielgruppen** abgebildet. Eine Zielgruppe ist ein gespeichertes Filterkriterium — z. B. „alle Kontakte mit Installateur-Typ = Stamm".
### Zielgruppen erstellen [#zielgruppen-erstellen-29]
Zielgruppen definierst du zentral in der epilot-Konfiguration:
1. Gehe zu **Konfiguration > ****Targeting**** > Zielgruppen**
2. Klicke oben rechts auf **Neu erstellen**
3. Trage **Namen** und **Beschreibung** ein
4. Definiere die **Filter** — z. B. „Kontakt-Typ = Installateur UND Installateur-Typ = Stamm"
5. Speichere mit **Zielgruppe erstellen**
**💡 Zielgruppen aus Entitätstabellen**
Alternativ filterst du in einer Entitätentabelle und klickst dann auf **Neue Zielgruppe** — die Filter werden übernommen.
### Zielgruppen im Portal anwenden [#zielgruppen-im-portal-anwenden-30]
Sobald Zielgruppen existieren, setzt du sie an drei Stellen ein:
* **Seitenebene** — eine ganze Seite nur für eine Zielgruppe sichtbar machen
* **Blockebene** — einen einzelnen Block nur für eine Zielgruppe zeigen
* **Filterebene** — in einer Entitätenliste nach Zielgruppen-Zugehörigkeit filtern
### Seitensichtbarkeit — sichtbar für, versteckt für [#seitensichtbarkeit-sichtbar-fr-versteckt-fr-31]
* **Sichtbar für** — Seite/Block nur für die ausgewählten Zielgruppen sichtbar. Leer = sichtbar für alle.
* **Versteckt für** — explizit versteckt. Überschreibt „Sichtbar für".
Konkretes Best-Practice-Beispiel: **Konzessionsmanagement** ist nur für Stamminstallateure relevant. Setze **Sichtbar für: Stamminstallateure** — und Gastinstallateure sehen den Menüpunkt gar nicht erst.
### Geplante Sichtbarkeit [#geplante-sichtbarkeit-32]
Im Abschnitt **Geplante Sichtbarkeit** kannst du zeitgesteuert ein- und ausblenden — etwa für eine befristete §14a-Kampagne oder eine Wartungsankündigung. Start- und Enddatum setzen, das System übernimmt den Rest.
Weiter Details dazu findest du in diesem Artikel: [**Anzeigebedinungen für Seiten und Blöcke**](https://help.epilot.cloud/de/konfiguration/portal-konfiguration/die-neue-portalwelt-in-epilot/portal-setup-konfiguration/anzeigebedingungen-fur-seiten-und-blocken-copy-853)
## Variablen und Templating [#variablen-und-templating-33]
Überall, wo du ein Text-Feld mit `{{...}}` siehst, handelt es sich um eine Variable. Variablen werden beim Rendern durch echte Werte ersetzt. Das System nutzt **Handlebars**-Syntax.
### Syntax verstehen [#syntax-verstehen-34]
Variable = Entitätsname + Punkt + Feldname:
* `{{opportunity.opportunity_number}}` — Antragsnummer
* `{{opportunity.status}}` — Status
* `{{contact.first_name}}` — Vorname des angemeldeten Installateurs
* `{{contact.company_name}}` — Firmenname
* `{{portal_user.email}}` — Portal-E-Mail
### Custom Variables [#custom-variables-35]
Manche Werte sind keine einfachen Feld-Lookups, sondern zusammengesetzte Darstellungen. Beispiel: `{{liegenschaftsdaten_unbekannte_adresse}}`. Dahinter steht ein Handlebars-Template, das Straße, Hausnummer, PLZ und Ort zusammenbaut — mit Fallback bei leerer Adresse. Solche **Custom Variables** definierst du zentral in der epilot-Organisation und nutzt sie überall im Portal.
**💡 Wenn Variablen leer bleiben**
Fast immer zwei Gründe: Feldname falsch geschrieben, oder Feld existiert nicht auf der aktuell ausgewählten Entität. Nutze den Variablen-Picker und prüfe den Entitätskontext.
## So baust du dein Portal — Schritt für Schritt [#so-baust-du-dein-portal-schritt-fr-schritt-36]
Mit dem Best-Practice-Modell im Kopf kannst du dein eigenes Portal aufbauen oder ein bestehendes schärfen. Die folgenden Anleitungen führen dich durch die häufigsten Schritte.
### Logo und Branding anpassen [#logo-und-branding-anpassen-37]
1. Öffne dein Portal im Portal Builder
2. Klicke oben auf **Einstellungen**
3. Unter **Branding** lädst du dein Logo hoch und setzt Primär- und Sekundärfarbe
4. Speichere und prüfe in der Vorschau, dass Kontraste und Lesbarkeit stimmen
### Startseite aufbauen [#startseite-aufbauen-38]
1. Wähle die Seite **Startseite** aus
2. Füge einen **Titel**-Block mit Begrüßung (gerne personalisiert mit `{{contact.first_name}}`) hinzu
3. Füge einen **Text**-Block mit Einleitung und Portal-Zweck hinzu
4. Baue 3–5 **Schnellaktionen** für die wichtigsten Aufgaben auf
5. Setze für jede Schnellaktion eine **Zielgruppen-Sichtbarkeit**, damit Stamm und Gast jeweils nur das Relevante sehen
### Antragsliste konfigurieren [#antragsliste-konfigurieren-39]
1. Öffne die Seite **Meine aktuellen Anträge**
2. Füge eine **Entitätenliste** im Hauptinhalt hinzu
3. Wähle in der Konfiguration die Entität **Opportunity**
4. Setze **Filtern nach Ziel** auf **Opportunity**\*\* zur Ansicht freigegeben\*\*
5. Aktiviere **Gruppieren nach: Status**
6. Aktiviere **Suche anzeigen**, füge **Lieferadresse** und **Opportunity**\*\* Number\*\* unter **Suche nach** hinzu
7. Setze Templates: oben = Antragsnummer, Hauptinhalt = Adresse, unten = Status
8. Speichere und teste über **Anmelden als**
### Zielgruppen-Setup [#zielgruppen-setup-40]
1. Lege unter **Konfiguration > ****Targeting**** > Zielgruppen** deine beiden Zielgruppen **Stamminstallateure** und **Gastinstallateure** an
2. Prüfe, dass jeder Installateur-Kontakt einem Typ zugeordnet ist (Custom-Attribut oder separates Feld)
3. Setze Sichtbarkeiten auf Seiten- und Blockebene
4. Teste beide Zielgruppen mit je einem Testkontakt über **Anmelden als**
### Neue Schnellaktion hinzufügen [#neue-schnellaktion-hinzufgen-41]
1. Öffne die Zielseite
2. Klicke neben **Hauptinhalt** auf **+** und wähle **Schnellaktion**
3. Konfiguriere Titel, Beschreibung, Icon, Ziel-Journey oder -Seite
4. Optional: Sichtbarkeit auf eine Zielgruppe einschränken
5. Speichere und teste
### Nicht benötigte Seite entfernen [#nicht-bentigte-seite-entfernen-42]
1. Wähle die Seite im Seiten-Dropdown
2. Klicke unten auf den Seiten-Einstellunge auf “Ausblenden”
3. Speichern
## Testen und Aktivieren [#testen-und-aktivieren-43]
### Mit „Anmelden als" testen [#mit-anmelden-als-testen-44]
Über das Dropdown **Anmelden als** oben rechts meldest du dich im Vorschau-Modus als beliebiger Test-Kontakt an. Inklusive Zielgruppen-Sichtbarkeit, persönlicher Daten und korrekter Variablen-Werte.
Lege dir zwei Test-Kontakte an — je einen Stamm- und einen Gast — und springe zwischen beiden Sichten hin und her. Sichtbarkeits-Fehler findest du so in Sekunden.
### Desktop- und Mobile-Vorschau [#desktop-und-mobile-vorschau-45]
Wechsle über die beiden Icons zwischen Desktop- und Mobile-Ansicht. Blöcke mit viel Inhalt (insbesondere Entitätenlisten) sehen auf Mobile oft anders aus — prüfe das vor dem Aktivieren.
### Portal aktivieren [#portal-aktivieren-46]
1. Klicke oben auf den Toggle **Portal aktivieren**
2. Das Portal ist nun unter der konfigurierten URL erreichbar
3. Öffne die URL in einem privaten Browser-Fenster zum finalen Check
**💡 Soft-Launch-Empfehlung**
Schalte das Portal zuerst für eine kleine Test-Gruppe frei — 5–10 Installateure, die du gut kennst. Sammle Feedback für 1–2 Wochen. So entdeckst du Text- und Inhaltsfehler, bevor sie hundertfach gesehen werden.
## Häufige Probleme und Lösungen [#hufige-probleme-und-lsungen-47]
| | |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Problem** | **Lösung** |
| Variable wird als `{{...}}` angezeigt | Tippfehler im Feldnamen. Nutze den Variablen-Picker. |
| Entitätenliste bleibt leer | „Filtern nach Ziel" zu streng gesetzt. Test mit einem Kontakt, dem eine Opportunity freigegeben ist. |
| Seite verschwindet nach Speichern | „Sichtbar für" wurde auf eine Zielgruppe gesetzt, zu der dein Test-Kontakt nicht gehört. |
| Änderungen nicht im Live-Portal | Speichern vergessen, Portal nicht aktiviert, oder Browser-Cache. Mit Strg+F5 neu laden. |
| Installateur sieht Seite, die er nicht sollte | „Sichtbar für" leer = sichtbar für alle. Zielgruppe explizit setzen. |
| Such-Ergebnisse leer trotz vorhandener Einträge | „Suche nach" hat das gesuchte Feld nicht. Hinzufügen. |