Änderungsprotokoll

In diesem Dokument sind die Änderungen an der WhatsApp Business Platform protokolliert.

13. November 2024

Cloud API

12. November 2024

Cloud API

2. Oktober 2024

Änderungen an der Cloud API, Version 21.0

  • Ab Version 21.0 müssen die Parameter package_name und signature_hash mit dem Array supported_apps konfiguriert werden, wenn One-Tap-Autofill- und Zero-Tap-Authentifizierungsvorlagen erstellt werden.
  • Um die lokale Speicherung für eine geschäftliche Telefonnummer zu aktivieren, muss sich die Nummer ab Version 21.0 in einem nicht registrierten Zustand befinden und du musst den Endpunkt POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/settings verwenden, um die lokale Speicherung zu aktivieren, bevor du die Nummer registrierst (anstatt sie während der Registrierung zu aktivieren). Für diese Änderungen wurden folgende Schritte durchgeführt:

25. September 2024

Cloud API

24. September 2024

Cloud API

  • Vorlagen für Checkout-Buttons wurden hinzugefügt (nur verfügbar für Unternehmen in Indien, die geschäftliche Telefonnummern mit indischen Ländervorwahlen verwenden).

11. September 2024

Cloud API

10. September 2024

Cloud API

  • Das Caching-Verhalten von Medien-Assets kann nicht mehr (über den Cache-Control-Header) von dem*der Entwickler*in definiert werden, sondern wurde auf den festen Zeitraum von 10 Minuten festgelegt. Du kannst uns allerdings immer noch zwingen, Assets von deinem Server statt aus unserem Cache abzurufen. Siehe Medien-Caching.

6. September 2024

Cloud API

1. Juni 2024

Cloud API

Business Management API

10. April 2024

Cloud API

18. März 2024

Cloud API

13. Februar 2024

Cloud API

  • Das Limit für die Registrierung/Deregistrierung von geschäftlichen Telefonnummern wurde auf 10 Anfragen pro Unternehmenstelefonnummer in einem gleitenden Zeitfenster von 72 Stunden geändert (zuvor ein gleitendes Zeitfenster von einer Woche).

6. Februar 2024

Cloud API, On-Premises API

26. Januar 2024

Cloud API

  • Die Wiederholungszeit für die Zustellungsversuche von Cloud API-Vorlagennachrichten wurde von 24 Stunden auf 30 Tage verlängert. Du kannst diesen Wert für Authentifizierungsvorlagen weiterhin überschreiben.
  • Die Zeichenbeschränkung für biz_opaque_callback_data wurde von 256 auf 512 erhöht.

18. Januar 2024

Cloud API

18. Dezember 2023

Cloud API

12. Dezember 2023

Business Management API

20. November 2023

Business Management API

  • Konsolenprotokolle wurden hinzugefügt, um das Debuggen bei One-Tap- und Zero-Tap-Authentifizierungsvorlagen zu erleichtern.

14. September 2023

Cloud API

3. November 2023

Business Management API

23. Oktober 2023

Business Management API, Cloud API, On-Premises API

10. Oktober 2023

Flows

Cloud API

4. Oktober 2023

Business Management API, Cloud API, On-Premises API

  • Authentifizierungsvorlagen, die die Warnung vor ablaufendem Code verwenden, verwenden jetzt den Wert code_expiration_minutes (anstelle von 10 Minuten als Standard), um zu bestimmen, ob die ausgelieferte Vorlagennachricht einen Button zum automatischen Ausfüllen oder einen Button zum Kopieren von Code beinhalten soll.
  • In einer Vorlagennachricht angezeigte Buttons zum automatischen Ausfüllen werden nach der Zeit deaktiviert, die der code_expiration_minutes-Wert der Vorlage angibt, wenn vorhanden (oder nach 10 Minuten, wenn nicht vorhanden).

2. Oktober 2023

Cloud API

27. September 2023

Cloud API

  • ctwa_clid-Eigenschaft zu referral-Objekt in Nachrichten-Webhooks hinzugefügt. Gibt die Klick-ID an, die erzeugt wird, wenn Nutzer*innen auf eine Anzeige tippen, die zum Senden der Nachricht per Klick zu WhatsApp weiterleitet.

18. September 2023

Cloud API, On-Premises API

  • Bis zum 1. April 2024 (verlängert vom 2. Oktober 2023) können alte Authentifizierungsvorlagen (Authentifizierungsvorlagen ohne Einmalpasswort-Buttons) gesendet und bearbeitet werden sowie Einspruch gegen sie eingelegt werden.

12. September 2023

Business Management API

Cloud API

Cloud API, On-Premises API

  • Durch das Migrieren von Unternehmenstelefonnummern, die mit Multiconnect zwei oder mehr Shards von der On-Premises API zur Cloud API ausführen, werden die Telefonnummern automatisch auf einen höheren Cloud API-Durchsatz hochgestuft.

28. August 2023

