All Products
Search
Document Center

Chat App Message Service:Send a WhatsApp Message

Last Updated:Feb 26, 2025

This topic describes how to configure the Send a WhatsApp Message component. Users can use specific WhatsApp features to reply to such messages.

Component information

Icon

发送WhatApp消息@1x

Name

Send a WhatsApp Message

Prerequisites

Go to the canvas page of an existing flow or a new flow.

  • Go to the canvas page of an existing flow.

    Log on to Chat App Message Service Console. Choose Chat Flow > Flow Management. Click the name of the flow that you want to edit. The canvas page of the flow appears.

    image

  • Create a new flow to go to the canvas page. For more information, see Create a flow.

Procedure

  1. Click the Send a WhatsApp Message component icon on the canvas.image

  2. In the right-side panel, configure the component based on your business requirements. For more information, see the Parameters section of this topic.

  3. Click Save in the upper-right corner. In the dialog box that appears, click Save.

    image

Parameters

Available variables

By default, commonly used variables are created and displayed in the available variables section. You can use these variables when you orchestrate a chat flow. You can click Insert Variable to add a custom variable. After a custom variable is added, the variable is displayed in the available variables section. For more information about how to use available variables, see Use available variables.

Message Sending Settings

You can select From/To or Reply from the Action drop-down list.

Important

When the trigger type of the flow is Manual, the action must be From/To.

From/To

Sending Type

Description

Example

Mobile Number

If you select Mobile Number for the Sending Type parameter, you must configure the Channel, Sender Mobile Number, and Recipient parameters. You must select a channel that is approved and a phone number that can receive and send messages properly. You can enter the phone number of a recipient or click Insert Variable to insert a defined variable or add a new variable.

image

Variable

If you select Variable for the Sending Type parameter, you must select a variable that specifies the phone number of the message sender. You can enter the phone number of a recipient or click Insert Variable to insert a defined variable or add a new variable.

image

Reply

If you select Reply from the Action drop-down list, you do not need to perform additional configurations in the Message Sending Settings section. The phone number within the WhatsApp Business Account (WABA) associated with the trigger component is used to reply to the mobile originated (MO) messages from users.

Message Settings

In the Message Settings section, you can specify the type of the messages that you want to send. The following message types are supported: Text, Media, Interactive, Product, and Template.

Text

Text indicates text messages. If you select Text, you must configure the Content parameter. You can reference variables in the message content.

Media

Media indicates multimedia messages. The following media file types are supported: Image, Audio, Video, File, and Location. If you select Location, you must configure the Longitude and Latitude parameters. If you select other values, you must configure the URL parameter.

The following table describes the supported formats and size limits on media files in a WhatsApp message.

Type

Format

Size limit

Audio

ACC, MP4, MPEG, and AMR

16 MB

File

TXT, PDF, PPT, DOC, XLS, DOCX, PPTX, and XLSX

100 MB

Image

JPEG and PNG

5 MB

Video

MP4 and 3GP

  • Only H.264 video codecs and Advanced Audio Coding (AAC) audio codecs are supported.

  • Videos with a single audio stream or no audio stream are supported.

16 MB

Interactive

Interactive indicates interactive messages that contain buttons or lists.

Message Action

Description

Example

Reply Button

  • If you select Reply Button, the interactive messages consist of multiple buttons. You can turn on or off Add Header or Add Footer to specify whether to add a message header or message footer for interactive messages.

  • By default, Add Header and Add Footer are turned off. If you turn on the switches, you must configure the message header and footer information. A message header or footer can be up to 60 characters in length.

  • The Body parameter is required. You can insert variables. A message body can be up to 1,024 characters in length.

  • You can click Add Button to add more buttons and specify custom names for buttons. A button name can be up to 20 characters in length. You can add up to three buttons.

image

List

  • You can determine whether to configure the Header and Footer parameters, which are optional. A message header or footer can be up to 60 characters in length.

  • You must configure the Body parameter. A message body can be up to 1,024 characters in length. When you configure this parameter, you can insert variables.

  • You must configure the Button Name parameter. The button name can be up to 20 characters in length. When you configure this parameter, you can insert variables.

  • You can click Add Section to configure sections and items.

    • You can add multiple sections and items based on your business requirements. However, the number of items for all sections cannot exceed 10.

    • If you add a section, the Section Name parameter is required. A section name can be up to 24 characters in length. Each section must have a name.

    • If you add an item for a section, the Item parameter is required. An item name can be up to 24 characters in length. Each item must have a name.

    • The Item Description parameter is optional. An item description can be up to 72 characters in length.

image

Product

Product messages include single-product messages and multi-product messages. Only one product ID can be added to a single-product message. However, you can add multiple product IDs to a multi-product message and create groups for the product IDs.

When you configure the Catalog ID and Commodity ID parameters, you must enter the IDs provided by the Commerce Manager platform of Meta. To obtain the IDs, go to the Commerce Manager platform, and select your account and shop. In the left-side navigation pane, choose Catalog > Items to view the desired IDs.image

Template

If you select Template, you must configure the Channel and Template parameters. The WABA associated with the selected message channel and the selected message template must be approved. Click Preview to preview the template content.image

Timeout Settings

You can turn on or off Undelivery Branch and Unread Branch based on your business requirements. After you turn on the switches, you can customize the timeout periods and add components to address issues with message delivery failures and unread messages. For example, if a WhatsApp message fails to be delivered within the specified timeout period, you can add the Send an SMS Message component to send a message as a fallback.

Interactive Reply Settings

These settings are only available to interactive messages.

Parameter

Description

Example

Interactive Reply-based Branch

After you turn on the switch, branches are created based on the buttons or items specified in the interactive messages. You can add components to configure the branches.

image

Branch for Interactive Reply Wait Timeout

After you turn on the switch, the Not Replied branch is created to handle timeout issues. You need to customize the timeout period by configuring the Wait Time for Interactive Reply parameter. If this switch is turned on and no component is added to the branch, the system continues with subsequent steps after a timeout.

image

Wait Time for Interactive Reply

You can specify a timeout period by second, minute, and hour. After the specified timeout period is reached, the configurations in the Not Replied branch will take effect.

-

Custom Output Variable Name

You can specify a custom variable that is used to capture user choices. The custom variable will be displayed in the available variables section and can be referenced at any time in the subsequent steps of the chat flow.

-

Advanced Settings

Parameter

Description

Status Report

After you turn on the switch, you must enter the URL that receives status reports.

Track ID

The track ID is used to mark and track specific messages.