> ## Documentation Index
> Fetch the complete documentation index at: https://codking.tech/documentation/llms.txt
> Use this file to discover all available pages before exploring further.

# Branded WhatsApp – Creating a New Template and Binding Events

> Understand the difference between creating a WhatsApp template and binding it to an event in COD King.

# Creating a Template and Binding Events

This article explains two separate steps that merchants often mix up:

* **Creating a template** writes the message text and sends it to WhatsApp for approval.
* **Binding an event** chooses which customer event (for example, **Order placed**) sends that message.

A template is not used until it is approved and bound to an event or campaign.

## Where to find events

Go to **COD King → Settings → Notifications → Customer notifications**. The **Notification/Event Type** table lists each event with **SMS** and **WhatsApp** checkboxes and a **Preview** column.

![Customer notifications page with the Integrate Your WhatsApp Number button](https://mintcdn.com/codking/ViutZIoCweIz8q5q/images/bw-07-customer-notifications.png?fit=max\&auto=format\&n=ViutZIoCweIz8q5q\&q=85\&s=1958963b7060ec07f232625b68da37b8)

## Step-by-step: review and bind an event

### Step 1: Choose the message language

In **WhatsApp message language**, select the language for the messages your customers receive.

### Step 2: Tick WhatsApp for an event

In the event row, tick the **WhatsApp** checkbox. For example, tick **WhatsApp** on the **Order placed** row to send a confirmation when an order is placed.

![Notification table with SMS and WhatsApp checkboxes and Preview icons](https://mintcdn.com/codking/ViutZIoCweIz8q5q/images/bw-08-notifications-table.png?fit=max\&auto=format\&n=ViutZIoCweIz8q5q\&q=85\&s=7ab2060cee433fae95bc796965b1251a)

1. **WhatsApp message language** dropdown.
2. **SMS** and **WhatsApp** checkboxes. On the **Order placed** row, the WhatsApp box is ticked.
3. **Preview** icons. Click them to see the WhatsApp or SMS message.

### Step 3: Preview the message

Click the WhatsApp **Preview** icon in the event row to review the message before customers receive it.

## Creating a new template

> [!WARNING]
>
> **Needs verification:** The template creation form (fields, variables, supported formats and submission steps) requires a connected WhatsApp Business number. It was not visible in the dev store because no number was connected, so it is not documented here yet. The screens that show a message needs approval are described in [Campaign Management](https://codking.tech/documentation/branded-whatsapp/campaign-management.md).

## Configuration options

| Option | Where | What it does |
| - | - | - |
| WhatsApp message language | Top of Customer notifications | Sets the language of WhatsApp messages |
| SMS checkbox | Event row | Sends the event as an SMS |
| WhatsApp checkbox | Event row | Sends the event as a WhatsApp message |
| Preview icons | Preview column | Shows the WhatsApp or SMS message text |
| WhatsApp Approval Status | Top right of the page | Opens the approval status of your WhatsApp messages |

## Practical example

A merchant wants customers to receive a WhatsApp confirmation after every order. They open **Customer notifications**, tick **WhatsApp** on the **Order placed** row, and use the WhatsApp **Preview** icon to check the text. Next, they open **WhatsApp Approval Status** to confirm the message is approved.

## Verification

* The **Preview** icon shows the message text for the event.
* The **WhatsApp** checkbox stays ticked after you refresh the page.
* **WhatsApp Approval Status** shows the approval state of your messages.

## Troubleshooting

* **You see the Integrate Your WhatsApp Number button.** Your WhatsApp Business number is not connected yet. Click the button and connect the number first. The page also says that the COD King WhatsApp and SMS numbers need no setup.
* **You see a Finish setup banner.** OTP verification or partial payment is turned on, but the COD King app embed is not active in your theme. Open the theme editor, turn on the COD King embed, and click **Save**.

## Important notes and limitations

* Messages sent from COD King's shared number and from your own number follow different setup steps.
* WhatsApp only allows pre-approved messages for campaigns.
* Each sent message is charged. See [Introduction and How It Works](https://codking.tech/documentation/branded-whatsapp/introduction.md) for rates.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.