Zum Hauptinhalt springen

Datei-Upload-Knoten

Kurzfassung: Ein Datei-Upload-Knoten pausiert den Flow und fordert den Chat-Nutzer auf, eine oder mehrere Dateien (JPG, PNG, PDF, HEIC, TXT) direkt im Gespräch hochzuladen. Sie definieren ein oder mehrere Upload-Felder, jedes mit eigenen erlaubten Dateitypen, Größen- und Anzahl-Limits sowie einem Erforderlich-Schalter. Übermittelte Dateien werden an ein serverseitiges Verarbeitungsskript gestreamt und nicht gespeichert. Wenn alle Felder optional sind, kann der Nutzer den Upload überspringen und weiter chatten.

Ein Datei-Upload-Knoten lässt den Bot Dokumente oder Bilder vom Nutzer mitten im Gespräch einsammeln - zum Beispiel ein Ausweisdokument, ein Foto oder eine unterschriebene PDF. Sobald der Flow den Knoten erreicht, zeigt das Chat-Widget eine Upload-Karte; nachdem der Nutzer abgeschickt (oder übersprungen) hat, läuft das Gespräch weiter.

Den Knoten konfigurieren​

Der Knoten wird im Seitenpanel des Flow-Editors konfiguriert.

Prompt​

Eine optionale Nachricht, die über den Upload-Feldern angezeigt wird (z. B. „Bitte laden Sie die folgenden Dokumente hoch"). Leer lassen, um nur die Felder anzuzeigen.

Upload-Felder​

Ein Knoten hat ein oder mehrere Upload-Felder. Jedes Feld ist ein eigener Slot, den der Nutzer unabhängig befüllt:

  • Feldname - erforderliche Bezeichnung, die dem Nutzer angezeigt wird (z. B. Ausweisdokument).
  • Beschreibung - optionaler Text, der erklärt, was hochgeladen werden soll (z. B. „Vorder- und Rückseite Ihres Ausweises").
  • Erlaubte Dateitypen - einer oder mehrere von jpg, png, pdf, heic, txt. Der Nutzer kann nur passende Dateien auswählen. txt-Dateien müssen UTF-8- oder UTF-16-kodiert sein.
  • Max. Anzahl Dateien - wie viele Dateien dieses Feld akzeptiert (1 bis zum Plattform-Maximum). Ein Wert über 1 erlaubt dem Nutzer, mehrere Dateien in dasselbe Feld zu legen.
  • Max. Größe (MB) - Größenlimit pro Datei für dieses Feld, bis zum Plattform-Maximum.
  • Erforderlich - ein Schalter. Ist er aktiv, muss der Nutzer für dieses Feld mindestens eine Datei bereitstellen, bevor er abschicken kann.

Mit Upload-Feld hinzufügen fügen Sie weitere Felder hinzu, über das Papierkorb-Symbol entfernen Sie eines. Mindestens ein Feld muss bestehen bleiben.

Datei-Verarbeitungsskript​

Jeder Datei-Upload-Knoten hat ein stets aktives Datei-Verarbeitungsskript (Python). Es läuft serverseitig, nachdem der Nutzer für diesen Knoten Dateien abgeschickt hat, und erhält die hochgeladenen Dateien. Siehe Nachbearbeitungsskripte für das verwandte Konzept bei Antwort-Knoten.

Was der Nutzer sieht​

Im Chat-Widget zeigt der Bot die Aufforderung, gefolgt von einer Upload-Karte pro Feld. Jede Karte zeigt den Feldnamen, seine Beschreibung und eine Regelzeile, die die erlaubten Typen, das Größenlimit und die Dateianzahl zusammenfasst.

  • Der Nutzer zieht Dateien auf eine Karte oder wählt sie über den Dateidialog. Dateien werden im Browser auf Typ, Größe und Anzahl geprüft und können vor dem Abschicken entfernt werden.
  • Der Absenden-Button wird aktiv, sobald mindestens eine Datei ausgewählt ist und jedes erforderliche Feld erfüllt ist. Während des Uploads ist er deaktiviert und zeigt einen Ladehinweis.
  • Überspringen - wenn alle Felder optional sind und keine Datei ausgewählt ist, wird der Button stattdessen zu einer Überspringen-Aktion. Der Nutzer kann den Upload verwerfen und das Gespräch fortsetzen, ohne eine Datei bereitzustellen.
  • Nach erfolgreichem Abschicken friert die Karte ein und zeigt die übermittelten Dateien. Die Texteingabe bleibt während des Uploads deaktiviert.