Häufige Fehler bei WhatsApp-Kampagnen beheben

Beim Versand von WhatsApp-Kampagnen über SparkTG können gelegentlich Fehler auftreten, die die Zustellung von Nachrichten verhindern. Die meisten gehen auf Richtlinien von Meta (WhatsApp), Konfigurationsprobleme bei Vorlagen oder Beschränkungen auf Kontoebene zurück. Diese Anleitung geht jeden Fehlertyp durch, erklärt seine Bedeutung und zeigt, wie Sie ihn genau beheben.

1. Nachricht nicht zugestellt: Nummer nicht zustellbar

Schlägt eine Kampagnennachricht fehl und das Protokoll zeigt für einen bestimmten Kontakt einen Zustellfehler, liegt bei der Nummer des Empfängers wahrscheinlich eines dieser Probleme vor:

• Die Nummer ist nicht bei WhatsApp registriert oder das verknüpfte WhatsApp-Konto wurde deaktiviert.
• Die Ländervorwahl (+91 für Indien usw.) fehlt oder ist in Ihrer Kontaktliste falsch.
• Der Empfänger nutzt eine veraltete WhatsApp-Version, die keine Nachrichten der Business API empfangen kann.
• Der Empfänger hat die aktuellen Nutzungsbedingungen von WhatsApp nicht akzeptiert: Er muss WhatsApp öffnen und die aktualisierten Bedingungen akzeptieren, bevor Nachrichten zugestellt werden können.

1. 1

   Kontaktformat prüfen

   Öffnen Sie in SparkTG → Contacts den betroffenen Kontakt und stellen Sie sicher, dass die Nummer die vollständige Ländervorwahl enthält, ohne Leerzeichen oder Sonderzeichen. Beispiel: 919876543210 (nicht 09876543210).

2. 2

   Ungültige Nummern aus der Kampagne entfernen

   Nutzen Sie vor dem Senden einer Kampagne die Option Validate Numbers. SparkTG markiert Nummern, die nicht bei WhatsApp registriert sind, damit Sie sie vor dem Versand ausschließen können.

3. 3

   Empfänger bitten, WhatsApp zu aktualisieren

   Ist der Kontakt über einen anderen Kanal erreichbar, bitten Sie ihn, die WhatsApp-App zu aktualisieren und die aktuellen Nutzungsbedingungen zu akzeptieren, und versuchen Sie die Nachricht dann erneut.

2. Marketingnachricht durch Qualitätsbeschränkungen von Meta blockiert

Meta überwacht aktiv die Qualität von Marketingnachrichten, die über die Business API gesendet werden. Haben Ihre Vorlagen eine niedrige Qualitätsbewertung (meist weil Empfänger Ihre Nachrichten blockieren oder melden), schränkt Meta die Zustellung vorübergehend ein und fordert Sie auf, es nach einer Wartezeit erneut zu versuchen.

• Prüfen Sie den Inhalt Ihrer Vorlage: Stellen Sie sicher, dass er relevant und personalisiert ist und vom Empfänger erwartet wird.
• Prüfen Sie Ihre Kontaktliste: Entfernen Sie alle, die nicht ausdrücklich eingewilligt haben, WhatsApp-Nachrichten Ihres Unternehmens zu erhalten.
• Warten Sie, bis die Abkühlphase (üblicherweise 24–48 Stunden) abgelaufen ist, bevor Sie die Kampagne erneut versuchen.
• Prüfen Sie die Qualitätsbewertung Ihrer Vorlage unter Meta Business Manager → WhatsApp Manager → Message Templates.

3. Kontakt nicht erreichbar: Beschränkung durch ein Meta-Experiment

Seit Mitte 2023 führt Meta ein fortlaufendes Experiment durch, bei dem ein kleiner Prozentsatz der WhatsApp-Nutzer keine Marketing-Vorlagennachrichten von Unternehmen erhält, es sei denn, der Nutzer hat zuvor selbst eine Konversation begonnen. In den SparkTG-Kampagnenprotokollen erscheint dies als Zustellfehler bei bestimmten Kontakten.

