WhatsApp Flows

Changelog

Currently Supported Versions

Purpose Flow JSON version Data API version Message version

Creating Flows

2.1, 3.0,

3.1

3.0

3

Sending Flows

2.1, 3.0,

3.1

3.0

3

Release Notes

April 2024 release

Support the Optin component in the Flows UI builder

  • Extend the support of the opt-in component in the Message Templates in Flows UI editor to allow users to add and modify an additional "Read More" screen.
  • This feature enables you to display additional information (e.g., terms and conditions) on a separate screen instead of cluttering the main Flow screen. This would improve the user experience and simplifying the Flow creation process.

March 2024 release

Flows template gallery

  • Adds a new screen for creating flow. The users can now interact with the template before using it for creating a flow.

Exposing "UpdatedAt" field

  • New field “UpdatedAt” exposed for the GraphAPI endpoints.
  • The field is updated for every flow when name, status, flow json, etc. changes.
  • The field is returned with the GraphAPI endpoint and used on the WA Manager -> Flows page.

BugFix- "form_name" will be removed from business paylaod

  • Bug fix for Android implementation where 'form_name' was unintentionally included in payload. If businesses are using this, then they may need to modify server implementations for a more sustainable setup.

February 2024 release

Details page

  • Introduce a new details page that provides a clear overview of Flow endpoint performance, with data on availability, latency, requests, and errors.
  • This page is available for published Flows with endpoint from the Flows Builder in WhatsApp Manager.

Monitoring API

  • Introduce a new GraphAPI field in WA Flow object named “metric” which allows businesses retrieving a set of endpoint related metrics.

Send Flow via WhatsApp Manager

  • Introduce a new feature in the Flows Builder that allows Flows to be sent directly via WhatsApp Manager. The functionality works only with phone numbers registered to Cloud API.

New flow template: appointment booking template

  • Add a new flow JSON template “Book an Appointment” which can be used when creating a flow in Builder. The flow template can be found here.
  • Add an endpoint example in NodeJS that works with the “Book an Appointment” flow JSON end to end. The endpoint code is available on Github and Glitch.
  • Enhance the endpoint example on Github and Glitch to include app secret validation, endpoint error codes, script to create public/private keys, and other improvements.

Endpoint public key setup validation during sending flow messages via OnPrem

  • On-Premises API may reject sending messages with flows connected to endpoints with error code 2068 if required setup is not complete, for example, public key is not uploaded or is invalid.

January 2024 release

Introduces support for Flow JSON version 3.1

  • Adds optional property ‘success’ for terminal screens to indicate whether terminating on that screen results in a successful flow completion.

  • A new field 'endpoint_uri' has been introduced and should be used instead of deprecated 'data_channel_uri'.

API changes

December 2023 release

Adds an end-to-end example for an endpoint server in Node.js that can be edited online on Glitch. The source code is also available on Github.

Introduces support for Flow JSON version 3.0

  • Removes the “data_channel_uri” property from Flow JSON
  • Introduces ability to specify Flow endpoint via API or WhatsApp Manager.

WhatsApp Manager changes

  • Adds additional filtering options (by ID and status) on the listing page of Flows
  • Adds support for deleting and deprecating Flows
  • Adds the ability to clone Flows

Flows in Message Templates

  • Adds support for attaching images when creating and attaching Forms in Message Templates
  • Adds new custom form starter template when creating and attaching Forms in Message Templates

API changes

October 2023 release

Initial release of the WhatsApp Flows.

Introduces support for Flow JSON version 2.1

Introduces support for Data Api version 3.0