WhatsApp Business API: Häufige Fehler und Fehlerbehebung

Dieser Leitfaden bietet Lösungen für die häufigsten Integrations-, Vorlagen- und Nachrichtenfehler, die bei der Verwendung der WhatsApp Business API mit WhatsTeam auftreten.

Integrations- und Einrichtungsfehler

Diese Nummer ist bei einem bestehenden WhatsApp-Konto registriert

Dieser Fehler tritt auf, wenn Ihre Telefonnummer bereits mit einem anderen WhatsApp Business API-Anbieter oder der Standard-WhatsApp-/WhatsApp Business-Mobil-App verknüpft ist.

• Bei Nutzung eines anderen API-Anbieters: Folgen Sie unserer Migrationsanleitung, um Ihre Nummer zu WhatsTeam zu übertragen.
• Bei Nutzung der Mobil-App: Sie müssen die Nummer formell von der App trennen, bevor sie mit der Cloud API verwendet werden kann. Beachten Sie, dass dadurch Ihr lokaler Chatverlauf gelöscht wird, sofern Sie kein Backup haben.
• Immer noch blockiert? Kontaktieren Sie unser Support-Team unter support@whats.team mit Ihrer WhatsApp Business Account-ID und Telefonnummer für manuelle Unterstützung.

Code konnte nicht gesendet werden oder 500-Fehler in der Konsole

Wenn Sie keinen Verifizierungscode erhalten oder während der Anmeldung einen „500 Internal Server Error" sehen:

1. Konsole prüfen: Überprüfen Sie die Entwicklerkonsole Ihres Browsers. Häufig handelt es sich um Validierungsfehler von Meta bezüglich Ihrer Geschäftsprofileinstellungen (z. B. Beschreibung zu lang).
2. Ersteinrichtungs-Flow versuchen: Wenn Sie eine Migration versucht haben, probieren Sie stattdessen den „Ersteinrichtungs"-Pfad, da das Konto möglicherweise bereits teilweise erstellt wurde.
3. Warten und erneut versuchen: Metas Server können gelegentlich vorübergehende Verzögerungen aufweisen. Warten Sie 5-10 Minuten, bevor Sie einen neuen Code anfordern.

WhatsApp Business Account-Zugriff nicht geteilt

Dies tritt auf, wenn die Verbindung zwischen Ihrem Meta Business Account und WhatsTeam nicht vollständig autorisiert wurde oder die Berechtigungen widerrufen wurden.

• Lösung: Führen Sie den Embedded Signup-Prozess erneut durch und stellen Sie sicher, dass alle Kontrollkästchen für Berechtigungen ausgewählt sind.

Nicht unterstützte GET-Anfrage oder Ungültige ID

Fehler: „Objekt mit ID XXX existiert nicht..." Dies passiert normalerweise, wenn eine Business Manager-ID anstelle einer WhatsApp Business Account (WABA)-ID eingegeben wird. Überprüfen Sie, ob Sie die WABA-ID verwenden, die Sie in Ihren Meta-Geschäftseinstellungen unter „WhatsApp-Konten" finden.

Telefonnummer kann nicht migriert werden

Fehler: „Telefonnummer kann nicht migriert werden. Das WhatsApp-Konto, bei dem diese Nummer registriert ist, ist nicht korrekt eingerichtet."

1. Überprüfen Sie, ob die Nummer in Ihrer Meta Business Suite vollständig genehmigt ist.
2. Stellen Sie sicher, dass die Nummer auf keinem Mobilgerät mehr aktiv ist.
3. Machen Sie einen Screenshot der verifizierten Nummer in Ihrem Meta-Dashboard und senden Sie ihn an unser Support-Team, wenn das Problem weiterhin besteht.

Zertifikat kann nicht erstellt werden (2FA-Konflikt)

WhatsApp kann kein Sicherheitszertifikat generieren, wenn die Zwei-Faktor-Authentifizierung (2FA) für die Telefonnummer in der Mobil-App aktiviert ist. Deaktivieren Sie 2FA in den Einstellungen Ihrer WhatsApp-App, bevor Sie versuchen, sich mit WhatsTeam zu verbinden.

Bitte stellen Sie sicher, dass Sie den Zugriff vollständig autorisieren

Diese Nachricht erscheint typischerweise, wenn es eine Synchronisierungsverzögerung zwischen Metas Genehmigung und unserer Plattform gibt.

• Lösung: Aktualisieren Sie Ihren Browser und warten Sie 2-5 Minuten, bis die Berechtigungen über die Systeme verteilt sind.

WABA verwendet bereits eine Zahlungsmethode

Dies geschieht, wenn eine Nummer zuvor von einem Drittanbieter bereitgestellt wurde, der seine eigene Zahlungsmethode angehängt hat. Sie müssen den Migrationsprozess abschließen, um die Nummer unter Ihr eigenes Meta Business Account und Ihre eigene Zahlungsstruktur zu verschieben.

