Skip to Content
🔐 Closed Beta – Jetzt auf die Warteliste eintragen! Limitierte Plätze für Early Adopters →
De AtIntegrationenWhatsApp Business Integration

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:

VoraussetzungBeschreibungStatus
BuchhaltGenie Pro-TarifWhatsApp Integration ist ab Pro verfügbar (€49.99/Monat)Erforderlich
WhatsApp Business AccountRegistrierter WhatsApp Business Account (nicht privater Account!)Erforderlich
GeschäftstelefonnummerÖsterreichische Telefonnummer im E.164 Format (z.B. +436641234567)Erforderlich
FirmenbuchnummerFür WhatsApp Business VerifizierungErforderlich
DSGVO-EinwilligungKunden müssen aktiv einwilligen (Art. 6(1)(a) DSGVO)Erforderlich
360dialog API-KeyWird nach Registrierung bei 360dialog bereitgestelltErforderlich
Template-GenehmigungWhatsApp-genehmigte Nachrichtentemplates (24-48h Genehmigungszeit)Empfohlen
Opt-out-ProzessDokumentierter 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 → Kunde

Webhook-Flows:

  • Eingehende Nachrichten: POST /api/whatsapp/webhook
  • Status-Updates: Delivery Reports, Read Receipts
  • Opt-out Handling: Automatische Sperrung bei STOP-Keywords

Unterstützte Nachrichtentypen

NachrichtentypTriggerTemplateBeispiel
RechnungsversandRechnung erstelltinvoice_created”Ihre Rechnung RE-2026-001 ist verfügbar”
ZahlungserinnerungFälligkeit in 3 Tagenpayment_reminder”Erinnerung: Zahlung fällig am 15.02.2026”
ZahlungsbestätigungZahlung eingegangenpayment_received”Zahlung über €1.500,00 erhalten”
Mahnung (1. Stufe)Überfällig 7 Tageoverdue_notice_1”Zahlungserinnerung: 7 Tage überfällig”
Mahnung (2. Stufe)Überfällig 14 Tageoverdue_notice_2”2. Mahnung: Bitte umgehend begleichen”
Angebot versendetAngebot erstelltquote_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 FormatGültig?
0664 1234567+436641234567
+43 664 1234567+436641234567
06641234567+436641234567
0043664...+436641234567
664 1234567❌ Ungültig

Automatische Konvertierung:

  • Führende 0 wird durch +43 ersetzt
  • Leerzeichen und Bindestriche werden entfernt
  • 0043 wird zu +43 normalisiert
🇦🇹

BuchhaltGenie konvertiert österreichische Telefonnummern automatisch ins E.164 Format. Stellen Sie sicher, dass Kundennummern mit 0 oder +43 beginnen.


Einrichtung

WhatsApp Business Account erstellen

  1. Besuchen Sie business.whatsapp.com 
  2. Registrieren Sie Ihr Unternehmen mit:
    • Firmenbuchnummer (österreichisches Handelsregister)
    • Geschäftstelefonnummer (nicht Ihre persönliche Nummer!)
    • Unternehmensadresse
  3. Verifizieren Sie Ihre Telefonnummer per SMS/Anruf

Die verwendete Telefonnummer kann nicht gleichzeitig für einen privaten WhatsApp Account genutzt werden.

360dialog Verbindung herstellen

  1. Öffnen Sie in BuchhaltGenie: EinstellungenIntegrationenWhatsApp
  2. Klicken Sie auf “Mit 360dialog verbinden”
  3. Autorisieren Sie BuchhaltGenie im 360dialog Dashboard
  4. Kopieren Sie den API-Key in BuchhaltGenie
  5. Testen Sie die Verbindung mit “Testbenachrichtigung senden”

Templates genehmigen lassen

  1. Gehen Sie zu EinstellungenWhatsApp Templates
  2. Wählen Sie die gewünschten Templates aus:
    • ✅ Rechnungsversand
    • ✅ Zahlungserinnerungen
    • ✅ Mahnungen
  3. Klicken Sie auf “Templates zur Genehmigung einreichen”
  4. Warten Sie auf WhatsApp-Genehmigung (24-48h)
  5. Status wird automatisch aktualisiert

Testbenachrichtigung senden

  1. Öffnen Sie eine beliebige Rechnung
  2. Klicken Sie auf AktionenWhatsApp-Test senden
  3. Geben Sie Ihre eigene Nummer ein (Format: +436641234567)
  4. Überprüfen Sie den Empfang auf Ihrem WhatsApp

Rate Limits

360dialog und WhatsApp Business API haben folgende Limits:

