Mit einer Upload-Journey kannst du Portalnutzern, zum Beispiel Installateuren, ermöglichen, Dokumente direkt im Portal zu einer bestehenden Entität hochzuladen. Die Dateien landen automatisch an der richtigen Opportunity und sind sofort in epilot sichtbar.

So funktioniert der Upload

Portalnutzer starten den Upload über eine Schnellaktion im Portal. Die Aktion öffnet eine schlanke Journey und übergibt dabei die ID der Opportunity. Dadurch weiß die Journey bereits, zu welcher Anfrage die Dateien gehören.

• Portalnutzer laden Dokumente selbst hoch, ohne Medienbruch durch E-Mails.
• Die Dateien werden automatisch der richtigen Opportunity zugeordnet.
• Jede Datei erhält ein festes Tag, zum Beispiel Upload Portal. So erkennt dein Team auf einen Blick, welche Dokumente über das Portal kamen.

1. Upload-Journey erstellen

Lege zuerst die Journey an, die den Upload übernimmt. Sie besteht aus einem Schritt und zwei Blöcken.

1. Öffne den Journey Builder und lege eine neue Journey an, zum Beispiel Portal: Upload zusätzliche Dateien.
2. Benenne den Schritt, zum Beispiel Zusätzlicher Dokumentenupload, und ergänze einen kurzen Hinweistext als Untertitel.
3. Blende den Stepper und den Standard-Weiter-Button aus. Der Versand läuft über die Aktionsleiste.

Upload-Block hinzufügen

Füge einen Upload-Block hinzu und stelle ihn wie folgt ein:

Aktionsleiste hinzufügen

Füge unterhalb des Upload-Blocks eine Aktionsleiste hinzu:

• Beschrifte den Haupt-Button mit Datei(en) übermitteln.
• Blende den Zurück-Button aus.
• Aktiviere keine Einwilligungen.
• Aktiviere die Option, dass der Button auf Mobilgeräten fixiert bleibt, damit er auf dem Smartphone immer sichtbar ist.

2. Kontextparameter anlegen

Damit die Dateien an der richtigen Opportunity landen, braucht die Journey einen Kontextparameter.

1. Öffne in der Journey den Tab Kontextparameter.
2. Klicke auf Parameter hinzufügen.
3. Wähle als Typ den Eintrag Opportunity aus.
4. Trage als Schlüssel opportunity_id ein.
5. Klicke auf Speichern.

3. Dateien der Opportunity zuordnen

Richte das Mapping der Journey so ein, dass die Submission an die bestehende Opportunity aus dem Kontext gehängt wird. Es soll keine neue Opportunity entstehen.

• Nutze dafür den Wert opportunity_id aus dem Journey-Kontext als Referenz auf die Opportunity.
• Stelle sicher, dass die Dateien aus dem Upload-Block der Opportunity zugeordnet werden.

4. Zugriff festlegen und Journey aktivieren

Die Upload-Journey ist für den eingeloggten Portalbereich gedacht und nicht für die öffentliche Einbettung auf einer Website. Stelle den Zugriff deshalb in den Einstellungen der Journey auf privat. Aktiviere die Journey anschließend.

5. Schnellaktion im Portal einbinden

Im letzten Schritt verbindest du die Journey mit dem Portal.

1. Öffne den Portal Builder und wähle dein Portal aus.
2. Öffne die Seite, auf der die Dokumente angezeigt werden. 
3. Füge im Bereich Hauptinhalt unter Schnellaktionen eine neue Schnellaktion hinzu, zum Beispiel Zusätzliches Dokument hochladen.
4. Wähle bei Icon ein passendes Symbol aus, zum Beispiel upload.
5. Wähle bei Aktion den Eintrag Journey aus.
6. Wähle im Dropdown Journey die Journey Portal: Upload zusätzliche Dateien aus.
7. Lasse den Anfangsschritt auf Standard (Neuer Schritt).

Opportunity-ID übergeben

Unter Kontextparameter in der Schnellaktion siehst du die Parameter origin und contact_id. Beide sind standardmäßig vorhanden. Ergänze zusätzlich den Parameter für die Opportunity:

1. Füge einen Kontextparameter hinzu.
2. Trage bei Parametername den Wert opportunity_id ein.
3. Trage bei Parameterwert die Variable {{opportunity._id}} ein.
4. Vergiss nicht zu speichern.