> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/reach-participants/broadcast-templates.md).

# Broadcast templates

Create a WhatsApp template for invites, reminders and follow-ups, choose the right category and get it approved by Meta.

A **template** is a message Meta has approved in advance. WhatsApp only lets a business start a conversation, or message someone who has not replied in the last 24 hours, with an approved template. Every broadcast, invite, reminder and between-activity message in Yazi uses one.

{% hint style="info" %}
**In short:** create templates with **+ Create** on **Broadcast Messages** (or with **+ New template** inside the Send broadcast window). Choose **Marketing** or **Utility**, write a header, body and buttons, and submit. Meta usually approves in minutes to a few hours. Names use lower-case letters and underscores, with no spaces or capitals. Reminder and between-activity templates need a **Continue** button and an **Opt-out** button.
{% endhint %}

## Before you start

* Templates belong to a WhatsApp number. If you move to a new number, templates do not carry over and must be created and approved again.
* Every organisation starts with a set of default templates, for example "Default participant invite (English US)", "Default study progression", "Default survey completion", "Default interview extension", "Default external link" and "Default incentive". Check **Broadcast Messages** before writing your own.
* Meta reviews every template, including its category. Read [WhatsApp costs and the 24-hour window](https://docs.askyazi.com/reach-participants/whatsapp-costs-and-the-24-hour-window.md) first if cost matters to you.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FLQfsy7ocuSxSeeKkqCqO%2Ffs-broadcast-list.webp?alt=media&amp;token=74563128-8ef3-4f81-8bfb-95a766792966" alt="Broadcast Messages > All broadcasts: each template with its Meta category, type, language and approval status"><figcaption></figcaption></figure>

## Create a template

The **Create Broadcast** window takes you through six steps, starting with **Select Template**. The counter at the top shows where you are. The steps below cover what you fill in along the way.

{% stepper %}
{% step %}

### Open the template builder

Go to **Broadcast Messages** in the left navigation and click **+ Create**, or click **+ New template** inside the **Send broadcast** window on a study. Creating it from the send window keeps the people you selected, so you can send once it is approved.
{% endstep %}

{% step %}

### Select the template type

Step 1 asks "What kind of broadcast would you like to create?". The type decides which buttons are set up for you. See [Template types](#template-types) below.
{% endstep %}

{% step %}

### Name, category and language

Give it a name using **lower-case letters and underscores only**, for example `spring_shopper_invite`. Spaces and capitals make Meta reject the template. Choose the category (Marketing or Utility, see below) and the language.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FC5RgzqBr0gez4vbWCwkC%2Ffs-create-broadcast-content.webp?alt=media&amp;token=905510c8-320b-4a9d-a117-5d132718c23d" alt="Create Broadcast, step 2: name, Meta category, language and template type, with the rules for that type and a live preview"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Write the message

Add a header (your logo image or a short text line), the body, and buttons. See [Parts of a template](#parts-of-a-template).

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FLlt4D79b37ksUJj3nYNQ%2Ffs-create-broadcast-message.webp?alt=media&amp;token=8e04dfeb-c288-4464-a216-4bc37c955c0b" alt="Create Broadcast, step 3: header, message with variables, optional footer and the buttons, previewed on the right"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Submit to Meta

Submit. You see a green tick and "Sent to Meta for approval". The template appears on the **All broadcasts** tab of **Broadcast Messages** with its **Category** (MARKETING or UTILITY, as Meta decided), **Broadcast Type**, **Language** (for example en\_US) and **Status**. Once it reads **APPROVED** you can send it.
{% endstep %}
{% endstepper %}

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FlVawgS8AydibEwNrpn5Y%2Ffs-create-broadcast-types.webp?alt=media&amp;token=75b54ff6-6b0f-4d0f-b89b-fbf414b393be" alt="Create Broadcast, step 1 of 6: choose a starting point such as Participant Invite, Reminder, Campaign Router, Screen-out Message, Survey Completion or Interview Extension"><figcaption></figcaption></figure>

## Template types

| Group          | Type                    | Use it for                                                                                                             |
| -------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Research Flow  | **Participant Invite**  | Inviting people to a study, with start and opt-out buttons                                                             |
| Research Flow  | **Reminder**            | Bringing people back to pick up where they left off                                                                    |
| Research Flow  | **Campaign Router**     | Connecting participants to an existing study, or routing them to a different activity (for example between activities) |
| Research Flow  | **Screen-out Message**  | Sending screened-out participants to another study with routing buttons                                                |
| Completion     | **Survey Completion**   | The closing message when someone finishes                                                                              |
| Completion     | **Interview Extension** | Letting someone choose to continue or end their interview after completing it                                          |
| Marketing      | **Carousel**            | A swipeable set of cards, mainly for marketing messages                                                                |
| Marketing      | **External Link**       | Sending people to a web page, such as a review site or a results page                                                  |
| Authentication | **Authentication**      | A one-time passcode with a copy-code button. Not normally used for research.                                           |
| Advanced       | **Blank Canvas**        | Any other message, built from scratch                                                                                  |

## Parts of a template

**Header.** Your organisation logo (the **Organisation Logo** under **Settings > Branding**) or a line of text. If you change the logo, it changes on every template that uses it. An image header usually gets more attention. Images over WhatsApp's size limit are resized automatically, which can lower their quality, so upload a reasonably sized image.

**Body.** The main text. Say who you are, what the study is about, how long it takes and what the reward is, if any. You can add variables, written `{{1}}`, `{{2}}` and so on. When you send, each variable is filled from a column in your contact list, for example first name or the product they bought. When creating the template, put realistic example text in each variable so Meta understands how it will be used.

**Buttons.**

| Button               | What it does                                                                               | Needed on                                                     |
| -------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
| Start (study) button | Starts the study you link when you send                                                    | Invites                                                       |
| **Continue**         | Resumes the participant at the exact question they stopped on, or starts the next activity | Reminders and between-activity invites (required)             |
| **Opt-out**          | Stops further broadcasts from your number to that person                                   | Every broadcast (strongly recommended, required on reminders) |
| Link button          | Opens a web page                                                                           | External link messages                                        |

## Marketing or utility

|            | Marketing                                                                                   | Utility                                                                                  |
| ---------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| What it is | Promotional or request-based: invitations, incentive offers, general research requests      | Tied to a specific transaction or account event the person took part in                  |
| Example    | "Share your thoughts and get R50 airtime"                                                   | "Thanks for your visit to our Rosebank store on 3 October. Please rate your experience." |
| Cost       | Higher                                                                                      | Much lower                                                                               |
| Delivery   | Meta limits how many marketing messages one person receives, and people can switch them off | Fewer delivery limits                                                                    |

Meta, not Yazi, makes the final call. If you choose Utility and Meta thinks the message is promotional, it reclassifies it as Marketing. An invite that leads with an incentive will almost always be classed as Marketing.

To give a utility template the best chance:

* Reference a specific event: a date, a store, an order, a service call.
* Keep the tone transactional ("Rate your experience"), not persuasive ("Win!", "Don't miss out").
* Leave the reward out of the template wording.

If Meta classes a template as Marketing and you believe it is Utility, you can appeal in Meta Business Manager. Appeals take a day or two. This cannot be done inside Yazi, so whoever appeals needs access to the Meta Business account for your number.

## Templates in other languages

Meta approves each language separately. A study that runs in three languages needs its invite and reminder approved in each language. For reminders, Yazi can translate an existing template in one click and submit it; until Meta approves it, participants get the default-language version. See [Reminders](https://docs.askyazi.com/reach-participants/reminders.md).

## Reminder and between-activity templates

These templates are sent automatically, so they have extra rules:

* They must have a **Continue** button and an **Opt-out** button. The starter reminder template already does. The message builder warns you if a reminder is missing them, and the reminder list hides templates without them (and says how many it is hiding and why).
* They cannot use contact-list variables, because they are sent to each person at different times. Templates with variables are hidden from the between-activity invite picker.
* A multi-activity study cannot go live with a scheduled invite that has no Continue button.

## Approval

Most templates are approved within minutes to a few hours. Some take up to a day. Create templates well before launch.

Common reasons for rejection:

* A name with capitals, spaces or other characters (shows as an error when you submit).
* Promotional wording in a utility template.
* Content that breaks WhatsApp's Commerce Policy.
* Vague or misleading example text in variables.
* URL shorteners or suspicious links.

To change an approved template, Meta has to approve it again. In practice it is often quicker to create a new one.

## Limits and things to know

* Template names: lower-case letters and underscores, no spaces or capitals. A name already in use is refused with a message.
* Templates are per WhatsApp number and do not move with you to a new number.
* Logo images over 5 MB are refused at upload.
* Sending to US numbers: read the note on US marketing messages in [WhatsApp costs and the 24-hour window](https://docs.askyazi.com/reach-participants/whatsapp-costs-and-the-24-hour-window.md) before you plan a marketing invite.

## Related

* [Send a broadcast](https://docs.askyazi.com/reach-participants/send-a-broadcast.md)
* [Reminders](https://docs.askyazi.com/reach-participants/reminders.md)
* [WhatsApp costs and the 24-hour window](https://docs.askyazi.com/reach-participants/whatsapp-costs-and-the-24-hour-window.md)
* [Send history and statuses](https://docs.askyazi.com/reach-participants/send-history-and-statuses.md)