• Betroffen sind nur Vorlagen der Kategorie Marketing. Utility- und Authentication-Vorlagen sind nicht betroffen.
• Gehört ein Kontakt zu diesem Experiment, können Sie ihm eine Marketingnachricht nur senden, nachdem Sie zuvor eine eingehende Nachricht von ihm erhalten haben.
• Sobald er Ihnen eine Nachricht gesendet hat, haben Sie ein 24-Stunden-Fenster, in dem Sie beliebige Vorlagennachrichten senden können, auch Marketingnachrichten.
• Kontaktieren Sie betroffene Kontakte über einen anderen Kanal (E-Mail, SMS, Telefonanruf) und bitten Sie sie, Ihnen eine WhatsApp-Nachricht zu senden, um die Sitzung zu eröffnen.

4. Kampagne pausiert: Messaging-Limit erreicht

WhatsApp setzt für alle Business-API-Konten gestufte tägliche Messaging-Limits durch: 1,000 → 10,000 → 100,000 eindeutige Kontakte pro 24 Stunden. Überschreitet Ihre Kampagne das Limit Ihrer aktuellen Stufe, wird der Versand von Nachrichten gestoppt, bis das 24-Stunden-Fenster zurückgesetzt wird.

1. 1

   Aktuelle Messaging-Stufe prüfen

   SparkTG Dashboard → WhatsApp → Channel Status. Hier sehen Sie Ihr aktuelles Limit und die Nutzung im gleitenden 24-Stunden-Fenster.

2. 2

   Auf das Zurücksetzen des Fensters warten

   Das 24-Stunden-Fenster ist gleitend und wird nicht zu einer festen Mitternacht zurückgesetzt. Sobald Kapazität frei wird, wird die pausierte Kampagne automatisch fortgesetzt, sofern der automatische Wiederholungsversuch aktiviert ist.

3. 3

   Messaging-Stufe mit der Zeit erhöhen

   Meta erhöht Ihre Stufe automatisch auf Basis konstant hoher Sendevolumina und einer guten Qualitätsbewertung. Es gibt keinen manuellen Antrag auf Aufstieg: Halten Sie die Zustellquoten hoch und die Blockierquoten niedrig, um schneller aufzusteigen.

5. Konto von Meta gesperrt oder eingeschränkt

Wurde Ihr WhatsApp Business Account (WABA) wegen Richtlinienverstößen markiert, kann Meta es einschränken oder vollständig deaktivieren. In diesem Fall zeigt SparkTG bei allen Kampagnen einen Fehler auf Kontoebene an.

1. 1

   Kontostatus im Meta Business Manager prüfen

   Melden Sie sich bei business.facebook.com → Settings → WhatsApp Accounts an. Ist es eingeschränkt, sehen Sie ein Banner mit dem Grund und einer Option zum Einspruch.

2. 2

   Einspruch bei Meta einreichen

   Klicken Sie im Meta Business Manager auf Request Review. Prüfungen dauern üblicherweise 24–48 Stunden. Sie erhalten eine E-Mail-Benachrichtigung, sobald eine Entscheidung getroffen wurde.

3. 3

   SparkTG-Support kontaktieren, wenn die Einschränkung aufgehoben wurde, der Fehler aber bleibt

   Sobald Meta die Einschränkung aufhebt, kann es bis zu 2 Stunden dauern, bis sich die Änderung auf der SparkTG-Plattform auswirkt. Besteht der Fehler danach weiter, erstellen Sie ein Support-Ticket mit Ihrer WABA ID.

6. Vorlagenfehler: Formatierung, Variablen und Genehmigungsprobleme

Vorlagenfehler sind die häufigste Kategorie von Fehlern bei WhatsApp-Kampagnen. Sie entstehen meist durch fehlende Variablen, falsche Formatierung oder eine von Meta pausierte oder abgelehnte Vorlage.

