WhatsApp Business Integration
Sophie hier! WhatsApp Business ist eine meiner Lieblingsintegrationen – Ihre Kunden erhalten Rechnungen und Zahlungserinnerungen direkt auf ihr Smartphone. Über 90% Öffnungsrate im Vergleich zu E-Mails! Und natürlich DSGVO-konform mit Einwilligung. Verfügbar ab Pro-Tarif.
Voraussetzungen
Bevor Sie WhatsApp Business Integration nutzen können, stellen Sie sicher, dass folgende Anforderungen erfüllt sind:
| Voraussetzung | Beschreibung | Status |
|---|---|---|
| BuchhaltGenie Pro-Tarif | WhatsApp Integration ist ab Pro verfügbar (€49.99/Monat) | Erforderlich |
| WhatsApp Business Account | Registrierter WhatsApp Business Account (nicht privater Account!) | Erforderlich |
| Geschäftstelefonnummer | Österreichische Telefonnummer im E.164 Format (z.B. +436641234567) | Erforderlich |
| Firmenbuchnummer | Für WhatsApp Business Verifizierung | Erforderlich |
| DSGVO-Einwilligung | Kunden müssen aktiv einwilligen (Art. 6(1)(a) DSGVO) | Erforderlich |
| 360dialog API-Key | Wird nach Registrierung bei 360dialog bereitgestellt | Erforderlich |
| Template-Genehmigung | WhatsApp-genehmigte Nachrichtentemplates (24-48h Genehmigungszeit) | Empfohlen |
| Opt-out-Prozess | Dokumentierter Widerrufsprozess für Kunden (DSGVO Art. 7) | Erforderlich |
Wichtig: Die verwendete Geschäftstelefonnummer kann NICHT gleichzeitig für einen privaten WhatsApp Account verwendet werden. Nutzen Sie eine dedizierte Firmennummer.
Überblick
BuchhaltGenie nutzt 360dialog als zertifizierten WhatsApp Business Solution Provider für die Integration mit der offiziellen WhatsApp Business API. Dies ermöglicht:
- Automatisierte Benachrichtigungen: Rechnungen, Zahlungserinnerungen, Mahnungen
- Bidirektionale Kommunikation: Kunden können auf Nachrichten antworten
- Template-basiert: Alle Nachrichten verwenden von WhatsApp genehmigte Templates
- DSGVO-konform: Einwilligungsbasiert mit Opt-out-Möglichkeit
- Zustellstatus-Tracking: Sehen Sie, ob Nachrichten zugestellt und gelesen wurden
- Rate Limiting: Automatischer Schutz vor Spam und API-Überlastung
Technische Architektur
Die Integration basiert auf einer Event-Driven Architektur:
BuchhaltGenie EventBus → WhatsApp Service → 360dialog API → WhatsApp Business API → KundeWebhook-Flows:
- Eingehende Nachrichten:
POST /api/whatsapp/webhook - Status-Updates: Delivery Reports, Read Receipts
- Opt-out Handling: Automatische Sperrung bei STOP-Keywords
Unterstützte Nachrichtentypen
| Nachrichtentyp | Trigger | Template | Beispiel |
|---|---|---|---|
| Rechnungsversand | Rechnung erstellt | invoice_created | ”Ihre Rechnung RE-2026-001 ist verfügbar” |
| Zahlungserinnerung | Fälligkeit in 3 Tagen | payment_reminder | ”Erinnerung: Zahlung fällig am 15.02.2026” |
| Zahlungsbestätigung | Zahlung eingegangen | payment_received | ”Zahlung über €1.500,00 erhalten” |
| Mahnung (1. Stufe) | Überfällig 7 Tage | overdue_notice_1 | ”Zahlungserinnerung: 7 Tage überfällig” |
| Mahnung (2. Stufe) | Überfällig 14 Tage | overdue_notice_2 | ”2. Mahnung: Bitte umgehend begleichen” |
| Angebot versendet | Angebot erstellt | quote_sent | ”Ihr Angebot ANG-2026-042 wurde erstellt” |
Alle Templates müssen vorab durch WhatsApp genehmigt werden. Der Genehmigungsprozess dauert typischerweise 24-48 Stunden.
Österreichische Telefonnummern
WhatsApp Business API erfordert E.164 Format für internationale Telefonnummern:
Formatierung
| Eingabe (AT) | E.164 Format | Gültig? |
|---|---|---|
0664 1234567 | +436641234567 | ✅ |
+43 664 1234567 | +436641234567 | ✅ |
06641234567 | +436641234567 | ✅ |
0043664... | +436641234567 | ✅ |
664 1234567 | ❌ Ungültig | ❌ |
Automatische Konvertierung:
- Führende
0wird durch+43ersetzt - Leerzeichen und Bindestriche werden entfernt
0043wird zu+43normalisiert
BuchhaltGenie konvertiert österreichische Telefonnummern automatisch ins E.164 Format. Stellen Sie sicher, dass Kundennummern mit 0 oder +43 beginnen.
Einrichtung
WhatsApp Business Account erstellen
- Besuchen Sie business.whatsapp.com
- Registrieren Sie Ihr Unternehmen mit:
- Firmenbuchnummer (österreichisches Handelsregister)
- Geschäftstelefonnummer (nicht Ihre persönliche Nummer!)
- Unternehmensadresse
- Verifizieren Sie Ihre Telefonnummer per SMS/Anruf
Die verwendete Telefonnummer kann nicht gleichzeitig für einen privaten WhatsApp Account genutzt werden.
360dialog Verbindung herstellen
- Öffnen Sie in BuchhaltGenie: Einstellungen → Integrationen → WhatsApp
- Klicken Sie auf “Mit 360dialog verbinden”
- Autorisieren Sie BuchhaltGenie im 360dialog Dashboard
- Kopieren Sie den API-Key in BuchhaltGenie
- Testen Sie die Verbindung mit “Testbenachrichtigung senden”
Templates genehmigen lassen
- Gehen Sie zu Einstellungen → WhatsApp Templates
- Wählen Sie die gewünschten Templates aus:
- ✅ Rechnungsversand
- ✅ Zahlungserinnerungen
- ✅ Mahnungen
- Klicken Sie auf “Templates zur Genehmigung einreichen”
- Warten Sie auf WhatsApp-Genehmigung (24-48h)
- Status wird automatisch aktualisiert
Testbenachrichtigung senden
- Öffnen Sie eine beliebige Rechnung
- Klicken Sie auf Aktionen → WhatsApp-Test senden
- Geben Sie Ihre eigene Nummer ein (Format:
+436641234567) - Überprüfen Sie den Empfang auf Ihrem WhatsApp
Rate Limits
360dialog und WhatsApp Business API haben folgende Limits:
| Limit-Typ | Business Tier | Enterprise Tier | Beschreibung |
|---|---|---|---|
| Nachrichten/24h | 1.000 | 10.000 | Maximale ausgehende Nachrichten |
| Template Messages | Unbegrenzt | Unbegrenzt | Von WhatsApp genehmigte Templates |
| Session Messages | 24h Fenster | 24h Fenster | Antworten auf Kundennachrichten |
| Neue Konversationen/Tag | 250 | 1.000 | Erstmalige Kontaktaufnahmen |
Wie funktioniert das 24-Stunden-Fenster?
Kunde sendet Nachricht → 24h Fenster öffnet sich
├─ Innerhalb 24h: Freie Antworten möglich (Session Messages)
└─ Nach 24h: Nur noch Template Messages erlaubtSophie AI Tipp: Wenn Sie mehr als 1.000 Kunden haben, empfehlen wir ein Enterprise-Upgrade bei 360dialog. Ihre aktuellen Limits sehen Sie unter Einstellungen → WhatsApp → API-Nutzung.
DSGVO-Konformität
Die WhatsApp Integration erfüllt folgende DSGVO-Anforderungen:
Art. 6(1)(a) - Einwilligung
Kunden müssen aktiv einwilligen, bevor sie WhatsApp-Benachrichtigungen erhalten:
// Beispiel: Einwilligung im Kundenprofil
{
"whatsapp_opt_in": true,
"whatsapp_opt_in_date": "2026-01-31T10:30:00Z",
"whatsapp_opt_in_ip": "192.0.2.1"
}Einwilligungstext:
“Ich möchte Rechnungen, Zahlungserinnerungen und Mahnungen per WhatsApp erhalten. Ich kann diese Einwilligung jederzeit widerrufen.”
Art. 7 - Widerruf
Kunden können die Einwilligung jederzeit widerrufen:
- In BuchhaltGenie: Kundenprofil → WhatsApp-Benachrichtigungen deaktivieren
- Per WhatsApp: Antwort mit “STOP”, “ABMELDEN”, “OPT-OUT”
- Automatisch: Nach 3 fehlgeschlagenen Zustellversuchen
Bei Opt-out werden keine weiteren Nachrichten an diese Nummer gesendet, auch nicht für andere Kunden mit derselben Nummer.
Art. 13 - Informationspflicht
In der ersten WhatsApp-Nachricht wird automatisch hinzugefügt:
“Diese Nachricht wurde von [Ihr Firmenname] gesendet. Datenschutzhinweise: [Link]. Abmelden: Antworten Sie mit STOP.”
Zustellstatus & Delivery Tracking
BuchhaltGenie trackt den Status jeder WhatsApp-Nachricht in Echtzeit:
Status-Übersicht
| Status | Icon | Beschreibung | Aktion erforderlich |
|---|---|---|---|
| Gesendet | ✓ | Nachricht wurde an 360dialog API übermittelt | Nein |
| Zugestellt | ✓✓ | WhatsApp hat die Nachricht zugestellt | Nein |
| Gelesen | ✓✓ | Kunde hat die Nachricht geöffnet (Read Receipt) | Nein |
| Fehlgeschlagen | ❌ | Zustellung fehlgeschlagen (ungültige Nummer, blockiert) | Ja - Nummer prüfen |
| Abgelehnt | 🚫 | Kunde hat Benachrichtigungen deaktiviert (Opt-out) | Nein - respektieren |
Wo sehe ich den Status?
Im Rechnungsdetail:
- Öffnen Sie die entsprechende Rechnung
- Scrollen Sie zu “Versandhistorie”
- Status wird mit Zeitstempel angezeigt:
📱 WhatsApp-Benachrichtigung
✓✓ Zugestellt: 31.01.2026, 10:45 Uhr
✓✓ Gelesen: 31.01.2026, 10:47 UhrIm Aktivitätslog:
- Dashboard → Aktivität → Filter “WhatsApp”
- Zeigt alle gesendeten Nachrichten mit Status
Automatische Fehlerbehandlung
Bei fehlgeschlagenen Zustellungen (Status “Fehlgeschlagen”):
- Erster Versuch: Automatischer Retry nach 5 Minuten
- Zweiter Versuch: Retry nach 30 Minuten
- Dritter Versuch: Finaler Retry nach 2 Stunden
- Nach 3 Fehlversuchen:
- Kunde wird automatisch aus WhatsApp-Benachrichtigungen ausgetragen (Opt-out)
- Fallback auf E-Mail-Benachrichtigung (falls konfiguriert)
- Admin erhält Benachrichtigung über fehlgeschlagene Zustellung
Sophie AI Tipp: Über 95% der WhatsApp-Nachrichten werden innerhalb von 30 Sekunden zugestellt und gelesen. Falls eine Nachricht nach 5 Minuten nicht zugestellt ist, prüfen Sie die Telefonnummer im Kundenprofil.
Webhook-Status-Updates
BuchhaltGenie empfängt Status-Updates über Webhooks von 360dialog:
// Beispiel-Payload für Status-Update
{
"statuses": [{
"id": "wamid.abc123",
"recipient_id": "+436641234567",
"status": "read",
"timestamp": "1738316820",
"conversation": {
"id": "conv_abc123",
"expiration_timestamp": "1738403220"
}
}]
}Diese Updates werden automatisch verarbeitet und im Rechnungsdetail angezeigt.
Häufig gestellte Fragen (FAQ)
Allgemeine Fragen
Kann ich WhatsApp auch für private Konten meiner Kunden nutzen?
Ja! Die WhatsApp Business API kann Nachrichten an alle WhatsApp-Nummern senden, egal ob privat oder geschäftlich. Ihre Kunden benötigen keinen WhatsApp Business Account.
Kostet WhatsApp Business zusätzliche Gebühren?
360dialog-Gebühren:
- Erste 1.000 Nachrichten/Monat: €0,05 pro Nachricht
- Ab 1.001 Nachrichten: €0,04 pro Nachricht
- Eingehende Nachrichten von Kunden: Kostenlos
Diese Kosten werden separat von 360dialog abgerechnet, nicht von BuchhaltGenie. Der BuchhaltGenie Pro-Tarif inkludiert die Integration, aber nicht die Nachrichtenkosten.
Wie schnell werden Nachrichten zugestellt?
Typische Zustellzeiten:
- Sofortzustellung: 95% innerhalb 30 Sekunden
- Normale Zustellung: 99% innerhalb 5 Minuten
- Verzögert: 1% bei schlechter Internetverbindung des Empfängers
Falls eine Nachricht nach 5 Minuten nicht zugestellt ist, prüft BuchhaltGenie automatisch die Telefonnummer und sendet eine E-Mail-Benachrichtigung (Fallback).
Kann ich WhatsApp-Nachrichten personalisieren?
Ja, mit Template-Variablen:
{{customer_name}}- Kundenname (z.B. “Herr Müller”){{invoice_number}}- Rechnungsnummer (z.B. “RE-2026-001”){{amount}}- Betrag (z.B. “€1.500,00”){{due_date}}- Fälligkeitsdatum (z.B. “15.02.2026”){{company_name}}- Ihr Firmenname
Alle Templates müssen vorab von WhatsApp genehmigt werden (24-48h).
DSGVO & Datenschutz
Wie hole ich die DSGVO-Einwilligung meiner Kunden ein?
Empfohlener Prozess:
-
Bei Kundenerstellung: Checkbox “WhatsApp-Benachrichtigungen aktivieren”
-
Einwilligungstext:
“Ich möchte Rechnungen, Zahlungserinnerungen und Mahnungen per WhatsApp erhalten. Ich kann diese Einwilligung jederzeit widerrufen. Datenschutzhinweise”
-
Dokumentation:
- Zeitstempel der Einwilligung
- IP-Adresse (optional, für Beweiszwecke)
- Wortlaut des Einwilligungstexts
BuchhaltGenie speichert diese Daten automatisch im Kundenprofil.
Was passiert bei Opt-out (Widerruf)?
Automatischer Opt-out-Prozess:
- Kunde antwortet mit “STOP”, “ABMELDEN” oder “OPT-OUT”
- BuchhaltGenie markiert die Nummer als “Opt-out”
- Keine weiteren Nachrichten werden an diese Nummer gesendet
- Fallback auf E-Mail-Benachrichtigung (falls konfiguriert)
- Admin erhält Benachrichtigung über Opt-out
Kunden können jederzeit über ihr Kundenprofil WhatsApp-Benachrichtigungen wieder aktivieren (Opt-in).
Werden WhatsApp-Nachrichten verschlüsselt?
Ja, End-to-End-Verschlüsselung:
- Alle WhatsApp-Nachrichten sind End-to-End verschlüsselt (E2EE)
- Weder BuchhaltGenie noch 360dialog können Nachrichteninhalte lesen
- Erfüllt DSGVO Art. 32 (Datensicherheit)
Metadaten: Telefonnummern und Zustellstatus werden für max. 90 Tage gespeichert (DSGVO Art. 5(1)(e) - Speicherbegrenzung).
Technische Fragen
Was ist der Unterschied zwischen Template Messages und Session Messages?
| Message-Typ | Beschreibung | Genehmigung erforderlich | Zeitfenster |
|---|---|---|---|
| Template Message | Vordefinierte Templates (z.B. Rechnungserinnerung) | ✅ Ja (24-48h) | Unbegrenzt |
| Session Message | Freie Antworten auf Kundennachrichten | ❌ Nein | 24h nach Kunde |
Beispiel Session Window:
10:00 Uhr - Kunde sendet Nachricht "Wann kommt meine Rechnung?"
10:00-34:00 Uhr - Sie können frei antworten (Session Window)
Nach 34:00 Uhr - Nur noch Template Messages möglichKann ich Anhänge (PDFs) über WhatsApp senden?
Ja, mit Einschränkungen:
- Dateitypen: PDF, JPG, PNG
- Maximale Größe: 16 MB pro Datei
- Rechnungs-PDF: Automatisch als Anhang mitgesendet
- Angebots-PDF: Automatisch bei Angebotsversand
Achtung: Große Dateien können bei schlechter Internetverbindung des Empfängers zu Zustellproblemen führen. Empfehlung: PDFs unter 5 MB halten.
Was passiert, wenn mein Rate Limit überschritten wird?
Rate Limit-Schutz:
- Warnung bei 80%: Admin erhält E-Mail-Benachrichtigung
- Soft-Limit bei 90%: Neue Nachrichten werden in Queue gestellt (max. 24h)
- Hard-Limit bei 100%: Weitere Nachrichten werden abgelehnt, Fallback auf E-Mail
- Automatisches Reset: Täglich um 00:00 UTC
Aktuelle Nutzung: Dashboard → Einstellungen → WhatsApp → API-Nutzung
Unterstützt BuchhaltGenie WhatsApp-Gruppen?
Nein, WhatsApp Business API unterstützt nur 1:1-Kommunikation (Business → Kunde). Gruppennachrichten sind nicht erlaubt und würden gegen WhatsApp Business Policy verstoßen.
Fehlerbehandlung
Was bedeutet “Template-Genehmigung abgelehnt”?
Häufige Ablehnungsgründe:
- Template enthält Rechtschreibfehler
- Unklare oder irreführende Formulierung
- Fehlende Opt-out-Hinweise
- Nicht-konforme Variablen-Syntax
Lösung:
- Prüfen Sie die WhatsApp-Feedback-Nachricht (im 360dialog Dashboard)
- Korrigieren Sie das Template
- Reichen Sie es erneut ein
- Genehmigungsdauer: 24-48h
Tipp: Nutzen Sie unsere vorgenehmigten Templates (unter Einstellungen → WhatsApp Templates).
Kunde erhält keine WhatsApp-Nachrichten – was tun?
Checkliste:
- ✅ Telefonnummer korrekt? (E.164 Format: +436641234567)
- ✅ Opt-in vorhanden? (Kundenprofil → WhatsApp-Benachrichtigungen)
- ✅ Nummer nicht blockiert? (Zustellstatus in Versandhistorie prüfen)
- ✅ Rate Limit nicht überschritten? (Dashboard → API-Nutzung)
- ✅ Template genehmigt? (Einstellungen → WhatsApp Templates)
- ✅ 360dialog API-Key gültig? (Testbenachrichtigung senden)
Falls alle Punkte erfüllt sind, wenden Sie sich an unseren Support: office@buchhaltgenie.at
Verfügbarkeit nach Tarif
| Funktion | Free | Starter | Pro | Business | Enterprise |
|---|---|---|---|---|---|
| WhatsApp Integration | ❌ | ❌ | ✅ | ✅ | ✅ |
| Automatische Benachrichtigung | ❌ | ❌ | ✅ | ✅ | ✅ |
| Bidirektionale Kommunikation | ❌ | ❌ | ✅ | ✅ | ✅ |
| Template-Verwaltung | ❌ | ❌ | ✅ | ✅ | ✅ |
| Erweiterte Rate Limits | ❌ | ❌ | ❌ | ✅ | ✅ |
| Dedizierter Support | ❌ | ❌ | ❌ | ❌ | ✅ |
Upgrade erforderlich? Die WhatsApp Integration ist ab dem Pro-Tarif verfügbar. Jetzt upgraden
Nächste Schritte
Schritt-für-Schritt-Anleitung zur Aktivierung von WhatsApp-Benachrichtigungen für Ihre Kunden
💬WhatsApp Benachrichtigungen einrichtenAlternative Benachrichtigungskanäle: E-Mail-Benachrichtigungen konfigurieren
📧E-Mail BenachrichtigungenKassensystem-Integrationen mit HelloCash, ETRON und Ready2Order
🏪POS IntegrationenCompliance-Tags
Diese Integration erfüllt folgende gesetzliche Anforderungen:
- DSGVO Art. 6(1)(a): Einwilligungsbasierte Datenverarbeitung
- DSGVO Art. 7: Widerrufsmöglichkeit jederzeit gewährleistet
- DSGVO Art. 13: Informationspflicht bei Datenerhebung erfüllt
Weitere Informationen zur Datenschutz-Konformität finden Sie in unserer Datenschutzerklärung.