Cloud API, On-Premises API

  • Vorlagen-Pacing wurde hinzugefügt (Betaversion, für ausgewählte Länder).

15. August 2023

Business Management API

8. August 2023

Tools

Business Management API

Embedded Signup

2. August 2023

Business Management API

11. Juli 2023

Cloud API

  • Für die Planung und Durchführung eines Upgrades auf den Durchsatz einer Unternehmenstelefonnummer ist kein Live-Anruf mehr erforderlich.
  • Du kannst jetzt einen Upgrade-Zeitpunkt angeben, wenn du ein Direct Support-Ticket sendest, um ein Upgrade auf den Durchsatz einer Unternehmenstelefonnummer durchzuführen.
  • Die Downtime für Unternehmenstelefonnummern, bei denen ein Durchsatz-Upgrade durchgeführt wird, wurde auf maximal fünf Minuten reduziert.

7. Juli 2023

Business Management

  • In Authentifizierungsvorlagen ist der Text für die Buttons „Code kopieren“ und „Durch Tippen automatisch ausfüllen“ bei der Erstellung jetzt optional.

13. Juni 2023

Tools

Business Management

  • Der 2494100-Fehlercode, der angibt, dass sich eine Unternehmenstelefonnummer vorübergehend im Wartungsmodus befindet, wurde zur Business Management API hinzugefügt.

Cloud API

26. Mai 2023

Tools

  • Fehlersignale, die beim Debuggen von Authentifizierungsvorlagen mit Buttons für das automatische Ausfüllen von Einmalpasswörtern unterstützen können, wurden hinzugefügt.

23. Mai 2023

Cloud API

  • Wenn du ab v17 versuchst, eine pausierte Vorlage in einer Vorlagennachricht zu senden, wird jetzt der Fehlercode 132015 anstelle von 132001 zurückgegeben.
  • Wenn du in v17 oder höher versuchst, eine deaktivierte Vorlage in einer Vorlagennachricht zu senden, wird jetzt der Fehlercode 132016 anstelle von 132001 zurückgegeben.

On-Premises API

  • Wenn du versuchst, eine pausierte Vorlage in einer Vorlagennachricht zu senden, wird jetzt der Fehlercode 2061 zurückgegeben.
  • Wenn du versuchst, eine deaktivierte Vorlage in einer Vorlagennachricht zu senden, wird jetzt der Fehlercode 2062 zurückgegeben.

9. Mai 2023

Business Management API

Cloud API

On-Premises API

1. Mai 2023

Business Management API

  • Dem Webhooks-Feld account_alerts wurden neue Webhooks hinzugefügt, die dich über Ablehnungen zu Erhöhungen von Messaging-Einschränkungen benachrichtigen.
  • Alle Vorlagen müssen jetzt als AUTHENTICATION, MARKETING oder UTILITY kategorisiert werden.

26. April 2023

Business Management API

  • Das Feld hsm_id wurde zum LÖSCHEN des Endpunkts unter WhatsApp Business-Konto > Nachrichtenvorlagen hinzugefügt. Wenn das Feld aufgenommen wird, wird eine einzelne Vorlage gelöscht, die mit der angegebenen ID übereinstimmt (anstatt alle Vorlagen zu löschen, die mit dem angegebenen Namen übereinstimmen).

18. April 2023

Cloud API

  • Das Feld last_onboarded_time wurde dem Node WhatsApp Business-Telefonnummer hinzugefügt. Es gibt an, ob ein*e Benutzer*in eine Business-Telefonnummer in seinem*ihrem WhatsApp Business-Konto mithilfe des Embedded Signup-Ablaufs erstellt hat.

11. April 2023

Cloud API

Embedded Signup

4. April 2023

Business Management AI, Cloud API, On-Premises API

17. März 2023

Business Management API

14. März 2023

Cloud API

  • Du kannst jetzt Standortinformationen mit Benutzer*innen teilen, indem du einen Standort-Header zu deiner Vorlage hinzufügst.

On-Premises API

1. März 2023

Cloud API, On-Premises API

  • Bei der Migration einer indischen Unternehmenstelefonnummer von der On-Premises API zur Cloud API werden die zugehörigen Compliance-Daten für den Online-Handel nicht mehr gelöscht. Daher musst du diese Daten nach der Migration nicht mehr manuell erneut eingeben.

15. Februar 2023

Business Management API

  • Es wurde ein neuer Endpunkt für Vorlagenvergleich hinzugefügt, mit dem du das Verhältnis der Anzahl von gesendeten und blockierten Vorlagen ermitteln kannst.

3. Februar 2023

Cloud API, On-Premises API

2. Februar 2023

Business Management API, Cloud API

