ZenotiHelp

Configure WhatsApp notification templates

ZTZenoti Docs Team Updated September 4, 2026 6 min readHow-to

Zenoti integrates with Twilio to deliver WhatsApp notifications. All WhatsApp messages from your organization are sent through Twilio, and templates require approval before messages can be sent. Unlike email and SMS templates that you can edit and send immediately, WhatsApp templates must be submitted for provider approval and cannot be used until they are approved. This article explains how to create, submit, and manage WhatsApp notification templates.

Before you begin

  • Your organization must have WhatsApp configured with Twilio as the provider. Under Provider, select Twilio. All WhatsApp messages are sent through Twilio, and when Twilio is the provider the message template must be approved by Twilio.
  • You need administrator access at the organization level.
  • WhatsApp communication credits must be active for your organization.
  • Familiarize yourself with the available macros before creating templates. See Configure notification template macros.

Permission: Edit under Organization is required for WhatsApp template management.

To manage WhatsApp templates:

  1. Navigate to Configuration > Notifications.
  2. Open the Notification center section.
  3. Select WhatsApp Templates from the template management area.

Template categories

WhatsApp templates are classified into three categories that affect approval requirements and delivery behavior:

  • Marketing — promotions, campaigns, and birthday messages. Marketing templates are subject to stricter approval criteria and opt-in requirements.
  • Utility — appointment confirmations, invoice receipts, and other business-critical transactional notifications tied to an existing interaction.
  • Authentication — one-time passwords and account-verification codes.

Select the appropriate category when creating a template. Selecting the wrong category can cause Meta to reject the template during the approval process.

Consent macro: The [WhatsAppConsent] macro renders a guest-consent confirmation link in WhatsApp messages. See Configure notification template macros for the macro definition.


Create a WhatsApp template

  1. Navigate to the WhatsApp Templates management page.
  2. Select Add new template.
  3. Enter a template name that describes the notification purpose.
  4. Select the template category (Marketing, Utility, or Authentication).
  5. Configure the header (see header types below).
  6. Write the template body using plain text. Insert macros using the [MacroName] bracket notation to personalize the message.
  7. Add buttons if needed (see the buttons section below).
  8. Select Submit for approval to send the template to WhatsApp for review.

Header types

Each WhatsApp template can include one header type at the top of the message.

Header type Description
Text A plain text header line displayed above the message body
Image An image attachment displayed as the header
Video A video attachment displayed as the header
Document A document attachment (such as a PDF) displayed as the header
None No header. The message starts directly with the body content.

Select the header type based on your notification content. For appointment confirmations, a text header is usually sufficient. For gift card purchases, an image header with the gift card design can enhance the message.


Quick reply and action buttons

WhatsApp templates support interactive buttons that let recipients take action directly from the message.

Quick reply buttons

You can add up to three quick reply buttons to a template. Quick reply buttons display predefined response options that the recipient can tap. For example, an appointment confirmation template might include Confirm and Reschedule quick reply buttons.

Action buttons

Action buttons link to external resources:

  • Phone number button — adds a tap-to-call button with a configured phone number.
  • URL button — adds a button that opens a web link. You can use macros in the URL, such as [ConfirmLink] or [GuestPaymentLink].

Template approval workflow

WhatsApp requires all templates to be approved before they can be used to send messages. The approval process works as follows:

  1. Submit — you create the template in Zenoti and submit it for approval. The template status changes to Pending review.
  2. Provider review — when Twilio is the provider, the template must be approved by Twilio; templates are reviewed by Meta and approval takes 48 hours. Plan template submissions ahead of any time-sensitive campaign.
  3. Approved — the template passes review and becomes available for use in notifications. You can now assign it to notification types in the notification center.
  4. Rejected — the template does not meet WhatsApp messaging policies. Review the rejection reason, update the template content, and resubmit.

Templates that are rejected can be edited and resubmitted. Common rejection reasons include using prohibited content, missing required business information, or selecting an incorrect template category.

Important: WhatsApp templates cannot be used to send messages until they reach Approved status. Do not assign a pending or rejected template to a notification type.


What approval does not guarantee

Template approval confirms that the template content meets WhatsApp's policies. It does not guarantee that every individual message sent using that template will be delivered.

After a template is approved, individual messages can still be blocked by the messaging platform. When a message is blocked, the platform does not disclose the reason for the block. Possible causes include the recipient's device settings, carrier restrictions, or platform-level filtering that operates independently of template approval status.

When a message fails to send, Zenoti may surface a variable-content error alongside the failed send record. This error indicates that the message content — including the values substituted for macros at send time — did not pass the platform's delivery check for that specific message. The error does not mean the template itself has been revoked or needs to be resubmitted.

If you observe a pattern of failed sends after a template is approved:

  • Check the guest's profile to confirm their WhatsApp opt-in status is active.
  • Review the guest's Notifications tab (the Sent, Pending, and Failed views) to identify whether the failure is isolated to one guest or affects multiple guests.
  • Verify that the macro values substituting into the template at send time are populated and valid — empty or malformed macro values can trigger variable-content errors.
  • If failures are widespread across multiple guests and templates, contact Zenoti Support to investigate whether a platform-level issue is affecting your organization's WhatsApp channel.

Note: The approval status of a template in Zenoti reflects the provider's last known decision. A template showing Approved can still produce failed sends for individual messages due to platform-side filtering that occurs at delivery time, not at approval time.


Assign a template to a notification type

After a WhatsApp template is approved:

  1. Navigate to the Notification center in notification settings.
  2. Select the notification type you want to configure (for example, Appointment Confirmation).
  3. Enable the WhatsApp channel for that notification type.
  4. Select the approved WhatsApp template from the template dropdown.
  5. Select Save.

The notification type now uses the approved WhatsApp template when delivering messages through the WhatsApp channel.

Tips

  • Write clear, concise template body content. WhatsApp has stricter content guidelines than email, and overly promotional language in transactional templates can cause rejection.
  • Submit templates well in advance of when you need them. Allow 48 hours for the Meta approval process.
  • When a template is rejected, read the rejection reason carefully. The most common fix is adjusting the category or removing promotional language from transactional templates.
  • Use quick reply buttons for appointment confirmations so guests can confirm or reschedule with a single tap.
  • Monitor your WhatsApp credit usage in the credit usage dashboard to ensure you have sufficient credits for your messaging volume.
  • Do not treat an Approved template status as a guarantee of delivery. Monitor the Failed view on the guest's Notifications tab to catch post-approval delivery issues early.

Template limits

WhatsApp template content is bound by Meta-API constraints, which the Zenoti template editor passes through. Plan template content within these limits:

Component Limit Notes
Header (text) 60 characters Use a short, descriptive header. Image, video, and document headers have separate Meta-API limits.
Body 1024 characters Plan for variable expansion when macros are substituted at send time.
Footer 60 characters Use the footer for short legal or contact-information text.
Quick-reply buttons Up to 3 per template Buttons must be short, action-oriented labels.
URL buttons Up to 2 per template URLs must be HTTPS and use approved domains.
Approval SLA 48 hours (Meta) See "Approval workflow" above.
Was this article helpful?
Your feedback helps us improve our documentation.