• Leere oder fehlende Variablen: Jeder Platzhalter {{variable}} in Ihrer Vorlage muss beim Versand einen Wert haben. Ist eine Variable leer, schlägt die Nachricht fehl. Prüfen Sie Ihre Kontaktdaten, damit alle erforderlichen Felder ausgefüllt sind.
• Fehlende oder ungültige Medien: Hat Ihre Vorlage eine Bild-, Video- oder Dokumentkopfzeile, muss bei jedem Versand eine gültige Mediendatei bereitgestellt werden. PDF ist das einzige unterstützte Format für Dokumentkopfzeilen.
• Zeilenumbrüche oder Tabulatoren in Variablen: Fügen Sie in den Wert einer Vorlagenvariable keine Zeilenumbrüche, Tabulatoren oder mehr als vier aufeinanderfolgende Leerzeichen ein; Meta lehnt die Nachricht sonst ab.
• Vorlage von Meta pausiert: Meta pausiert Vorlagen mit niedriger Qualitätsbewertung automatisch. Gehen Sie zu WhatsApp Manager → Message Templates und prüfen Sie den Status. Sie können den Inhalt als neue Vorlage erneut einreichen, wenn die ursprüngliche dauerhaft deaktiviert wurde.
• Vorlagenname nicht gefunden: Senden Sie über die SparkTG-API, prüfen Sie, ob der Vorlagenname exakt übereinstimmt; er unterscheidet Groß- und Kleinschreibung. Neu genehmigte Vorlagen können bis zu 30 Minuten brauchen, bis sie über die API verfügbar sind.

7. Nachrichten schlagen wegen Zahlungs- oder Abrechnungsproblemen fehl

WhatsApp berechnet pro Konversation (nicht pro Nachricht). Kann Meta Ihre Zahlungsmethode nicht belasten, schlagen ausgehende Nachrichten auf API-Ebene mit einem zahlungsbezogenen Fehlercode fehl.

1. 1

   Zahlungsmethode im Meta Business Manager prüfen

   Gehen Sie zu business.facebook.com → Settings → Payments. Prüfen Sie, ob eine gültige Zahlungsmethode hinterlegt ist und keine überfälligen Rechnungen bestehen.

2. 2

   Guthaben Ihres SparkTG-Kontos prüfen

   SparkTG Dashboard → Billing. Stellen Sie sicher, dass das Guthaben Ihres SparkTG-Kontos für das Kampagnenvolumen ausreicht. Kampagnen werden nicht versendet, wenn das Kontoguthaben unter den Mindestschwellenwert fällt.

3. 3

   Onboarding erneut prüfen, wenn Sie kürzlich migriert sind

   Haben Sie Ihre WhatsApp-Nummer kürzlich von einem anderen Anbieter zu SparkTG migriert, stellen Sie sicher, dass die Schritte Business Verification und Zahlungseinrichtung im Meta Business Manager vollständig abgeschlossen sind. Unvollständige Migrationen können anhaltende Zahlungsfehler verursachen.

8. Fehler beim Hochladen von Mediendateien

Enthält Ihre Vorlage eine Medienkopfzeile und der Upload schlägt fehl, wird der gesamte Kampagnenversand blockiert. WhatsApp stellt strenge Anforderungen an Format und Codec von Mediendateien.

• Bilder: müssen JPEG oder PNG sein, mit 8-Bit-Farbe, im RGB- oder RGBA-Modus. Maximale Dateigröße: 5 MB.
• Videos: müssen den Videocodec H.264 und den Audiocodec AAC verwenden. Nur eine Audiospur ist zulässig. Maximale Dateigröße: 16 MB.
• Dokumente: In den Kopfzeilen von Vorlagennachrichten wird nur das PDF-Format unterstützt. Maximale Dateigröße: 100 MB.
• Hält ein Video die Größenbegrenzung ein und schlägt trotzdem fehl, liegt das Problem sehr wahrscheinlich am Codec. Kodieren Sie das Video mit einem Tool wie HandBrake (H.264 + AAC) neu und laden Sie es erneut hoch.

9. Nachrichtentext zu lang

WhatsApp setzt für jeden Teil einer Vorlage strenge Zeichenlimits durch. Überschreitet ein Abschnitt sein Limit, wird die Nachricht nicht gesendet.

• Kopfzeilentext: maximal 60 Zeichen.
• Haupttext: maximal 1,024 Zeichen.
• Fußzeilentext: maximal 60 Zeichen.
• URL der Call-to-Action-Schaltfläche: maximal 2,000 Zeichen.
• Formatierungssymbole (*, _, ~) zählen zum Zeichenlimit.

10. Kampagne blockiert: unzureichendes Guthaben

• Gehen Sie zu SparkTG Dashboard → Billing und prüfen Sie Ihr verfügbares Guthaben.
• Laden Sie Ihr Konto auf, bevor Sie die Kampagne erneut starten.
• Prüfen Sie, ob alle Kontakte in Ihrer Kampagnenliste gültige Ländervorwahlen haben: Ungültige Nummern verbrauchen bei fehlgeschlagenen Zustellversuchen Guthaben.