Cloud API

  • Vorlagen, die mit v16.0 erstellt oder bearbeitet wurden, müssen jetzt in eine der folgenden Kategorien eingeteilt werden. Alle anderen Kategorien werden nicht mehr unterstützt. Gilt für Cloud API Version 16.0 und höher. Gilt ab dem 1. Mai 2023 für alle Versionen. Diese Änderung wurde eingeführt, um unseren Wechsel zum neuen unterhaltungsbasierten Preismodell am 1. Juni 2023 zu unterstützen.
    • AUTHENTICATION
    • MARKETING
    • UTILITY
  • Fehler-Subcodes, die selten verwendet werden und nicht zu empfehlen sind, werden in Fehlerantworten ab v16.0 nicht mehr verwendet. Verwende stattdessen code und details.
  • Fehlercode 100 ("code":100) hatte mehrere eindeutige Titel, die die Art eines bestimmten Code-100-Fehlers angaben. Alle Code-100-Fehler verwenden jetzt Invalid parameter als Titel. Alte Titel, die die Art eines bestimmten Code-100-Fehlers angaben, wurden in die Eigenschaft details verschoben. Diese Änderung wird nun außerdem in den Webhooks-Payloads wiedergegeben, die eine Code-100-Fehlerantwort beschreiben.

Cloud API-Webhooks

  • Das errors-Objekt in Webhooks, das durch Anfragefehler ab Version 16.0 ausgelöst wurde, enthält jetzt die Eigenschaften message und error_data.details. Außerdem wurden bei mehreren Fehlercodes die title-Werte geändert. errors-Objekte weisen jetzt die folgende Struktur und die folgenden Daten auf:
[
  {
    "code": <CODE>,
    "title" : "<TITLE>",
    "message": "<MESSAGE>",
    "error_data": {
      "details": "<DETAILS>"
    }
  },
  ...
]
  • Der Eigenschaftswert title wurde mit den folgenden Fehlercodes aktualisiert. Die alten Werte werden jetzt in error_data.details angezeigt.
    • 130470: neuer Titel lautet Re-engagement message
    • 130429: neuer Titel lautet Rate limit hit
    • 131045: neuer Titel lautet Incorrect certificate
    • 131031: neuer Titel lautet Business Account locked
    • 131053: neuer Titel lautet Media upload error
    • 131027: neuer Titel lautet Something went wrong
    • 131042: neuer Titel lautet Business eligibility payment issue
    • 131026: neuer Titel lautet Message Undeliverable
    • 131000: neuer Titel lautet Something went wrong
  • Der Eigenschaftswert message ist identisch mit dem Eigenschaftswert title, der den Titel des Fehlercodes angibt. Diese Eigenschaft bezieht sich auf die Eigenschaft message in Payloads von API-Fehlerantworten.
  • Die Eigenschaft error_data.details enthält nun Fehlercode-Titel aus den oben aufgeführten Fehlercodes und beschreibt die zugrundeliegende Ursache des Fehlers. Dieser Wert bezieht sich auf die Eigenschaft details in Payloads von API-Fehlerantworten.

Diese Änderungen finden sich in den folgenden errors-Eigenschaften in fehlerbezogenen Webhooks wieder:

  • entry.changes.value.errors
  • entry.changes.value.messages.errors
  • entry.changes.value.statuses.errors

30. Januar 2023

Cloud API

Nicht verifizierte Unternehmen können jetzt in einem rollierenden Zeitraum von 24 Stunden bis zu 250 Unterhaltungen beginnen.

13. Dezember 2022

Prüfung der Medienberechtigungen

Gilt für alle Versionen der Cloud API.

Ein neues, optionales phone_number_id-Feld wurde zum Media-Endpunkt hinzugefügt. Wenn du diesen Parameter und eine Unternehmenstelefonnummer-ID einbeziehst, wird der Vorgang nur verarbeitet, wenn die Telefonnummer-ID mit der ID der Telefonnummer übereinstimmt, über die Medien hochgeladen wurden.

8. Dezember 2022

HTTP-Medien-Caching

Das HTTP-Medien-Caching der Cloud API befindet sich nicht mehr in der Betaphase und ist nur für alle verfügbar.

Webhooks

Die Cloud API nimmt jetzt erneute Zustellversuche für nicht zugestellte Webhooks-Benachrichtigungen für bis zu 7 Tage vor, statt wie bisher für bis zu 30 Tage. Weitere Informationen findest du unter Fehlgeschlagene Zustellung von Webhooks.

23. November 2022

Neues Webhooks-Feld

Gilt für alle Versionen.

  • Ein neues template_performance_metrics-Feld wurde hinzugefügt. Damit wirst du wöchentlich über alle Metriken zur Vorlagen-Performance benachrichtigt, darunter Anzahl gesendeter Nachrichten, Anzahl geöffneter Nachrichten und Hauptgründe für Blockierungen.

22. November 2022

Neue Webhooks-Felder und -Werte

Gilt für alle Versionen.

Neues account_alerts-Feld:

  • Ein neues account_alerts-Feld wurde hinzugefügt. Damit wirst du über Warnungen zu Unternehmen, WhatsApp Business-Konten und geschäftlichen Telefonnummern benachrichtigt.

