Zum Inhalt springen

Im EinsatzEigenentwicklung · Threema-Bot · Logistik

Fahrer-Nachweis-Agent

Vorfall gemeldet. Nachweis fertig.

Grafik: Ein Chat. Ein Nachweis. Direkt in der Dispo-Inbox. – Geführter Chat, Vorgangsart, PDF-Erzeugung, Mail im Postfach

Fahrer-Nachweis-Agent

Wenn beim Abladen die Rollcontainer fehlen, eine Palette beschädigt ankommt oder die Kühlkette unterbrochen war, muss das dokumentiert werden — sofort, vollständig und so, dass die Disposition damit arbeiten kann. Bisher lief das über Anrufe, WhatsApp-Fotos und handschriftliche Notizen, die später mühsam zusammengetragen wurden. Der Fahrer-Nachweis-Agent macht daraus einen geführten Chat-Dialog direkt in Threema, der Fahrer durch die Meldung führt und am Ende automatisch einen fertigen PDF-Nachweis per Mail an die Dispo schickt.

Ein Threema-Bot führt LKW-Fahrer bei Schäden und Vorfällen Schritt für Schritt durch die Doku — mehrsprachig, mit Foto-Checkliste. Am Ende steht automatisch ein PDF-Nachweis in der Disposition. Kein Anruf, kein Zettel, kein Nachfassen.

  • Threema-Bot · n8n
  • Geführter Dialog
  • Mehrsprachig · DE·RU·PL
  • DSGVO · self-hosted
Client
Logistikunternehmen — Kundenprojekt
Datum
2026 / Q2
Projekttyp
Threema-Bot · Backend-Service · self-hosted

Melden · Dokumentieren · Fertig

Fahrer angebunden
15
Nachweise / Monat
80
Sprachen live
3
Vollständige Nachweise
96%

Kennzahlen sind Beispielwerte

Das Problem

Ein Anruf, drei WhatsApp-Fotos, kein Nachweis.

Fahrer sind unterwegs, oft mit Handschuhen, im Lager, unter Zeitdruck. Vorfälle wurden mündlich oder per WhatsApp gemeldet — uneinheitlich, ohne Pflichtangaben, ohne durchsuchbare Ablage. Die Dispo musste Informationen manuell zusammensuchen, Fotos passten nicht zum Vorgang, und am Monatsende ließ sich kaum nachvollziehen, was wann wo passiert war.

Ausgangslage

Meldungen kamen über Telefon, SMS und private Chats herein — jede Fahrkraft anders, keine einheitliche Struktur, keine automatische Ablage. Fotos und Text gehörten oft nicht erkennbar zusammen, und mehrsprachige Fahrer (u. a. Russisch, Polnisch) mussten Sachverhalte auf Deutsch beschreiben, was zu Missverständnissen führte.

Bisheriger Ablauf: Telefonanruf, Foto-Wirrwarr, Sprachbarriere – am Ende kein Nachweis

Ziele

Ein Meldeweg, den Fahrer bereits täglich nutzen (Threema), soll ohne neue App zum strukturierten Nachweis führen: geführter Dialog, feste Vorgangsarten und Checklisten, Pflicht-Fotos, automatische PDF-Erstellung und direkter Versand an die Dispo per Mail — mehrsprachig lesbar, aber intern einheitlich auf Deutsch gespeichert.

Ergebnis

Ein Fahrer schreibt den Bot per Threema an, beantwortet wenige Fragen mit Zahlen (Vorgangsart, Checkliste) und schickt Fotos. Der Bot erkennt den Fahrer automatisch, führt den Dialog in dessen bevorzugter Sprache, prüft Pflichtfelder und Pflichtfotos, erzeugt anschließend einen vollständigen PDF-Nachweis mit eingebetteten Fotos und verschickt ihn automatisch per Mail an die Disposition — ganz ohne manuellen Zwischenschritt.

Was ist der Fahrer-Nachweis-Agent

Schadensdoku, die der Fahrer im Chat erledigt — nicht auf Papier.

