Changelog

This changelog covers what has changed in the WhatsApp Business Platform.

Cloud API ChangesOn-Premises API ChangesChanges Affecting All APIs

Cloud API Changelog Archive

On-Premises API Changelog Archive

Handling Updates

On-Premises API users must install new client versions to keep using the API without disruptions. Deprecated versions of the API client are not supported anymore. Should a client lose connection after the expiration date, the deprecated client will not be able to connect to the server and cannot send or receive messages.

Cloud API users don’t need to perform any software upgrades to use the new features announced in this changelog. Cloud developers may need to update their application’s code to use the new features.

WhatsApp Business Cloud API - May 19, 2022

Starting today, the WhatsApp Business Cloud API is open to all developers building products or services for themselves or their organizations. To get started, see our guide. If you are interested in offering API access to your customers, please join our waitlist.

WhatsApp On-Premises API - May 10, 2022 (v2.39.4)

This client version contains all features and fixes shipped with v2.39.1. Additionally, this release:

  • Fixes a bug that prevented video messages from being sent under certain circumstances. This fix was also included in v2.39.2.
  • Fixes a bug that prevented businesses from sending messages to a customer, if the consumer was the first to initiate an interaction between the two parties on WhatsApp, and that initiation happened more than 7 days ago. This fix was also included in v2.39.3.
  • Fixes a bug that prevented businesses from receiving disappearing messages from customers. After v2.39.4 is installed, businesses will get notified they received a disappearing message by a webhooks notification with type set to "ephemeral". Businesses will not be able to see the message's content.

When we launched v2.39.3, the disappearing messages issue was handled by WhatsApp automatically disabling these messages in the chat thread with the client. For v2.39.4, we will not do that. With this version, businesses that receive disappearing messages must ask the customer to disable disappearing messages and resend their latest message.

Cloud API - May 3, 2022

Starting today, the Cloud API includes the following upgrades:

  • Fixed an issue related to disappearing messages from users.
  • Better determination of thumbnail quality for media messages.

WhatsApp Business Platform - Apr 14, 2022

Improved Onboarding

We’re making it easier for businesses and partners to scale on the WhatsApp Business Platform with an improved onboarding experience. Starting May 2, 2022, businesses will be able to message customers immediately after signup and only need to complete Business Verification when they’re ready to scale business-initiated conversations or request to become an Official Business Account.

The changes mean that onboarded businesses will be able to:

  • Respond to unlimited customer-initiated conversations,
  • Send business-initiated conversations to 50 unique customers in a rolling 24-hour period.

These are the changes being implemented on May 2, 2022:

  • WhatsApp Account checks and display name review will no longer be a requirement to get started on the platform. After signup, a compliance check with the WhatsApp Platform Policy Checks will be auto-triggered and will be performed in the background.
  • Display name review will be initiated after Business Verification is completed. Businesses should still follow the display name best practice guidelines when adding a new phone number. For more information, see Display Names.
  • Business Verification only needs to be completed when businesses are ready to scale business-initiated conversations or request to become an Official Business Account (OBA). For more information, see how to increase limits.
  • Since businesses get access to sending messages after sign up, the Unverified Trial Experience will be deprecated.
  • Businesses will be able to see the messaging limits in the Overview Dashboard in WhatsApp Manager -after completing the signup process.

The changes listed above have no impact on pricing. See pricing for more details.

Cloud API - Apr 5, 2022

Starting today, the Cloud API is generally available to all existing Business Solution Providers (BSPs) and direct clients. Additionally, we’re releasing the following features for Cloud API developers:

  • Messages with Stickers: Send media messages containing third-party static stickers. See the following documentation for more details: Reference, Messages and Reference, Media. We support inbound both and outbound stickers. For outbound, we only support static third-party stickers. For inbound, we support all types of stickers.
  • Deregister Phone Number API: Make POST calls to PHONE_NUMBER_ID/deregister in order to remove a phone number from the WhatsApp Business API. See Registration for information.
  • New Phone Verification Option: Verify your business phone number via Graph API calls. See Phone Numbers for information.
  • New Referral Webhooks: Receive Webhooks notifications when a user clicks on an ad that clicks to WhatsApp and sends a message to the business. See Webhooks for information. Be aware that the Cloud API's webhooks referral object is different from the On-Premises API's referral object.