Neue account_update-Feldwerte:

  • Ein neuer Wert für account_update.events wurde hinzugefügt: ACCOUNT_DELETED. Er gibt an, dass eine Telefonnummer von einem WhatsApp Business-Konto deregistriert oder gelöscht wurde.
  • Ein neuer Wert für message_template_status_update.events wurde hinzugefügt: PENDING_DELETION. Er gibt an, dass eine Nachrichtenvorlage zum Löschen markiert wurde.

Beispiele für Webhook-Benachrichtigungen, die beim Auslösen dieser neuen Events gesendet werden:

Neue Node-Felder für WhatsApp Business-Konten

Die folgenden Felder für den Node WhatsApp Business-Konto wurden hinzugefügt:

  • country (gilt für v15.0+)
  • ownership_type (gilt für v15.0+)
  • business_verification_status (gilt für alle Versionen)

Neue Filter für den Business-Endpunkt

Gilt ab Version 15.0.

Die folgenden Filteroptionen wurden dem Business Client WhatsApp Business Accounts-Endpunkt hinzugefügt:

  • Filtern nach dem WhatsApp Business-Konto-Feld creation_time mit dem Operator GREATER_THAN, LESS_THAN oder IN_RANGE.
  • Filtern nach ownership_type des WhatsApp Business-Kontos mit dem Operator EQUAL oder IN.

Die folgenden Filteroptionen wurden dem Business Owned WhatsApp Business Accounts-Endpunkt hinzugefügt:

  • Filtern nach creation_time des WhatsApp Business-Kontos mit dem Operator GREATER_THAN, LESS_THAN oder IN_RANGE.
  • Filtern nach ownership_type des WhatsApp Business-Kontos mit dem Operator EQUAL oder IN.
  • Filtern nach country des WhatsApp Business-Kontos mit dem Operator EQUAL oder IN.

Neue Node-Felder für Telefonnummern

Gilt ab Version 15.0.

Die folgenden Felder wurden dem Node WhatsApp Business-Telefonnummer hinzugefügt:

  • is_official_business_account
  • messaging_limit_tier

Außerdem kannst du den Endpunkt für Telefonnummern von WhatsApp Business-Konten nach is_official_business_account filtern.

3. November 2022

Nachrichten pro Sekunde

Die Cloud API unterstützt jetzt auf Anfrage bis zu 500 (vorher 350) Nachrichten pro Sekunde (mps) bei kombinierten SMS und Mediennachrichten. Weitere Informationen findest du unter Durchsatz.

Wenn du bereits einen Durchsatz von 350 mps hast, wird dieser automatisch auf 500 mps hochgesetzt. Wenn du 350 mps bereits angefordert hast, der Prozess jedoch noch nicht abgeschlossen ist, erhältst du beim Abschluss 500 mps.

Medien-HTTP-Caching

Wir testen jetzt Medien-HTTP-Caching für die Cloud API im Betatest. Lösungspartner finden im Abschnitt Medien-HTTP-Caching Informationen dazu, wie sie Header in Serverantworten festlegen, die uns anweisen, Medienassets für die Wiederverwendung mit zukünftigen Nachrichten zu cachen.

Dokumenttitel

Die Cloud API unterstützt jetzt Titel auf Dokumenten, die an die Kundschaft gesendet oder davon empfangen wurden. Mehr dazu erfährst du unter Medienobjekt in der Medienreferenz.

25. Oktober 2022

Begrenzung für Nachrichtenvorlage erhöht

WhatsApp Business-Konten können jetzt über bis zu 6.000 Nachrichtenvorlagen verfügen, wenn ihr übergeordnetes Unternehmen verifiziert ist und mindestens eines der WhatsApp Business-Konten des übergeordneten Unternehmens über eine Unternehmenstelefonnummer mit einem genehmigten Display-Namen verfügt.

Im Rahmen dieser Änderung werden übersetzte Versionen einer Nachrichtenvorlage jetzt auf die Vorlagenbegrenzungen eines WhatsApp Business-Kontos angerechnet.

20. Oktober 2022

Abrechnung

Unternehmen in Indien können jetzt mit Kreditkarte für Nachrichten bezahlen, die über die Plattform versendet wurden. Weitere Informationen findest du unter Eine Kreditkarte zu deinem Konto der WhatsApp Business Platform hinzufügen

12. Oktober 2022

Migration von Unternehmenstelefonnummern

Du kannst jetzt eine Unternehmenstelefonnummer in und von Cloud API WhatsApp Business-Konten migrieren. Weitere Informationen findest du unter Eine Telefonnummer in einen anderen WABA migrieren.

6. Oktober 2022

Rückrufüberschreibung

Nur Cloud API.

Du kannst jetzt verschiedene Rückruf-URLs für jedes deiner WhatsApp Business-Konten verwenden, ohne dass du eine eigene App für jedes WhatsApp Business-Konto erstellen musst. Weitere Informationen findest du unter Überschreiben der Rückruf-URL.

Aufrufe in Version 15

Alle Cloud API-Endpunkte unterstützen jetzt Aufrufe in Version 15.

Nachrichtenvorlagen

