Support
Problembehebung
Nachricht nicht zugestellt
Die folgenden Szenarien können dazu führen, dass eine Nachricht als gesendet aber nicht als zugestellt angezeigt wird. Für einige dieser Gründe wird aufgrund von Datenschutz- und Richtliniengründen die entsprechende Fehlerursache nicht offengelegt.
- Der*die Kund*in war innerhalb des 30-tägigen Zeitraums nicht online, für den Nachrichten an Kund*innen gespeichert werden, die offline sind.
- Der*die Kund*in hat die Unternehmenstelefonnummer oder eine andere Unternehmenstelefonnummer blockiert, die dem Unternehmen gehört.
- Der*die Kund*in befindet sich in einem Land, für das Einschränkungen oder Sanktionen gelten.
In einigen Szenarien gibt die API einen Fehlercode mit einer Fehlermeldung zurück, die den Fehler beschreibt. Beispielszenarien:
- Ungültiger Anfrageparameter
- Integrity-Fehler
- Der*die Kund*in hat unsere neuen Nutzungsbedingungen und die neue Datenschutzrichtlinie nicht akzeptiert. Sende deinen Endbenutzer*innen den Link https://wa.me/tos/20210210, über den sie die aktuellsten Nutzungsbedingungen akzeptieren können.
- Der*die Kund*in verwendet eine alte Version von WhatsApp. Kund*innen sollten die folgende oder eine höhere Version verwenden:
- Android: 2.21.15.15
- SMBA: 2.21.15.15
- iOS: 2.21.170.4
- SMBI: 2.21.170.4
- KaiOS: 2.2130.10
- Web: 2.2132.6
- Der*die Kund*in ist Teil einer Experimentiergruppe.
- Die Nachricht wurde nicht zugestellt, um ein hochwertiges Nutzungserlebnis zu gewährleisten. Siehe Nachrichtenbeschränkungen für Marketingvorlagen pro Benutzer*in.
Mögliche Lösungen
Bitte den*die WhatsApp-Benutzer*in außerhalb von WhatsApp, Folgendes zu tun:
- Bestätigen, dass er*sie tatsächlich eine Nachricht an deine WhatsApp-Unternehmenstelefonnummer(n) senden kann
- Bestätigen, dass keine deiner WhatsApp-Unternehmenstelefonnummern in seiner*ihrer Liste von blockierten Nummern enthalten sind (Einstellungen > Privatsphäre > Blockiert oder Blockierte Kontakte)
- Bestätigen, dass er*sie unsere aktuellen Nutzungsbedingungen akzeptiert hat (unter Einstellungen > Hilfe oder Einstellungen > Anwendungsinformationen kann er*sie die aktuellen Nutzungsbedingungen/Richtlinien akzeptieren, wenn er*sie dies noch nicht getan hat)
- Auf die neueste Version des WhatsApp-Clients aktualisieren
Länderbeschränkungen
Unternehmen in Kuba, im Iran, in Nordkorea, Syrien und drei Regionen der Ukraine, für die Sanktionen verhängt wurden (Krim, Donezk, Luhansk), sind nicht berechtigt, die WhatsApp Business Platform zu verwenden.
Benutzer*innen des WhatsApp Messengers (WhatsApp) und der WhatsApp Business-App in Kuba, im Iran, in Nordkorea, Syrien und drei Regionen der Ukraine, für die Sanktionen verhängt wurden (Krim, Donezk, Luhansk), sind nicht berechtigt, Nachrichten zu empfangen, die über die WhatsApp Business Platform gesendet wurden.
Seit dem 15. Mai 2024 gelten keine Einschränkungen mehr für die Türkei bezüglich Cloud API-Business-Messaging. Cloud API-Unternehmen können nun mit WhatsApp-Benutzer*innen mit türkischen Telefonnummern Unterhaltungen initiieren und Nachrichten erhalten.
Webhooks
Widersprüchliche Status der Nachrichtenzustellung
In seltenen Fällen kann dieselbe Nachricht Webhooks für die Nachrichtenstatusaktualisierung auslösen, die sowohl einen Erfolg als auch ein Fehlschlagen angeben. Eine Nachricht kann beispielsweise sowohl einen Webhook mit "status":"delivered" als auch einen anderen Webhook mit "status":"failed" auslösen. Dies kann passieren, wenn ein*e Kund*in auf mehreren Geräten bei WhatsApp angemeldet ist und die Nachricht erfolgreich an ein Gerät zugestellt wird, aber nicht an das andere. Jede Nachricht, die einen "delivered"-Nachrichtenstatus-Webhook auslöst, wurde auf mindestens einem der Geräte des*der Benutzer*in zugestellt.
Fehlercode 2 – API-Service
Während der Aktualisierung der API kann es zu einer Ausfallzeit von bis zu 5 Minuten kommen. Während dieser Zeit ist der Service nicht verfügbar. Wir sind bemüht, Unterbrechungen während dieser Updates für Unternehmen möglichst gering zu halten, du könntest jedoch davon betroffen sein.
Debugging
Warte 5 Minuten und versuche dann erneut, den API-Aufruf durchzuführen.
Authentifizierungs- und Autorisierungsfehler
Diese Fehler werden zurückgegeben, wenn es ein Problem mit dem Zugriffsschlüssel gibt, den du für den API-Aufruf verwendest.
Debugging
Du kannst den Zugriffsschlüssel, den du verwendest, direkt in den Zugriffsschlüssel-Debugger einfügen. Überprüfe dann, ob du die Berechtigungen whatsapp_business_management und whatsapp_business_messaging ausgewählt hast.
Wenn dein Schlüssel keinen Zugriff auf die Berechtigungen hat, musst du einen neuen generieren. Stelle beim Erstellen des Schlüssels sicher, dass du Folgendes auswählst:
- Die Meta-App, die du für die API-Aufrufe verwendest
- Die folgenden Berechtigungen:
whatsapp_business_managementundwhatsapp_business_messaging
FAQs
Allgemeine FAQs
WhatsApp develops and operates the WhatsApp Business API, which enables businesses to communicate with WhatsApp consumer users on the WhatsApp network. When using the Cloud API, Meta will host the WhatsApp Business API for you and provide an endpoint for the WhatsApp service for your incoming and outgoing WhatsApp communications.
Please view information about the sunset of the On-Premises API.
Access to Cloud API is free, and we expect it to generate additional cost savings for developers, as Meta hosts and maintains the Cloud API.
We want to make it clear what it means to message with a business on WhatsApp. Some businesses may choose to use Meta or another company to help them manage and store their messages. When a business chooses to manage their messages with another company, we will let consumers know by showing a different system message. Learn more.
FAQs zur technischen Implementierung
The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.
Solution Partners and direct clients do not need the WebApp and CoreApp containers that are used in the On-Premises API. Meta will manage all database data and media data on behalf of the Solution Partner or direct client.
As your on-premises performance depends heavily on your hardware, software, and connectivity to WhatsApp servers, if you wish to understand these differences, you can perform your own load tests on Cloud API as you might have done for your own on-premises installation. You can also refer to our performance comparison to understand more details around how the on-premise and Cloud APIs compare.
Migrating between the on-premises and Cloud APIs is seamless, and can be done bidirectionally. See migration details for more information.
FAQs zur Zuverlässigkeit
Auf unserer Seite „WhatsApp Business API-Status“ findest du weitere Informationen zu bestimmten Beobachtungskennzahlen der Cloud API.
Auf der API-Statusseite findest du weitere Informationen.
Die Verfügbarkeit wird einmal am Tag aktualisiert.
Es gibt einige Situationen, in denen bestimmte Benutzerfehler automatisch falsch als Downtime gewertet werden können. In diesen Fällen überschreiben wir nach eingehender Prüfung innerhalb einer woche die Downtime mit Uptime.
Es kann sich um Fehler handeln, die unsere allgemein Verfügbarkeit nicht beeinträchtigen. In diesen Fällen zeigt die Statusseite der WhatsApp Business API einen Status an, der widerspiegelt, dass es möglicherweise zu Unterbrechungen kommt, die die allgemeine Verfügbarkeit jedoch nicht beeinträchtigen. Übermittle ein Direct Support -Ticket, um dies zu untersuchen.
In den folgenden Fällen werden Verfügbarkeitsausfälle automatisch nicht erfasst:
- Netzwerkprobleme, die zum Fehlschlagen von Anfragen führen, bevor diese die Graph API-Schicht (erste Schicht) erreichen
- Netzwerkprobleme, die dazu führen, dass ausgehende Webhooks den Webhook-Endpunkt eines Unternehmens nicht erreichen
Alle Probleme, die vor der Aufnahme in unser System nach diesem Punkt auftreten, werden entweder als Fehler oder als verpasster Erfolg angezeigt. Probleme, die nach dem ersten Versuch, den Webhook zu senden, auftreten, werden so lange wiederholt, bis er erfolgreich an den Webhook-Endpunkt ausgeliefert wurde.
Die folgenden weitere Fälle werden nach manueller Entdeckung im Verfügbarkeits-Dashboard angezeigt (ausgenommen Systemfehler):
- Meta-Authentifizierungsproblemen wie Auth-Token (Sicherheitsbibliotheken); es wird ermittelt, ob sie berechtigte Anfragen sind, für die die Authentifizierung oder Autorisierung fehlschlägt.
- Validierung, die berechtigte Anfragen zurückweist.
In beiden Fällen erkennt und berücksichtigt WhatsApp diese Probleme im Nachhinein, und zwar fast in Echtzeit, aber nicht in Echtzeit.
Derzeit bieten wir keine kommerziell verfügbaren Produkt-Servicelevel-Vereinbarungen für Uptime und/oder Latenz an.
We will have disaster recovery and data replication across multiple regions. The expected downtime would be within our SLA and usually in the order of less than a minute to less than five minutes.