Create a template

Explanation

Template messages need to get approval by WhatsApp (Meta) before you can start using them.

This API will guide you on submitting a new template.'

Create a Utility and Marketing template

(If you wish to create authentication template, please scroll down to the last part of this page.)

Remarks

• If the template body is too general, it will not be approved.

• You can use variables in this way: {{1}} and {{2}} and so on (up to 10 variables). this variables can be later set by you when you send the template to your clients.

• A variable can be used only once inside the body. it means that if you used {{1}} somewhere in your body, you should not use {{1}} again.

• You must have a reasonable number of variables compared to the rest of the text. Usually for every variable you need at least 3 words in your body. For example: if you have 5 variables, make sure the rest of the body has at least 15 words.

• It usually takes up to 1 hour for a template to change status to be approved or rejected. you can't edit a rejected template, you must submit a new one with a new name.

• Template name must be unique. If you delete a template, you can't use the same name for 30 days.

• Template name must be lower case, English letters and numbers only. no spaces.

• A template can contain more than just text. it can also have image/document/video as part of the template.

• You can have up to 6000 templates in your account.

• quick reply buttons must not contain variables, new lines, Emoji or any design symbols

• A template can contain buttons for quick actions. You can have website / call / coupon / quick reply buttons, under those limitations:

  • A template can have a maximum of 10 buttons of all kinds.

  • You can have maximum of 1 'Call' button.

  • You can have maximum of 2 'Website' buttons.

  • You can have maximum of 10 'Quick reply' buttons.

  • You can have a maximum of 1 'Coupon' button.

• If you wish to create a template that you will not be able to delete it after (an important template you wish to protect against accident delete) use this as the start of the template name: "reserved_".

• The body of the template can't start with a variable and cant end with a variable.

Endpoint:

Template setup:

Each template needs to have a name and a language.

Template structure:

Each template contains 4 parts:

• header (media is optional).

• body (mandatory).

• footer (optional).

• buttons (optional).

For the 'body' part, you can also use the following markups:

Buttons setup:

if you wish to use buttons, you need to choose between "call to action" or "quick reply" or using both.