Nur Cloud API.

Textparameter (components.parameters.text) für Nachrichtenvorlagen, die nur eine Textkomponente verwenden (components.type:body) können jetzt bis zu 32.768 Zeichen enthalten. Weitere Informationen findest du unter Parameterobjekt.

Nachrichten pro Sekunde

Nur Cloud API.

Die Cloud API unterstützt jetzt auf Anfrage bis zu 350 (vorher 250) Nachrichten pro Sekunde (mps) bei kombinierten SMS und Mediennachrichten. Weitere Informationen findest du unter Durchsatz.

Wenn du bereits einen Durchsatz von 250 mps hast, wird dieser automatisch auf 350 mps hochgesetzt. Wenn du 250 mps bereits angefordert hast, der Prozess jedoch noch nicht abgeschlossen ist, erhältst du beim Abschluss 350 mps.

Cloud API – 30. September 2022

Reaktionen

Reaktionen werden jetzt unterstützt. Wie du Reaktionen sendest und empfängst, erfährst du unter Nachrichten senden – Reaktionsnachrichten. Beispiele für Webhook-Payload-Benachrichtigungen findest du unter Payload-Beispiele – Reaktionsnachrichten.

Unternehmensprofil

Das Feld about wird jetzt für Unternehmensprofile unterstützt. Weitere Informationen findest du unter Unternehmensprofile.

Cloud API – 7. September 2022

Nachrichten pro Sekunde

Die neueste Dokumentation zur Beantragung der Migration von 80 Nachrichten pro Sekunde auf 250 Nachrichten pro Sekunde für das kombinierte Senden und Empfangen von Text- und Mediennachrichten ist jetzt verfügbar. Siehe Durchsatz.

Cloud API – 25. August 2022

Animierte Sticker

Du kannst in ausgehenden, vom Unternehmen begonnenen Nachrichten jetzt animierte Sticker verwenden und Nachrichten-Webhooks erhalten, welche die Nachricht genauso beschreiben, als wenn du einen nicht animierten Sticker senden würdest. Anforderungen für animierte Sticker-Inhalte findest du in der Eigenschaft sticker des Objekts Nachricht.

Produktnachrichten

Du kannst jetzt Produkte und Dienstleistungen in Nachrichten an Kund*innen einfügen und Kund*innen können sie in den Warenkorb legen, ohne den Chat-Thread verlassen zu müssen. Im Leitfaden Verkaufen von Produkten und Dienstleistungen findest du weitere Informationen zum Senden von Nachrichten für einzelne oder mehrere Produkte an Kund*innen.

Cloud API – 21. Juli 2022

Antworten

Unternehmen können jetzt auf jede Nachricht in einem Unterhaltungs-Thread antworten. Antworten enthalten eine kontextbezogene Bubble, die auf die beantwortete Nachricht verweist. Im Leitfaden Senden von Nachrichten findest du weitere Informationen zum Antworten auf eine Nachricht.

Nachrichten pro Sekunde

Cloud API unterstützt jetzt auf Anfrage bis zu 250 Nachrichten pro Sekunde beim kombinierten Senden und Empfangen (einschließlich SMS und Mediennachrichten). Als Unternehmenspartner kannst du ein Direct Support-Ticket öffnen, um einen Durchsatz von 250 Nachrichten pro Sekunde anzufragen, indem du Folgendes wählst: Anliegen: „Cloud API Issues“, Art der Anfrage: „Request to migrate to 250 MPS throughput“. Fülle außerdem die erforderlichen Felder aus.

Hinweis für Entwickler*innen: Ankündigung von nicht abwärtskompatiblen Änderungen für zukünftige Versionen v2.43 und v2.45

v2.43 11. Oktober 2022

  • In v2.43 wird das Verhalten des contacts-Endpunkts geändert
    • Die Antworten für status ändern sich. Unabhängig davon, ob ein*e Benutzer*in WhatsApp hat, werden in der Antwort immer valid als status sowie eine wa_id zurückgegeben. Es gibt keine Garantie dafür, dass die zurückgegebene wa_id gültig ist. Diese Änderungen betreffen sowohl Direct Responses als auch Webhook-Antworten für nicht blockierende Aufrufe.
    • Vergewissere dich, dass dein Code sich nicht auf den im contacts-Node zurückgegebenen status und die wa_id verlässt. Das Senden einer Nachricht kann in v2.39.1 oder höher jetzt auch ohne Aufruf des contacts-Nodes erfolgen.

  • Vergewissere dich, dass dein Code einen potenziellen Fehler vom Typ „1013Nutzer ist nicht gültig“ beim Senden einer Vorlagennachricht verarbeiten kann. Dieser Fehler wird zurückgegeben, wenn du versuchst, die Vorlagennachricht an eine Telefonnummer ohne WhatsApp-Konto zu senden.

  • Für Nicht-Vorlagennachrichten wird beim Senden einer Nachricht an eine Telefonnummer ohne WhatsApp-Konto ein 470-Fehler zurückgegeben.