Additionally, we are announcing that App Review is no longer required for first-party developers using the Cloud API. All developers are subject to the WhatsApp Business Platform messaging limits.

On-Premises API - Mar 26, 2022

This version contains the same features as v2.37.1, but there's a different expiration date. v2.37.2 expires on Sep 22, 2022.

Known Issues

Some Kubernetes developers may see CrashLoopBackOff for their webapp container and their container may fail to start. To fix that, add following line in the Kubernetes deployment YML file under webapp configuration:

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

On-Premises API - Mar 25, 2022

The v2.39.3 version of our Business API client is available for developers today. The new client includes two fixes and additional logs to support debugging. The two fixes are:

  • Fixed a bug that prevented businesses from sending messages to a customer, if the consumer was the first to initiate an interaction between the two parties on WhatsApp, and that initiation happened more than 7 days ago.
  • Fixed a bug that prevented businesses from receiving disappearing messages from customers. After v2.39.3 is installed, businesses will get notified they received a disappearing message by a webhooks notification. On their end, customers will see a warning saying that the disappearing messages mode has been turned off.

Cloud API - Mar 15, 2022

List Messages and Reply Buttons

Starting today, Cloud API beta users can start sending and list and reply button messages. See the following documentation for more details:

Preview URL

Starting today, Cloud API beta users can add a preview URL box to text messages that include a URL. See the following documentation for more details:

New Documentation Guides

On-Premises API - Mar 4, 2022

We just released the On-Premises API v2.39.2. This version fixes a bug that prevented video messages from being sent under certain circumstances.

Known Issues

  • A bug exists that prevents businesses from sending messages to a customer, if the consumer was the first to initiate an interaction between the two parties on WhatsApp, and that initiation happened more than 7 days ago.
  • A bug exists that prevents businesses from receiving disappearing messages from customers.

Cloud API - Mar 1, 2022

Video Messages

Starting today, Cloud API beta users can start sending and receiving video messages. The following documentation provides more information:

Feb 1, 2022

WhatsApp Business Platform

Starting today, WhatsApp has switched from a notification-based pricing model to a conversation-based pricing model. Businesses are charged per conversation, which includes all messages delivered in a 24 hour session. See Conversation-Based Pricing for information.

Cloud API

Location and Contact Messages

Starting today, Cloud API beta users can start sending and receiving location and contact messages. See the documentation below for more information:

Peak Throughput Update

We now support 80 messages per second peak throughput per phone number. This includes incoming and outgoing messages, as well as text, template and media messages.

On-Premises API (2.39.1)

The 2.39.1 version of our Business API client is available for developers starting today. The new client includes:

Set Shards API

Starting with the new API client version, you may provide your phone’s certificate when you are setting up multiconnect. That means that, when calling the /v1/account/shards endpoint, you can add the Base64-encoded certificate in the cert field. See Scale Your API Client With Multiconnect for information.

New Hostname

We have added graph.whatsapp.com to the list of WhatsApp server hostnames that the Business API client requires connectivity to. See Set Up and Debug Your Network, Hostnames for information.

Error Code Updates

With v2.39, we have added error code 1031. You will get this error if your account has been locked and can’t send any messages due to an integrity policy violation. See Error and Status Messages and Policy Enforcement for information.

Deprecations

  • Messages API: The hsm type has been deprecated with v2.39. You should use the template type instead.
  • Application Setting: The application setting webhook_payload_conversation_pricingmodel_disabled has been deprecated.

Known Issues

Some video messages fail to send under certain circumstances.