Passiert unterwegs etwas — Palettenschaden, Temperaturbruch, fehlende Ware — schreibt der Fahrer einfach den Bot per Threema an. Der Bot kennt ihn, fragt das Nötige ab und macht daraus einen sauberen, vollständigen Nachweis. Die Dispo bekommt ihn in Minuten, nicht am nächsten Tag.

  • Geführter Chat

    Der Bot fragt Schritt für Schritt: Tour, was passiert ist, welche Fotos noch fehlen. Der Fahrer tippt nur Zahlen.

  • Mehrsprachig

    Fragen in der Sprache des Fahrers (Deutsch, Russisch, Polnisch). Der Nachweis für die Dispo bleibt immer Deutsch.

  • Foto-Checkliste

    Der Bot fordert die Pflichtfotos gezielt an und schließt erst ab, wenn nichts mehr fehlt — Schluss mit unbrauchbaren Meldungen.

  • PDF an die Dispo

    Aus dem Gespräch entsteht automatisch ein PDF-Nachweis mit Fotos — direkt per E-Mail an die Disposition.

Der Dialog

So sieht es auf dem Handy des Fahrers aus.

Kein Formular, keine App — nur ein Chat. Der Bot fragt, der Fahrer tippt Zahlen und schickt Fotos. Am Ende steht der Nachweis in der Dispo.

  • Mehrsprachig

    Fragen in der Sprache des Fahrers — z. B. Russisch «Поддон повреждён». Der Nachweis für die Dispo bleibt Deutsch.

  • Sprachnachricht

    Reden statt tippen — wird automatisch transkribiert (in Vorbereitung).

  • Geführte Foto-Checkliste

    Der Bot fordert die fehlenden Pflichtfotos gezielt nach — nichts geht verloren.

  • Datenschutz

    Nur an den Bot gesendete Nachrichten, nur registrierte Fahrer. Kein Standort-Tracking.

Ergebnis an die Disposition

An: dispo@ihr-unternehmen.de

Betreff: Schadensnachweis · Tour 913 · 13.06.2026

nachweis.pdffotos (3)

Die Lösung

Ein Chat. Ein Nachweis. Direkt in der Dispo-Inbox.

Der Fahrer-Nachweis-Agent ist ein Backend-Service, der über n8n als Transportschicht mit dem Threema Gateway verbunden ist. Ein Zustandsautomat führt jeden Fahrer durch einen klar geführten Dialog: Begrüßung mit Namen, Tour-Nummer, Vorgangsart (Schaden, fehlende Ware, Temperaturabweichung u. a.), eine vorgangsspezifische Checkliste, Pflicht-Fotos und eine Abschluss-Bestätigung.

Ein Fahrer-Register dient zugleich als Zugriffs-Whitelist und Sprachquelle — jeder Fahrer hat einen Kompetenz-Index je Sprache (Deutsch/Russisch/Polnisch), der Bot wählt automatisch die beste Sprache oder erzwingt bei Bedarf Deutsch. Alle Antworten werden intern einheitlich auf Deutsch gespeichert.

Am Ende erzeugt das System automatisch einen PDF-Nachweis mit eingebetteten Fotos und verschickt ihn per SMTP direkt an die Disposition — ohne Zwischenspeicherung in fremden Cloud-Diensten. Ein Admin-Dashboard erlaubt Auswertung, Vorgangsliste mit PDF-Download und die Verwaltung des Fahrer-Registers, live und ohne Neustart.

Vorgangsarten

9 Vorfall-Typen. Ein Ablauf. Je Typ die richtige Checkliste.

Der Bot erkennt, worum es geht, und stellt genau die passenden Fragen — von Palettenschaden bis Kühlkette. Neue Typen sind nur Konfiguration, kein Umbau.

  1. Schaden

    Palette, Ware, Verpackung

    + Foto-Pflicht
  2. Keine Ware

    Fehlmenge, nicht geladen

    AU24
  3. Keine Rollis

    Rollcontainer fehlen

    RL24
  4. Temperatur

    Kühlkette unterbrochen

    + Foto-Pflicht
  5. Tankung

    Beleg, Diesel, AdBlue

    TB24
  6. Verspätung

    Stau, Rampe, Wartezeit

    + Uhrzeit
  7. Fahrzeugübergabe

    Übernahme, Rückgabe

    + Foto-Pflicht
  8. Hygiene

    Verschmutzung, Geruch

    + Foto-Pflicht
  9. Sonstiges

    Alles Weitere

    frei

Kritisch markiert: Schaden · Temperatur · Hygiene

Architektur

Threema → n8n → Backend → Dispo. Alles im eigenen Netz.

