Whatsapp Message Templates

You can manage your WhatsApp message templates either programmatically using the Telnyx APIs or on your Facebook Business Manager account. On this page, we will elaborate on both the methods.

Programatically you can use the endpoints listed on the endpoint documentation, Those templates will be associated with your Telnyx whatsapp business account.

WhatsApp Message Types

WhatsApp allows businesses to send two types of messages, Template messages and Session messages.

Session Messages - Are any messages sent and received in response to a user initiated message. A messaging session starts when a user sends your application a message, and lasts for 24 hours since the most recently received message.

Template Messages - Are pre-approved templates for outbound notifications, like appointment reminders. A business application must send a templated message when it is outside of the 24 hours window since the last message from the user to your app.

Take a look at the example below:

WhatsApp Message Types

Message Template Approval

To receive pre-approval for a message template, businesses must submit information on their WhatsApp business account with the following steps:

Note: WhatsApp requires brands to receive customer opt-in before sending messages on WhatsApp.

  1. Open WhatsApp Manager in Business Manager.
  2. Click Message Templates.
  • If you have multiple WhatsApp business accounts, use the drop down menu to select the account where you want to create a message template.
  • WhatsApp restricts marketing/promotional use cases, and will not approve templates with promotional content.
  1. Click Create Message Template.

WhatsApp Message Template preview

A preview of what a Message Template looks like.

  1. Choose your category, name, and language.
  • Category: Choose which type of template you'd like to create. You can hover over the template types to view details for each template.
  • Name: Enter name of the template in lowercase letters, numbers, and underscores only.
  • Language: Choose which languages your message template will include. You can delete or add more languages in the next step.
  1. Add your content. You can add an optional sample template by clicking the Add Sample button. This helps Facebook during the review and approval process, so they can understand what kind of message you plan to send. Please do not include any private or personal information in these examples.
  • Header: Use text or media for an optional header.
  • Body: Add the content of your message here. You can edit text formats, add emojis, or include variables, which allow a developer to add unique information such as specific names, locations, or tracking numbers when inputting the templates into the API. The variables are shown in the above example as {{1}} and {{2}}.
  • Footer: Add a short line at the bottom of your message.
  • Buttons: Add a Call to Action or Quick Reply button to let your customers quickly respond to your message or take an action.
    • Call to Action buttons, include options such as “Call Now” or “Visit our Website.” This lets you add a phone number or website URL to your message. You can choose from a Static (fixed) website URL or a Dynamic website URL, which creates a personalized link for the customer to view their specific information on your website by adding a variable at the end of the link.
    • Quick Reply buttons allow people to choose from up to 3 options, such as “Yes,” “No," or "Maybe."
  1. When completed, click Submit.

  2. Your template will now be sent for review. The status of your template is viewable under Message Templates.

Was this page helpful?