Open SidemenuDocs
Docs
Close Sidemenu

Creating WhatsApp Message Templatecreating-whatsapp-message-template

WhatsApp Message Typeswhatsapp-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 Approvalmessage-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. 1Open WhatsApp Manager in Business Manager.Telnyx Developers
  2. 2Click 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. 3Click Create Message Template.

WhatsApp Message Template preview

A preview of what a Message Template looks like.

  1. 4Choose 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. 5Add 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}}. Visit the Creating Message Templates Developer DocumentTelnyx Developers for more information.
  • 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. 6When completed, click Submit.
  2. 7Your template will now be sent for review. The status of your template is viewable under Message Templates. After your message has been approved, you can work with your developer to input your message templates into the API by referring to the Sending Message Templates Developer Document.Telnyx Developers

Was this page helpful?