HandwerksHeld — der digitale Schreibtisch fürs Handwerk
WhatsApp-Bot mit menschlicher Freigabe, CRM mit Kundenakte, Angebots-PDF und installierbare PWA. Eigenständig konzipiert, gebaut und produktiv auf handwerksheld.org geschaltet.
Ausgangslage
Im Handwerk landen Anfragen über drei Kanäle gleichzeitig: Anruf, WhatsApp, Empfehlung. Was an einem vollen Tag verloren geht, kommt selten zurück. Drei wiederkehrende Schmerzpunkte:
- Anrufe gehen unter. Wer auf der Baustelle ist, kann nicht abheben — und ein Rückruf am Abend ist oft zu spät.
- Angebote dauern Tage. Pauschalfragen erfordern Rückfragen, Rückfragen erfordern Termine, Termine kosten den Werktag.
- Kein zentrales Kunden-Bild. Kontaktdaten in WhatsApp, Termine im Kopf, Notizen im Block — keine gemeinsame Wahrheit.
Was wir gebaut haben
HandwerksHeld bündelt diese drei Kanäle in eine Web-App, die im Browser und als installierbare PWA auf dem Handy läuft.
WhatsApp-Bot mit Telegram-Approval
Eingehende WhatsApp-Nachrichten landen über die Meta Cloud API in einem LangGraph-Conversation-Flow. Der Bot fragt strukturiert nach Anliegen, Adresse und Wunschtermin. Sensitive oder offene Antworten werden nicht autonom verschickt — sie laufen über einen Telegram-Approval-Kanal, in dem der Betrieb mit einem Tap freigibt, bearbeitet oder ablehnt.
CRM mit Kundenakte
Jede Konversation, jeder Anruf, jeder Termin landet auf einer Customer-Entität. Der „Kunden"-Tab ist ein eigener Bereich in der App: Verlauf, Notizen, offene Angebote und nächste Schritte auf einer Seite — ohne externes CRM-Lock-in.
Angebots-PDF, Kalender und Google-Reviews
Aus den im Bot erfassten Daten lässt sich ein erstes Angebot als PDF erzeugen. Termine landen direkt im integrierten Kalender. Nach abgeschlossenem Auftrag wird automatisch ein Review-Link für Google Business verschickt — der häufigste Wachstumshebel im lokalen Handwerk.
PWA mit Web-Push
Die App ist als Progressive Web App auf dem Homescreen installierbar — kein App-Store, keine native Build-Pipeline. Web-Push-Benachrichtigungen melden eingehende Anfragen und Approval-Requests in Echtzeit, auch wenn der Browser geschlossen ist.
Frühe Signale (Stand 2026-04-30)
HandwerksHeld ist in produktivem Betrieb. Statt aggregierter Vorab-Metriken halten wir hier ehrlich fest, was bisher nachweislich funktioniert:
- Bot-Konversationen laufen produktiv über den Meta-Webhook — von Erstkontakt bis strukturierter Antwort an den Betrieb.
- CRM-Tab mit Customer-Entität und Kunden-Übersicht ist live im Frontend, vollständig getragen vom eigenen Datenmodell.
- PWA ist auf iOS und Android installierbar; Web-Push-Benachrichtigungen werden für Approval-Requests zugestellt.
- Telegram-Approval-Workflow stoppt Halluzinationen vor dem Versand — der Mensch bleibt im Loop, ohne den Geschwindigkeitsvorteil zu verlieren.
Belastbare Conversion- und Antwortzeit-Metriken werden nach dem ersten vollständigen Quartal mit produktiven Kunden ergänzt — nicht vorher behauptet.
Tech-Stack
- Frontend
- Next.js · Prisma · TypeScript · PWA
- Backend
- FastAPI · LangGraph · SQLAlchemy · Python
- Datenbank
- PostgreSQL (Railway)
- Messaging
- Meta WhatsApp Cloud API · Telegram Bot API
- Push
- Web-Push (VAPID)
- Hosting
- Railway · Custom Domain · Health-Checks
Takeaway
HandwerksHeld zeigt, was wir mit unserer Arbeitsweise meinen — eine produktive Web-App in zwei Quartalen, ohne Lock-in, ohne Over-Engineering. Ein Ansprechpartner, ein Stack, ein klar dokumentierter Übergabestand.
Eigenes Projekt im Kopf? 30 Minuten Erstgespräch vereinbaren →