Probleme mit Nachrichtenvorlagen

Vorlagen erscheinen nicht im Dashboard

Wenn Ihre genehmigten Meta-Vorlagen nicht in WhatsTeam angezeigt werden:

• Nur Klartext: Stellen Sie sicher, dass die Vorlage keine nicht unterstützten Medientypen oder komplexe interaktive Elemente verwendet, die in der aktuellen Ansicht noch nicht unterstützt werden.
• Sprachübereinstimmung: Überprüfen Sie, ob die Vorlagensprache mit den Spracheinstellungen Ihres Kontos übereinstimmt.
• Synchronisierungsstatus: Die Meta-Genehmigung kann bis zu 24 Stunden dauern. Wenn sie bereits in Meta genehmigt ist, versuchen Sie, Ihre Verbindung im Dashboard zu aktualisieren.

Variablenformatierung (numerische Platzhalter)

Die WhatsApp Cloud API erfordert numerische Platzhalter (z. B. {{1}}, {{2}}) im Vorlagentext.

• Falsch: Hallo {{name}}, Ihre Bestellung {{order_id}} ist fertig.
• Richtig: Hallo {{1}}, Ihre Bestellung {{2}} ist fertig. Sie können diese numerischen Variablen dann in WhatsTeam beim Senden der Nachricht den Benutzerattributen zuordnen.

Vermeidung der „Marketing"-Neuklassifizierung

Meta kann „Utility"- oder „Service"-Vorlagen automatisch als „Marketing" neu klassifizieren, wenn sie werbliche Sprache enthalten.

• Tipp: Halten Sie Ihre Sprache neutral, vermeiden Sie Emojis in Transaktionsupdates und beschreiben Sie den Servicezweck sehr genau bei der Einreichung zur Genehmigung.

Probleme bei der Nachrichtenzustellung

Nachricht nicht zustellbar / Empfänger nicht erreichbar

Dies bedeutet normalerweise, dass das WhatsApp-Konto des Empfängers die Nachricht nicht empfangen kann.

• Ursachen: Die Nummer ist nicht auf WhatsApp, der Benutzer hat die neuesten Nutzungsbedingungen nicht akzeptiert, oder er verwendet eine extrem veraltete Version der App.
• Lösung: Bitten Sie den Benutzer (per SMS oder E-Mail), Ihnen zuerst eine Nachricht zu senden, um das Gespräch zu „aktivieren" und sicherzustellen, dass seine App aktualisiert ist.

Häufigkeitslimits für Nachrichten

Wenn eine Nachricht aufgrund von „Häufigkeitslimits" fehlschlägt, hat Meta die Anzahl der Marketing-Vorlagen begrenzt, die dieser bestimmte Benutzer in kurzer Zeit empfangen kann, um Spam zu verhindern.

• Maßnahme: Warten Sie 24 Stunden, bevor Sie versuchen, die Nachricht erneut zu senden. Weitere Details finden Sie in Metas Dokumentation.

Das 24-Stunden-Gesprächsfenster

WhatsApp setzt ein 24-Stunden-Servicefenster durch. Sie können nur dann Freitext-Nachrichten senden, wenn der Benutzer innerhalb der letzten 24 Stunden geantwortet hat.

• Wenn das Fenster geschlossen ist: Sie müssen eine vorab genehmigte Vorlagennachricht senden, um den Benutzer erneut anzusprechen. Sobald er antwortet, öffnet sich das 24-Stunden-Fenster für Freitext-Chat wieder.

Medientyp nicht unterstützt

Wenn ein Bild oder Dokument nicht gesendet werden kann:

• Prüfen Sie, ob die Dateigröße innerhalb der Limits von Meta liegt.
• Stellen Sie sicher, dass das Dateiformat (z. B. .jpg, .pdf, .mp4) von der WhatsApp-Plattform unterstützt wird.

Empfänger ist Teil eines WhatsApp-Experiments

Gelegentlich führt Meta Experimente durch, bei denen bestimmte Marketing-Nachrichten nicht an bestimmte Benutzer zugestellt werden können. Wenn Sie einen Fehler sehen, der ein „Experiment" erwähnt, versuchen Sie, einen anderen Nachrichtentyp zu senden oder die Nachricht später erneut zu senden.

Konto eingeschränkt oder gesperrt

Wenn Sie einen Fehler erhalten, der besagt, dass das „Konto gesperrt" ist, wurde Ihr WABA möglicherweise wegen Richtlinienverstößen gesperrt.

• Lösung: Überprüfen Sie Ihren Meta Business Suite Support-Posteingang auf Benachrichtigungen über Richtliniendurchsetzung und folgen Sie deren Anweisungen, um Einspruch zu erheben oder die Einschränkung zu beheben.

Immer noch Probleme?

Wenn Ihr Problem hier nicht behandelt wird, ist unser Support-Team bereit zu helfen. Kontaktieren Sie uns unter support@whats.team.