Skip to main content

How to notify customers using Order Status Template Wati API

Updated yesterday

Summary

The order status template is an interactive message type that lets you update a customer's order status via WhatsApp, even outside the standard 24-hour messaging window. This is especially useful for actions like confirming a past order, sharing shipment updates, or notifying the customer about a status change after charging their card.

By using this endpoint, you can send a structured template message with the updated status of an existing order, identified by a unique reference_id.

How it works

This endpoint sends a WhatsApp message using a pre-approved template that includes order status information. You must include the correct reference_id and specify the new status.

Endpoint

POST /api/v1/order_status_template

Sample Payload

curl --location 'https://mt-dev-gke-server.watiapp.io/103128/api/v1/order_stat
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqd
--header 'Content-Type: application/json' \
--data '{
"phone_number": "918606328257",
"template_name": "order_status_template_yzn_1",
"language_code": "en_US",
"is_broadcast": true,
"reference_id": "yzn-test-6",
"custom_params": [
{
"name": "name"
,
"value": "Madhavan"
}
],
"order": {
"status": "partially_shipped"
}
}
'

Accepted order.status values

You can use any of the following values for the order status:

  • processing

  • partially_shipped

  • shipped

  • completed

  • canceled

💡Tip: You’ll need to have this template approved in your Wati environment before you apply it in the live environment.

How to Create an Order Status Template in Wati

Need to keep your customers updated on their order progress? The Order Status template in Wati makes it easy to send real-time updates. This guide walks you through how to create one quickly.

Follow these steps to set up an Order Status template in Wati:

1. Log in to your Wati account.

2. Go to Broadcasts and click on Your Templates.

3. Select New Template Message.

4. Add a name for your template to help you identify it later.

5. Under Category, select Utility.

6. Choose the language you want to use for this template.

7. Under Select Utility Template, pick Order Status.

8. Enter the body content—this is the main update message your customer will see.

9. When you're done, click Save and Submit.

That’s it! Your Order Status template is now ready to be used in your campaigns.

Did this answer your question?