• call to action is a button that triggers an action. we have two types: url (which triggers website open with the phone's browser) and call (which makes a regular phone call to a number). you can use up to 1 call button and 2 website buttons in your template.

• quick reply is a button that allows the user to click on it and return back webhook about the button text that was clicked. for example, a button name "sales" will return to your webhook url a reply saying that "sales" was clicked, so you can build your flow scenario according to that. you can have up to 10 buttons of quick reply type.

• remember! total of 10 buttons is allowed from the two kinds.

Full Request

Full example 1:

here is an example of full template request. the request template is in English. 

The template contains:

• no header.

• body with 6 variables.

• no footer.

• 2 websites, 1 call button.

• 5 buttons of "quick reply".

{
"apiKey": "your-api-key",
"from": "972501234567",
"name": "website_welcome",
"language": 2,
"header": 1,
"body": "*Hello {{1}}* and thank you for joining our exclusive website store!\nOur company has many secrets to discover.\nFor future connection, we received your phone number: {{2}} and your email address: {{3}}.\nYou can find shirts, hats, shoes and gloves at discounted prices. Hold on, wait a minute, i found something interesting! just for this week we offer: {{4}} at discounted price: {{5}} only when you buy it online or in-store shop at: {{6}}.\nWhat would you like to discover?",
"buttons": 4,
"callToAction": 4,
"callToActionWebsiteText": "Our Website",
"callToActionWebsiteType": 1,
"callToActionWebsiteURL": "https://www.example.com",
"callToActionWebsiteText2": "Our second website",
"callToActionWebsiteType2": 1,
"callToActionWebsiteURL2": "https://www.example-second-website.com",
"callToActionCallText": "Click to call us",
"callToActionCallNumber": "+972522222222",
"quickReply1": "Shirts",
"quickReply2": "Hats",
"quickReply3": "Shoes",
"quickReply4": "Gloves",
"quickReply5": "Something else"
}

The template submission will look like this:

When you send the template to your client, you need to fill the {{1}}, {{2}}, {{3}}, {{4}}, {{5}} and {{6}}.

Full example 2:

here is a sample of full template request. the request is appointment update template, in English.

the template contains:

• image header

• body with 2 variables

• footer

• buttons: call to action (one website + one call button)

{
"apiKey": "your-api-key",
"from": "972501234567",
"name": "friday_appointment_reminder",
"language": 2,
"header": 2,
"body": "*Hello {{1}}* we would like to remind you for the appointment you have with us on {{2}}. \n please arrive with your ID card.",
"footer": "Our address: 51D street.",
"buttons": 2,
"callToAction": 3,
"callToActionWebsiteText": "Click for navigation",
"callToActionWebsiteType": 1,
"callToActionWebsiteURL": "https://waze.com/ul",
"callToActionCallText": "Call Us",
"callToActionCallNumber": "+972779111111"
}

The template submission will look like this:

Full example 3:

here is a sample of full template request. the request is payment update template, in English.

the template contains:

• document header

• body with 2 variables

• no footer

• buttons: call to action (dynamic website)

  
  

{
"apiKey": "your-api-key",
"from": "972501234567",
"name": "payment_reminder_1",
"language": 2,
"header": 4,
"body": "*Dear {{1}}*\n your invoice for December 2021 is attached. Total amount is {{2}} USD. \n Please pay as soon as you can. \n The invoice is due in a week. 💳",
"buttons": 2,
"callToAction": 1,
"callToActionWebsiteText": "Click to pay",
"callToActionWebsiteType": 2,
"callToActionWebsiteURL": "https://paypal.com/"
}

The template submission will look like this:

Full example 4:

here is a sample of full template request. the request is transportation update template, in English.

the template contains:

• no header

• body with no variables

• footer

• no buttons

{
"apiKey": "your-api-key",
"from": "972501234567",
"name": "the_bus_is_coming",
"language": 2,
"header": 1,
"body": "*Dear NetBus user*\n Your bus is on its way. \n stay sharp. 🚍🚍🚍🚍",
"footer": "The wheels on the bus go round and round",
"buttons": 1
}

The template submission will look like this:

Full example 5:

here is a sample of full template request in English. the request is weekend sale with coupon code

the template contains:

• no header

• body with 2 variables

• 1 website button (static website)

• 1 phone button

• 1 coupon code button with expiration time.

{
"apiKey": "your-api-key",
"from": "972501234567",
"name": "weekend_sale",
"language": 2,
"header": 1,
"body": "*Hello {{1}}*\n We value our VIP clients very much and would like to offer you {{2}} off for the weekend sale only!",
"buttons": 2,
"callToAction": 3,
"callToActionWebsiteText": "Click here for more",
"callToActionWebsiteType": 1,
"callToActionWebsiteURL": "https://www.amazon.com/store/",
"callToActionCallText": "Call Us",
"callToActionCallNumber": "+9725011223344",
"useCoupon": 1,
"couponTitle": "Weekend Sale!",
"couponExpiration": 1
}

The template submission will look like this:

(The 'Copy offer code' text is fixed and can't be changed, each template language will show the relevant translation. when the user clicks on it, it will copy the code. when sending the template, the expiration will show the relevant timer).

Response:

"status": "OK",
"name": "template name",
"timestamp": 1710861707,
"body": "The body text you wrote",
"category": 1,
"reason": 1

Response-Explain:

Create an Authentication template

Authentication code template is a different kind of template you can create.

It is still a template, but its different than the regular template creation and it doesn't contain the normal structure: header,body,footer,buttons.

Authentication code template is OTP, one time password code that you can send to your clients over WhatsApp. it looks like this:

Remarks

• The template text is fixed and can't be changed (per language).

• The "Copy code" button is fixed and can't be changed (per language).

• The template will have "copy code" that will copy the code from WhatsApp for easy usage.

• You can only create authentication template is your daily limit is 1000 or more.

• The authentication template , when sending it, can only be visible from a mobile phone. if the WhatsApp Web is used by your client, the template message with the code will not be visible for him.

  
  

Endpoint (same as regular template creation):

Body:

Each template needs to have a name and a language.

Response:

"status": "OK",
"name": "template name",
"timestamp": 1710861707,
"category": 3,
"reason": 1

Response-Explain: