# Creating a Broadcast

## Setup The Foundation

* Go to 'Broadcasts' from the main navigation panel on the QuickReply app.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-c13a22fc11ecfb13b7ba32779503cebbf23851da%2FFrame%2099.png?alt=media" alt=""><figcaption></figcaption></figure>

* Click on ‘**Create WhatsApp Broadcast**’

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-46f0d903f0658b724cab1e1c52c547f15470ee75%2FFrame%20100.png?alt=media" alt=""><figcaption></figcaption></figure>

* Give a name to your **Broadcast**.
* Select the Broadcast category between:

<details>

<summary>Promotional</summary>

Choose the Promotional category if the broadcast is **intended to drive sales** and you want to track:

* Revenue generated
* Amount spent
* Orders attributed
* Return on investment
* Conversion rate
* Link clicks, button clicks, click-through rates

</details>

<details>

<summary>Transactional</summary>

Choose the Transactional Category if you want to track:

* Messages read
* Conversion rate
* Link clicks, button clicks, click-through rate

</details>

* Add 'Tags' to broadcast to help in easy identification later
  * Either choose an existing tag from the dropdown
  * Or type in and create a new tag
* Click on 'Save & Continue.'

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-46b48191395879311f3bece257d348c14ca64d46%2FScreenshot%202025-04-02%20at%2010.52.40%E2%80%AFAM.png?alt=media" alt=""><figcaption></figcaption></figure>

## Select a Template

* Choose a **WhatsApp Template** from the list approved by Meta.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-33e72e89ebacf1ef9e32599e98add28df1b0f6f2%2FFrame%20102.png?alt=media" alt=""><figcaption></figcaption></figure>

* Preview the template on the right and ensure it aligns with the campaign goal.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-020aab84242b0d3d86f749ffe5537ef0b049a488%2FFrame%20103.png?alt=media" alt=""><figcaption></figcaption></figure>

* Click on 'Save & Next'

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-be3a54abfb744e5f65701a2338c80cf708ac2aad%2FFrame%20104.png?alt=media" alt=""><figcaption></figcaption></figure>

## Select Recipients

* Click on 'Select Recipients'

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-d369695cfeb2d0045988be67653bb223449a0acf%2FFrame%20105.png?alt=media" alt=""><figcaption></figcaption></figure>

* Select from:

<details>

<summary>Customer Segments on Shopify</summary>

* Create multiple Customer Segments
* Sync them with QuickReply.ai
* Dynamically gets updated with new users getting added to it.

</details>

OR

<details>

<summary>Excel File</summary>

* Use the Excel File option.
* Ensure column headers are labeled as phone, {{1}}, {{2}}, etc.
* Use contacts of users who've interacted with your brand.
* Avoid third-party contact data to maintain WhatsApp API Account Health.
* Choose the column that contains phone numbers
* And a default country code, in case the phone numbers do not have a country code already attached
* Click on 'Confirm' to move on

</details>

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-dbdde71ba8c93228eb4237b8cbe1d56ec5eb25f4%2FFrame%20128.png?alt=media" alt=""><figcaption></figcaption></figure>

## Provide Content for Variables

* Upload an image/video/document (if any) from your device while making sure that it is in the recommended size and format
* Define the variables in the body:
  * You can define variable values as
    * Static (enter manually) OR
    * Dynamic
      * Select attributes like 'First Name,' 'Last Name,' and so on from the Shopify data, if your recipient's source is a Shopify segment.
      * Select Excel column names like "Column A", "Column B" from the Excel file if your recipient's source is an Excel file
      * If the selected data isn't available, add a Fallback Value to be used. The same fallback value will be displayed in the preview.
* Define the content of the URL button:
  * Add a URL that will redirect users upon clicking. It must start with "http" or "https"
  * Static values
    * If a variable has a consistent value for all recipients, input that value directly into the text box.
  * Dynamic values
    * If you want to send different links to each recipient, you can use an excel file column or shopify segement data to populate values.
    * You will also need to define the fallback value to be used incase of an error value.
    * For an excel column, QuickReply smartly identifies error urls and asks you either to
      * Skip those recipients or
      * Use fallback value

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-d0f58a426232e227d76462ad605b3e8e1e1d4f37%2FFrame%20109.png?alt=media" alt=""><figcaption></figcaption></figure>

## Map User Attributes (optional)

Using this option, you can map attributes of a user profile in quickreply with the updated values from the values provided.

* Click on the toggle to enable attribute mapping

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-407833529e487f0eba0db3c4f2be247a55bb6d26%2FFrame%20106.png?alt=media" alt=""><figcaption></figcaption></figure>

* Click on Add new attribute.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-7bcc561121aed840f3553dec4cb5d61e6c36156d%2FFrame%20108.png?alt=media" alt=""><figcaption></figcaption></figure>

* Select the corresponding user attribute field (e.g., Name, Email, Other user attribute).
* Define excel column or Shopify segment data to use as source data for attribute. If you want to overide the existing attribute data of a customer with updated data provided, check this option.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-8bc3af2743db3779c383ff05d9b0396c1434701b%2FFrame%20109%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

* Click on 'Save & Next' to move to the next screen

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-0d233475021d0212312d36185a24e3c9ec5bd208%2FFrame%20110.png?alt=media" alt=""><figcaption></figcaption></figure>

## Bot Mapping for 2-way Broadcast Engagement

Here you can define which bots to engage when recipient replies

* By default you will need to,
  * Define 'Bot to engage when recipient replies with anything else'
    * Choose a pre-trained or custom bot from the dropdown