v2.45 10. Januar 2023

  • Ab v2.45 ist der optionale cert-Parameter im shards-Node für alle Anfragen obligatorisch. Aktualisiere deine Integration, damit bei jedem Aufruf des shards-Nodes ein gültiger cert-Parameter eingeschlossen wird.

  • Ab v2.41.2 können Unternehmen den application-Node verwenden, um die Gesendet-Status von Nachrichten, an denen sie nicht interessiert sind, über das message-Objekt im webhooks-Objekt herauszufiltern. Ab v2.45 ist sent_status veraltet. Aktualisiere daher deine Integration so, dass sie das webhooks-Objekt im application-Node für alle Webhook-Steuerungen verwendet.

  • Ab v2.39.1 steht recipient_id sowohl im statuses-Objekt als auch im message-Objekt zur Verfügung. In v2.45 wird recipient_id aus dem statuses-Objekt entfernt. Aktualisiere daher deine Integration so, dass sie recipient_id im message-Objekt verwendet.

On-Premises API – 19. September 2022 (v2.41.3)

Version 2.41.3

In der Version v2.41.3 unseres Business API-Clients wurde ein neuer Tabellenindex in message_receipt_log hinzugefügt, der für Partner mit hohem Durchsatz nützlich sein könnte. Beispielsweise können Partner dank dieser Verbesserung mehr als 200 Nachrichten pro Sekunde senden.

On-Premises API – 27. Juni 2022 (v2.41.2)

Befolge die unten aufgeführten Best Practices, um ein reibungsloses Upgrade auf v2.41.2 sicherzustellen:

In v2.41.2 wurden Änderungen am DB-Schema vorgenommen, um die Performance des Systems zu verbessern. Aus diesem Grund dauern Upgrades von v2.37.2 und v2.39.x für Setups mit großen Datenbanken, die Millionen von Nachrichten- und Kontakteinträgen enthalten, länger als üblich.

Generell solltest du Upgrades außerhalb der Hauptgeschäftszeiten durchführen und Setups mit geringerem Durchsatz zuerst aktualisieren.

Befolge für große Datenbanken diese Schritte:

  • Führe vor dem Upgrade eine Speicherbereinigung über den Endpunkt /services/message/gc durch und vergewissere dich, dass der Vorgang erfolgreich abgeschlossen wird.

  • Aktualisiere die DB-Schemas mithilfe des dbupgrade-Tools, bevor du das Versions-Upgrade durchführst. Nachdem dies erledigt ist, erfordern Upgrades von API-Versionen nur noch eine minimale Ausfallzeit. Wir empfehlen dringend, den API-Client herunterzufahren, bevor du das dbupgrade-Tool ausführst. Vergewissere dich, dass das dbupgrade-Tool erfolgreich abgeschlossen wird (Exit-Code 0) und führe während des Upgrades nur wenige oder am besten gar keine API-Anfragen durch.

Wir empfehlen, die Zeitüberschreitung für Abfragen auf deinen Datenbankservern auf eine Stunde zu erhöhen, bis das Upgrade erfolgreich abgeschlossen ist.

Diese Client-Version enthält die folgenden Features und Updates:

  • Verbesserungen an der Latenz der gesammelten /contact-Endpunktanfragen und Behebung von Deadlock-Problemen
  • Verbesserungen an der Performance und Zuverlässigkeit des Speicherbereinigungsvorgangs
  • Unternehmen haben nun die Möglichkeit, die Webhook-Benachrichtigungen delivered und read zu aktivieren/deaktivieren. Somit haben sie eine bessere Kontrolle über Webhook-Benachrichtigungen für Nachrichten. Dies wird über den Endpunkt settings/applications ermöglicht.
  • Das namespace-Feld ist optional für das Vorlagenobjekt.
  • Eine solidere Handhabung von Mediendownload-Fehlern, sodass für Unternehmen weniger Probleme beim Herunterladen von Medien auftreten, die von Kund*innen gesendet wurden
  • Zusätzliche Zuverlässigkeit und Fehlerbehebungen für die Workflows zum Senden von Nachrichten und der Registrierung

WhatsApp Business Cloud API – 19. Mai 2022

Ab heute ist die WhatsApp Business Cloud API für alle Entwickler*innen offen, die Produkte oder Dienstleistungen für sich oder ihre Organisationen erstellen. Lies zum Einstieg unseren Leitfaden. Wenn du deinen Kund*innen API-Zugriff bieten möchtest, trete unserer Warteliste bei.

WhatsApp Business Management API – 19. Mai 2022

Kategorien von Nachrichtenvorlagen

Die folgenden Werte für den Parameter category für den /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template-Endpunkt sind ab v14.0 und später veraltet:

  • ACCOUNT_UPDATE
  • ALERT_UPDATE
  • APPOINTMENT_UPDATE
  • AUTO_REPLY
  • ISSUE_RESOLUTION
  • PAYMENT_UPDATE
  • PERSONAL_FINANCE_UPDATE
  • RESERVATION_UPDATE
  • SHIPPING_UPDATE
  • TICKET_UPDATE
  • TRANSPORTATION_UPDATE

