InboxChatMessages

Template Messages

Pre-approved WhatsApp message templates with media and carousels

Template messages are WhatsApp-specific pre-approved message formats required for initiating conversations or sending messages outside the 24-hour messaging window.

Template message

Structure

A WhatsApp template message can contain:

ComponentDescription
HeaderOptional media (image, video, document) or text
BodyMain message text with variable placeholders
FooterOptional footer text
ButtonsQuick reply or call-to-action buttons

Header Types

TypeDescription
TextStatic or variable text header
ImageHeader image
VideoHeader video
DocumentAttached document (PDF, etc.)
LocationMap location header
ProductProduct card from catalog

Carousel templates contain multiple slides, each with its own media, text, and buttons:

  • Horizontal scrollable carousel
  • Each slide can have image/video, body text, and buttons
  • Rendered using an Embla Carousel component in the inbox
  • Users swipe through slides
Carousel template

Button Types on Templates

ButtonAction
Quick ReplySends a predefined response
URLOpens a link (can include variables)
PhoneDisplays a phone number to call
Copy CodeCopies a code to clipboard

Template Badge

Template messages display a Template badge to distinguish them from regular messages. The header type is indicated with a color-coded icon.

Sending Templates

To send a template message from the inbox:

  1. Click the attachment menu (📎) in the editor
  2. Select WhatsApp Template
  3. Choose a template from the template selector modal
  4. Fill in any variable values
  5. Send

Templates must be pre-approved by WhatsApp/Meta before they can be used. Manage your templates in the WhatsApp Business Manager.

On this page