Limit-TypBusiness TierEnterprise TierBeschreibung
Nachrichten/24h1.00010.000Maximale ausgehende Nachrichten
Template MessagesUnbegrenztUnbegrenztVon WhatsApp genehmigte Templates
Session Messages24h Fenster24h FensterAntworten auf Kundennachrichten
Neue Konversationen/Tag2501.000Erstmalige 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 erlaubt
📊

Sophie AI Tipp: Wenn Sie mehr als 1.000 Kunden haben, empfehlen wir ein Enterprise-Upgrade bei 360dialog. Ihre aktuellen Limits sehen Sie unter EinstellungenWhatsAppAPI-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:

  1. In BuchhaltGenie: Kundenprofil → WhatsApp-Benachrichtigungen deaktivieren
  2. Per WhatsApp: Antwort mit “STOP”, “ABMELDEN”, “OPT-OUT”
  3. 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

StatusIconBeschreibungAktion erforderlich
GesendetNachricht wurde an 360dialog API übermitteltNein
Zugestellt✓✓WhatsApp hat die Nachricht zugestelltNein
Gelesen✓✓Kunde hat die Nachricht geöffnet (Read Receipt)Nein
FehlgeschlagenZustellung 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:

  1. Öffnen Sie die entsprechende Rechnung
  2. Scrollen Sie zu “Versandhistorie”
  3. Status wird mit Zeitstempel angezeigt:
📱 WhatsApp-Benachrichtigung ✓✓ Zugestellt: 31.01.2026, 10:45 Uhr ✓✓ Gelesen: 31.01.2026, 10:47 Uhr

Im Aktivitätslog:

  • DashboardAktivität → Filter “WhatsApp”
  • Zeigt alle gesendeten Nachrichten mit Status

Automatische Fehlerbehandlung

Bei fehlgeschlagenen Zustellungen (Status “Fehlgeschlagen”):

  1. Erster Versuch: Automatischer Retry nach 5 Minuten
  2. Zweiter Versuch: Retry nach 30 Minuten
  3. Dritter Versuch: Finaler Retry nach 2 Stunden
  4. 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:

  1. Bei Kundenerstellung: Checkbox “WhatsApp-Benachrichtigungen aktivieren”

  2. Einwilligungstext:

    “Ich möchte Rechnungen, Zahlungserinnerungen und Mahnungen per WhatsApp erhalten. Ich kann diese Einwilligung jederzeit widerrufen. Datenschutzhinweise

  3. 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:

  1. Kunde antwortet mit “STOP”, “ABMELDEN” oder “OPT-OUT”
  2. BuchhaltGenie markiert die Nummer als “Opt-out”
  3. Keine weiteren Nachrichten werden an diese Nummer gesendet
  4. Fallback auf E-Mail-Benachrichtigung (falls konfiguriert)
  5. 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-TypBeschreibungGenehmigung erforderlichZeitfenster
Template MessageVordefinierte Templates (z.B. Rechnungserinnerung)✅ Ja (24-48h)Unbegrenzt
Session MessageFreie Antworten auf Kundennachrichten❌ Nein24h 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öglich

Kann 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:

  1. Warnung bei 80%: Admin erhält E-Mail-Benachrichtigung
  2. Soft-Limit bei 90%: Neue Nachrichten werden in Queue gestellt (max. 24h)
  3. Hard-Limit bei 100%: Weitere Nachrichten werden abgelehnt, Fallback auf E-Mail
  4. Automatisches Reset: Täglich um 00:00 UTC

Aktuelle Nutzung: Dashboard → EinstellungenWhatsAppAPI-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:

  1. Prüfen Sie die WhatsApp-Feedback-Nachricht (im 360dialog Dashboard)
  2. Korrigieren Sie das Template
  3. Reichen Sie es erneut ein
  4. Genehmigungsdauer: 24-48h

Tipp: Nutzen Sie unsere vorgenehmigten Templates (unter EinstellungenWhatsApp Templates).

Kunde erhält keine WhatsApp-Nachrichten – was tun?

Checkliste:

  1. Telefonnummer korrekt? (E.164 Format: +436641234567)
  2. Opt-in vorhanden? (Kundenprofil → WhatsApp-Benachrichtigungen)
  3. Nummer nicht blockiert? (Zustellstatus in Versandhistorie prüfen)
  4. Rate Limit nicht überschritten? (Dashboard → API-Nutzung)
  5. Template genehmigt? (Einstellungen → WhatsApp Templates)
  6. 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

FunktionFreeStarterProBusinessEnterprise
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


Compliance-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.