Die folgenden Werte wurden hinzugefügt:

  • TRANSACTIONAL
  • MARKETING

WhatsApp On-Premises API – 10. Mai 2022 (v2.39.4)

Diese Client-Version enthält alle Features und Problembehebungen aus Version v2.39.1. Folgendes bietet diese Version außerdem:

  • Es wurde ein Fehler behoben, der das Senden von Videonachrichten unter bestimmten Umständen verhindert hat. Diese Fehlerbehebung ist bereits in Version v2.39.2 enthalten.
  • Es wurde ein Fehler behoben, der Unternehmen daran gehindert hat, Nachrichten an Kund*innen zu senden, wenn der*die Kund*in die Interaktion auf WhatsApp initiiert hat und diese erste Nachricht mehr als sieben Tage in der Vergangenheit liegt. Diese Fehlerbehebung ist bereits in Version v2.39.3 enthalten.
  • Es wurde ein Fehler behoben, der Unternehmen daran gehindert hat, selbstlöschende Nachrichten von Kund*innen zu empfangen. Nach der Installation von v2.39.4 erhalten Unternehmen eine Webhooks-Benachrichtigung mit dem Typ "ephemeral", wenn sie eine selbstlöschende Nachricht empfangen haben. Unternehmen können nicht den Inhalt der Nachricht sehen.

Bei der Veröffentlichung von v2.39.3 wurde das Problem mit selbstlöschenden Nachrichten automatisch von WhatsApp gehandhabt, indem diese Nachrichten im Chat-Thread mit dem Client deaktiviert wurden. In v2.39.4 ist dies nicht mehr der Fall. In dieser Version müssen Unternehmen, die selbstlöschende Nachrichten erhalten, Kund*innen bitten, diese Funktion zu deaktivieren und die letzte Nachricht erneut zu senden.

Cloud API – 3. Mai 2022

Ab heute umfasst die Cloud API die folgenden Upgrades:

  • Behebung eines Problems, bei dem Nachrichten bei Nutzer*innen verschwunden sind.
  • Bessere Feststellung der Qualität von Miniaturbildern bei Mediennachrichten.

Cloud API – 5. April 2022

Ab heute ist die Cloud API für alle bestehenden Lösungspartner und Direktkunden allgemein verfügbar. Zusätzlich werden die folgenden Features für Cloud API-Entwickler*innen veröffentlicht:

  • Nachrichten mit Stickern: Sende Mediennachrichten, die statische Sticker von Drittanbietern enthalten. Weitere Details findest du in der folgenden Dokumentation: Referenz, Nachrichten und Referenz, Medien. Wir unterstützen sowohl eingehende als auch ausgehende Sticker. Bei ausgehenden Stickern unterstützen wir nur statische Sticker von Drittanbietern. Bei ausgehenden Nachrichten unterstützen wir alle Arten von Stickern.
  • API zur Aufhebung der Registrierung von Telefonnummern: Führe POST-Aufrufe an PHONE_NUMBER_ID/deregister durch, um eine Telefonnummer aus der WhatsApp Business API zu entfernen. Unter Registrierung findest du weitere Informationen.
  • Neue Option für die Verifizierung von Telefonnummern: Verifiziere deine geschäftliche Telefonnummer über Graph API-Aufrufe. Weitere Informationen findest du unter Telefonnummern.
  • Neue Referral-Webhooks: Erhalte Webhooks-Benachrichtigungen, wenn ein*e Nutzer*in auf eine Anzeige klickt, die zu WhatsApp weiterleitet, und eine Nachricht an das Unternehmen sendet. Weitere Informationen findest du unter Webhooks. Beachte, dass das referral-Objekt der Webhooks der Cloud API nicht mit dem referral-Objekt der On-Premises API identisch ist.

Zusätzlich kündigen wir an, dass von eigenen Entwickler*innen, die die Cloud verwenden, kein App Review mehr verlangt wird. Alle Entwickler*innen unterliegen den Messaging-Limits der WhatsApp Business Platform.

On-Premises API – 26. März 2022

Diese Version enthält dieselben Features wie v2.37.1. Sie verfügt jedoch über ein anderes Ablaufdatum. v2.37.2 läuft am 22. September 2022 ab.

Bekannte Probleme

Kubernetes-Entwickler*innen wird für ihren Web-App-Container möglicherweise CrashLoopBackOff angezeigt und ihr Container kann gegebenenfalls nicht gestartet werden. Um dies zu beheben, füge die folgende Zeile in der YML-Datei der Kubernetes-Bereitstellung in der Konfiguration der Web-App hinzu:

command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]

On-Premises API – 25. März 2022