n8n nimmt die Threema-Nachrichten entgegen, das Backend führt den Dialog, speichert die Vorgänge und erzeugt Nachweis & E-Mail. Self-hosted, ohne Drittanbieter.

  1. Fahrer

    Fahrer · Threema

    meldet an Bot-ID

  2. Transport

    n8n · Webhook

    Proxmox · Transport

  3. Backend

    Backend

    Node · geführter Dialog · SQLite · PDF · Whitelist

  4. Ergebnis

    E-Mail an Dispo

    PDF-Nachweis + Fotos · Admin-Dashboard (Auswertung · Fahrer) · Ablage (Vorgänge · PDFs · Fotos)

  • n8n als Transport

    Empfang & Rückantwort laufen über n8n — die Fachlogik bleibt im Backend, sauber getrennt.

  • Zustand im Backend

    Der Dialog wird serverseitig geführt und gespeichert — portierbar, auch Richtung PHP/MariaDB.

  • Self-hosted

    Läuft im eigenen Netz (Proxmox). Keine Cloud-KI, keine Fahrerdaten bei Dritten.

Kern-Feature · Auswertung & Dashboard

Weniger Aufwand, mehr Übersicht — messbar.

Jeder Nachweis landet in der Datenbank. Das Admin-Dashboard zeigt Top-Nutzer, offene und kritische Vorgänge — und macht sichtbar, wie viel Zeit der Agent im Betrieb spart.

Nachweis-Dashboard — Monat

Nachweise / Monat
80

5,3 ø / Fahrer

Ø Zeit / Nachweis
3 Min

statt 18 Min

Zeitersparnis
20 Std

pro Monat

Vollständig
96 %

vorher ~70 %

Bis zur Dispo
< 5 Min

statt Stunden

Streitfälle
−35 %

lückenlose Doku

Vollständige Nachweise pro Kalenderwoche
  1. 94%KW01
  2. 96%KW02
  3. 95%KW03
  4. 97%KW04
  5. 96%KW05
  • Geführter Zustandsautomat

    Der Bot merkt sich pro Fahrer den Gesprächsstand — Tour, Vorgangsart, Fotos, Bestätigung — bis der Nachweis komplett ist.

    Mehrturn · pro Fahrer · Timeout

  • Fahrer-Register — live

    Fahrer im Dashboard anlegen oder sperren; der Bot zieht die aktive Liste sofort, ohne Neustart. Nur registrierte Fahrer werden bedient.

    Whitelist · Sprache je Fahrer

  • Foto-Pflicht erzwungen

    Kritische Vorgänge werden erst abgeschlossen, wenn die Pflichtfotos da sind — die Nachweis-Quote steigt spürbar.

    Detailfoto · Standort · Label

  • PDF + Fotos automatisch

    Beim Abschluss geht ein deutscher PDF-Nachweis mit den Fotos direkt an die Dispo — kein manuelles Sortieren mehr.

    PDF · E-Mail · SMTP

Sicherheit & DSGVO

Nur registrierte Fahrer. Keine Fremddaten. Kein Tracking.

  1. Admin / Dispo

    Dashboard · Fahrer · Auswertung

    Login
  2. Registrierter Fahrer

    Meldet über Threema, per Zahl

    Whitelist
  3. Unbekannte ID

    Keine Antwort · nichts gespeichert

    gesperrt
  • Whitelist statt offen

    Der Bot antwortet ausschließlich registrierten Threema-IDs. Von unbekannten Absendern wird nichts verarbeitet oder gespeichert.

  • Self-hosted & verschlüsselt

    Läuft im eigenen Netz, Threema ist Ende-zu-Ende verschlüsselt. Keine Fahrerdaten bei Cloud-Diensten Dritter.

  • Datensparsam

    Nur aktiv an den Bot gesendete Meldungen werden verarbeitet. Kein Standort-Tracking, keine private Chat-Auswertung.

Unter der Haube

Sauber gebaut, bewusst schlank.

Klare Schichten, wenig Abhängigkeiten, alles testbar. Die Fachlogik ist vom Framework getrennt — damit portierbar und wartungsarm.

  • Node.js
  • TypeScript
  • n8n
  • SQLite
  • pdf-lib
  • Zod
  • nodemailer
  • Threema Gateway
  • ~26 Tests
  • Kern

    Dialog-Zustandsautomat

    Reine, getestete Logik führt das Gespräch — sprachunabhängig, gut erweiterbar um neue Vorgangsarten.

  • Kern

    Mehrsprachige Vorlagen

    Feste Fragen in DE/RU/PL, Antworten per Zahl. Kein Live-Übersetzer nötig — datensparsam und schnell.

  • Kern

    Self-hosted-Betrieb

    SQLite, lokale Foto-Ablage, PDF-Erzeugung und E-Mail — läuft komplett im eigenen Netz.

Prozess automatisieren?

Wir bauen solche Workflows passgenau auf Ihre Systeme.