* If your template has atleast 1 quickreply button, you will get the following option to
  * Define 'Bot to engage when recipient replies with quick reply buttons'
    * Choose a pre-trained or custom bot from the dropdown

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-142ab1f52e35c551a5a7bc78b0a8a72bd8cbe45a%2FFrame%20126.png?alt=media" alt=""><figcaption></figcaption></figure>

## UTM Parameters

* Enable UTM Tracking in the broadcast settings.
* Define parameters:
  * Source (e.g., WhatsApp)
  * Medium (e.g., Broadcast)
  * Campaign Name (e.g., Broadcast Name)
  * ID
  * Term

This allows source tracking within third-party reporting tools such as Google Analytics.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-5d9473cc636ee7d5f056e461b01894f4588fcf24%2FFrame%20126%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

## Smart Audience Filtering

* Enable filters such as:

  * Dead Audience Filtering

  Skip recipient(s) if the contact has not engaged with your WhatsApp number for the last\
  desired number of days.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-c4bc1f21a0c18089c3799d373113d82f4fb41da7%2FFrame%20126%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

* Marketing Message Frequency Control

Skip recipient(s) if the contact has already received a certain number of marketing message(s) in a defined time.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-91037f1a6525c6e662fbdb1fc64a199f3bd01d00%2FFrame%20126%20(3).png?alt=media" alt=""><figcaption></figcaption></figure>

* Duplicate Filtering

This will be enabled by default to skip recipient(s) if a duplicate contact is found.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-757ad532679ac66a731333f26ed1e7fa31b5fa95%2FFrame%20126%20(4).png?alt=media" alt=""><figcaption></figcaption></figure>

## Messaging Limit Check

WhatsApp has daily [messaging limits](https://docs.quickreply.ai/overview/messaging-channels/whatsapp/concepts#messaging-limits) based on business verification status. Be defining the messaging limit, you automate what should be done when your limit exceeds.

You can either:

* Pause broadcast (recommended)

  The broadcast will automatically continue as soon as the limit is available

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-825a6b472679b282332caa9140a71c3603b90cef%2FFrame%20112.png?alt=media" alt=""><figcaption></figcaption></figure>

* Skip the Messaging limit check and try sending it to all

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-c6e9806f0b353f762bcd6a705ceeb66404a97a68%2FFrame%20113.png?alt=media" alt=""><figcaption></figcaption></figure>

* Click on 'Save & Next' to move to the next screen

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-dbce8f470562741af681c05f95c7991eab606703%2FFrame%20114.png?alt=media" alt=""><figcaption></figcaption></figure>

## Schedule Time

Determine when the broadcast starts running:

* Click on the 'calendar' icon to choose your preferred date and time. Latest you can schedule a broadcast is 15 minutes from current time.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-ceaa9f587b677837b0dd97a759f4037e5223aa57%2FFrame%20123.png?alt=media" alt=""><figcaption></figcaption></figure>

* Hit 'Confirm' to schedule

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-9b2e1ced764548efa7b05ae5843dc3b8de658dfe%2FFrame%20124.png?alt=media" alt=""><figcaption></figcaption></figure>

## Retry for Failed Messages

QuickReply provides 2 methods to recover marketing messages failed due to Meta's [frequency capping](https://docs.quickreply.ai/overview/messaging-channels/whatsapp/concepts#frequency-capping):

* **Auto-Retry of Failed Marketing Messages**
  * In this, the system retries the delivery of failed messages at different times defined by the user.
  * While setting up auto-retries, a maximum of 3 retries can be set and we recommend scheduling retries with a minimum 24-hour interval to maximize the chances of successful deliveries.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-3db78795ac2de08524fb671fcaddf511b5fc95d3%2FFrame%20125.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Smart Utility Fallback**
  * For the remaining failed messages, the system sends a utility message that seeks consent from the customer to re-deliver the failed message. If the customer engages, the marketing message is delivered instantly.
  * This feature involves sending an additional utility message for each failed message which incurs extra cost.
  * The marketing template message is converted as a session message and sent when the user engages with the utility message. Important - this converted message is charged the same as a marketing message.
  * We recommend using this method after auto-retries to minimize the extra cost incurred.
  * Smart Utility Fallback currently supports standard marketing templates only.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-aad6ea61f6599e9e31f6587857edee9a6b38d8de%2FFrame%20127.png?alt=media" alt=""><figcaption></figcaption></figure>

## **Send Test Message**

Before sending the broadcast, test it on a **sample recipient**.

* While sending test message:
  * The variables will be populated with values from the fallback value.
  * The user attributes will not be updated.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-033bca1ca654af01905c7dd4ef2748ebb02e78d9%2FFrame%20125%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

## **Review and Publish**

Review the:

* Estimated spend

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-ea706a07e3ec9a654921458fd77be0759f65ed71%2FFrame%20127%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

* Schedule and retry failure

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-22d92ccd6ac2e1c8e2c094fa4c8bc285a83ea865%2FFrame%20127%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

* Message, recipients, and settings

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-6d7fc9c6723f91019f026920fbbbe73e15ec0ee6%2FFrame%20127%20(3).png?alt=media" alt=""><figcaption></figcaption></figure>

* Tracking & audience eiltering

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-b7a0bdb48cb68c8e1cb8308ed382d0b330795b97%2FFrame%20127%20(4).png?alt=media" alt=""><figcaption></figcaption></figure>

* Click 'Schedule Broadcast' and voila! You have successfully scheduled your first broadcast message.

<figure><img src="https://1325107618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FePPO97Ju334NhhCzTEZP%2Fuploads%2Fgit-blob-12ae49eb8526aa905507ed6db99855dcacd5f8c6%2FFrame%20127%20(5).png?alt=media" alt=""><figcaption></figcaption></figure>