Die Version v2.39.3 unseres Business API-Clients ist ab heute für Entwickler*innen verfügbar. Der neue Client enthält zwei Fehlerbehebungen und zusätzliche Protokolle zur Unterstützung des Debuggings. Die zwei Fehlerbehebungen sind:

  • Es wurde ein Fehler behoben, der Unternehmen daran gehindert hat, Nachrichten an Kund*innen zu senden, wenn der*die Kund*in die Interaktion zwischen den zwei Teilnehmenden auf WhatsApp initiiert hat und diese erste Nachricht mehr als sieben Tage in der Vergangenheit liegt.
  • Es wurde ein Fehler behoben, der Unternehmen daran gehindert hat, selbstlöschende Nachrichten von Kund*innen zu empfangen. Nach der Installation von v2.39.3 erhalten Unternehmen eine Webhooks-Benachrichtigung, wenn sie eine selbstlöschende Nachricht empfangen haben. Den Kund*innen wird eine Warnmeldung angezeigt, dass der Modus für selbstlöschende Nachrichten deaktiviert wurde.

Cloud API – 15. März 2022

Listennachrichten und Antwort-Buttons

Ab heute können Beta-Nutzer*innen der Cloud API Nachrichten mit Listen und Antwort-Buttons senden. Weitere Details findest du in der folgenden Dokumentation:

Vorschau-URL

Ab heute können Beta-Nutzer*innen der Cloud API zu Textnachrichten, die eine URL enthalten, ein URL-Vorschaufeld hinzufügen. Weitere Details findest du in der folgenden Dokumentation:

Neue Dokumentationsleitfäden

On-Premises API – 4. März 2022

Wir haben soeben die On-Premises API v2.39.2 veröffentlicht. In dieser Version wurde ein Fehler behoben, der das Senden von Videonachrichten unter bestimmten Umständen verhindert hat.

Bekannte Probleme

  • Es besteht ein Fehler, der Unternehmen daran hindert, Nachrichten an Kund*innen zu senden, wenn der*die Kund*in die Interaktion zwischen den zwei Teilnehmenden auf WhatsApp initiiert hat und diese erste Nachricht mehr als sieben Tage in der Vergangenheit liegt.
  • Es besteht ein Fehler, der Unternehmen daran hindert, selbstlöschende Nachrichten von Kunden zu empfangen.

Cloud API – 1. März 2022

Videonachrichten

Ab heute können Beta-Nutzer*innen der Cloud API Videonachrichten senden und erhalten. In der folgenden Dokumentation findest du weitere Details:

1. Februar 2022

WhatsApp Business Platform

Heute steigt WhatsApp von einem benachrichtigungsbasierten Preismodell auf ein unterhaltungsbasiertes Preismodell um. Unternehmen zahlen jetzt pro Chat. Eine Chat umfasst alle zugestellten Nachrichten innerhalb einer 24-stündigen Sitzung. Weitere Informationen findest du unter Unterhaltungsbasierte Preisgestaltung.

Cloud API

Standort- und Kontaktnachrichten

Ab heute können Beta-Nutzer*innen der Cloud API Standort- und Kontaktnachrichten senden und erhalten. Weitere Informationen findest du in folgender Dokumentation:

Update bei Spitzendurchsatz

Pro Telefonnummer wird nun ein Spitzendurchsatz von 80 Nachrichten pro Sekunde unterstützt. Dazu zählen ein- und ausgehende Nachrichten sowie Text-, Vorlagen- und Mediennachrichten.

On-Premises API (2.39.1)

Die Version 2.39.1 unseres Business API-Clients ist ab heute für Entwickler*innen verfügbar. Der neue Client umfasst:

Set Shards API

Mit der neuen Version des API-Clients kannst du nun das Zertifikat deines Telefons bereitstellen, wenn du Multiconnect einrichtest. Das bedeutet, wenn du den Endpunkt „/v1/account/shards“ aufrufst, kannst du das Base64-verschlüsselte Zertifikat im Zertifikatsfeld hinzufügen. Weitere Informationen findest du unter Deinen API-Client mit Multiconnect skalieren.

Neuer Hostname

Wir haben graph.whatsapp.com zur Liste der Server-Hostnamen für WhatsApp hinzugefügt, zu denen der Business API-Client Konnektivität erfordert. Weitere Informationen findest du unter Dein Netzwerk einrichten und debuggen, Hostnamen.

Fehlercode-Aktualisierungen

Mit Version v2.39 führen wir den Fehlercode 1031 ein. Du erhältst diese Fehlermeldung, wenn dein Konto gesperrt wurde und aufgrund eines Verstoßes gegen die Integritätsrichtlinien keine Nachrichten gesendet werden können. Weitere Informationen findest du unter Fehlercodes und Statusmeldungen und Richtliniendurchsetzung.

Veraltete Elemente

  • Messages API: Der Typ hsm wird mit v2.39 eingestellt. Verwende stattdessen den template-Typ.
  • Anwendungseinstellung: Die Anwendungseinstellung webhook_payload_conversation_pricingmodel_disabled wird eingestellt.

Bekannte Probleme

Unter bestimmten Bedingungen können einige Videonachrichten nicht gesendet werden.