Skip to main content

Creating a template

This Doc is under construction

Keep in mind that the information contained here might be incomplete.

Creating a template

On this guide you'll learn what is a template, why do you need one and how you can create your own. Lets get into it!

What is a template and why do you need it

Templates are special kind of messages used to start conversations with contact. When you've never written to that contact before, or their last message to you was sent over 24 hours ago you'll need to use a template message to start the conversation.

If you try to send them anything other than a template message to a contact in those situations, WhatsApp will not deliver that message.

These templates are messages that can be created once and then used for any contact and at any time, since you can set variables to personalize each message. In order to be able to use a template, it must be approved first by WhatsApp. This is a rule they made so they can keep in check spam messages and fraud.

They can also be used with Broadcasts and Flows.

When you create a template in Hilos, we automatically send it to WhatsApp for approval. You'll see after creating its status and we'll automatically check with WhatsApp about all templates' status' every 5 minutes.

Once a contact answers, then you can use any type of message (text, image, document, etc) to keep the conversation going.

Facebook catalogs templates into 3 main categories:

  • Marketing: All messages with the purpose of people knowing about new product offerings and sales.
  • Transactional: All messages with the purpose of updating a customer with the status of its order, shipping, invoice, payment, etc.
  • One time passwords: Everything that has to do with authentication for an app, like 2FA's.

This is important to know because all templates need to be approved by Facebook before they can be used.

Building blocks of a template

A template has 4 sections:

  • Header: Top part of our message, this can be any of the following:
    • Text: The most basic header, this text stands out as it is formatted with bold text, can be customized using a variable but keep in mind that it is limited to 1 variable.
    • Photo: Attach a photo to the top of the message by providing a URL.
    • Video: Send a video to your users by providing a URL, useful for short ads.
    • Document: Send an attachment to your users, handy for sending brochures, invoices or PDF's.
  • Body: The body of our message, use this space to write out your message, this behaves like a normal whatsapp message and is the only required field and can be customized by using variables.
  • Footer: A small text displayed on the bottom of the message in light grey. (Optional)
  • Buttons: You can add buttons to your message to make the user interact with the content, WhatsApp allows us to create 2 types of buttons: (Optional)
    • Call to actions: This buttons contain a link that redirects the user to your site or app to complete an action.
      • Visit website: Useful for redirecting our users to an specific website. They can be customized using variables.
      • Call a number: Help your users contact you easily without having to dial.
    • Quick replies: This buttons allow the user to answer to the message you've sent without having to type, useful for support and chatbots.

Templates are really powerful if used along with Broadcasts, however try to follow best practices so you're not marked as spam.

Creating a template

Now that you know what a template is, we are ready to begin learning how to create one inside Hilos. The first thing we need to do is go to our Hilos Dashboard. And clicking on Templates our sidebar.

Click on Create template

Give your template a name, a category and select the language it will be written in.

Add your desired Header, Body, Footer and Buttons


Pro tip: Use a number surrounded by two pairs of curly braces to indicate the use of a variable. Like this: {{1}} or {{2}}, they'll be replaced by text later on.

Now provide the URL of the photo/video for the header if needed and do a bit of testing with your variables. Once you're happy click Submit.


Warning: The URL you add here IS NOT attached to the template, it's only used for testing purposes, later when you send the template you'll need to provide the URL again.

Your template will now be sent for approval, once it's ready to be used you'll se its status change from Created to Approved.


Please bear in mind that Hilos doesn't have any control over the approval process or its completion time, this is a moderation that Facebook (Meta) does and can take a while to complete. Usually it takes a few minutes for Meta to approve a template, but the official guideline is that it may take up to 2 business days.

Make sure to create them ahead of time!