Getting Started with WhatsApp Flows

WhatsApp Flows make it easy for businesses to collect information from their users via rich UI components within WhatsApp. This is very useful for use cases such as capturing new leads, registrations, and customer feedback.

In order to start using WhatsApp Flows, there are a few steps follow:

  1. Create WhatsApp Flow - Create your WhatsApp Flow definition in WhatsApp Manager.
  2. Create WhatsApp Template - If you are using WhatsApp Flow as a business initiated message, create a WhatsApp template that will start the WhatsApp Flow.
  3. Send a Message Using the WhatsApp Flow - Send the message that will start the WhatsApp Flow using the WhatsApp template created, or as an interactive message within an existing conversation window.

Create WhatsApp Flow in WhatsApp Manager

Currently, WhatsApp Flows can only be created within WhatsApp Manager.

You can create a new WhatsApp Flow in WhatsApp Manager > Flows menu. You can also create a new WhatsApp Flow when creating a new WhatsApp template.

In the flows editor, first you'll need to add a name for your flow, and select a template for the type of information you'd like to collect:

Then, edit the JSON to add a description and update the questions and answers the user will fill out once the flow is sent:

See the Meta documentation for a full list of templates and components that can be enabled in the JSON that defines the flow.

Example Flow and JSON

An example of a WhatsApp Flow and its JSON definition is provided here:

Create WhatsApp Template to Start the Flow

In order to send the WhatsApp Flow as a business initiated message to the user, you would need to create a WhatsApp template with a button that would start the flow.

You can use Vonage’s WhatsApp Template Management API to create this template.

An example of the request payload creating the template is provided here:

Send a Message Using the WhatsApp Flow

When sending a Flow using the Vonage Messages API, you'll need to send a message of type custom. You can either send a message using a template containing a flow, or in a message without a template, depending on when and how the conversation was initiated.

Using a Template Containing a Flow

To send the WhatsApp Flow as a business initiated message, you must have first created a WhatsApp template.

Here is an example of the Messages API request payload to send the WhatsApp template that will start the WhatsApp Flow:

Using a Message Containing a Flow

During an existing conversation (within the 24-hour window), you can send the WhatsApp Flow without creating a template beforehand.

Here, you'll need to include the flow_id of the Flow you created earlier. This is an example of a request when using the Messages API:

WhatsApp Flow User Response

Information submitted by the user within your WhatsApp Flow will be passed to you at the configured Messages API webhook. Please refer to Meta’s documentation on the full response format.

Here is an example:

Vonage Documentation on inbound message webhooks is available in the API Reference, under WhatsApp > Button (Flows).