Templates Overview

Design, synchronize, and manage Meta-approved WhatsApp Business message templates in Sayvy AI

Templates API

The Templates API enables you to programmatically create, manage, synchronize, and deploy WhatsApp Business message templates. In the WhatsApp Business ecosystem, outbound broadcasts must utilize pre-approved structured templates containing verified header, body, footer, and interactive button components.

Sayvy AI offers a two-tier template management system:

1. Custom Templates API: Create and register bespoke templates directly on Meta Graph API and track their approval lifecycles.
2. Meta Template Library API: Browse Meta’s curated catalog of pre-approved global industry templates and provision them to your WhatsApp Business Account (WABA) instantaneously.

+-------------------------------------------------------------+
|               WhatsApp Message Template Lifecycle           |
|                                                             |
|   +-----------------------+     +-----------------------+   |
|   |   Custom Template     |     |  Meta Library Catalog |   |
|   | (Header/Body/Buttons) |     | (Pre-approved design) |   |
|   +-----------+-----------+     +-----------+-----------+   |
|               \                             /               |
|                v                           v                |
|              +-------------------------------+              |
|              |   Meta Graph API Submission   |              |
|              |      (v19.0 WABA Gateway)     |              |
|              +---------------+---------------+              |
|                              |                              |
|                              v                              |
|              +-------------------------------+              |
|              |     Automated Review State    |              |
|              |  (PENDING -> APPROVED/REJECT) |              |
|              +---------------+---------------+              |
|                              |                              |
|                              v                              |
|              +-------------------------------+              |
|              |   Sayvy AI Local Database     |              |
|              | (Sync & Campaign Orchestration)|             |
|              +-------------------------------+              |
+-------------------------------------------------------------+

---

Key Capabilities

Direct Meta Submission

Submit custom marketing, utility, and authentication templates directly to Meta Graph API v19.0.

Pre-Approved Template Library

Query Meta’s global message template library by industry, topic, language, and use case for instant adoption.

Bi-Directional Synchronization

Sync existing approved templates from your WhatsApp Business Account directly into Sayvy AI’s database.

Quality Score Monitoring

Track template health, recipient feedback flags, and quality status scores (GREEN, YELLOW, RED).

---

Template Structure & Components

WhatsApp message templates are composed of modular components:

Component Type	Description	Permitted Formats
HEADER	Optional leading element displayed at the top of the message	TEXT (with single variable), IMAGE, VIDEO, DOCUMENT
BODY	Mandatory main text containing placeholders ({{1}}, {{2}})	Plain text up to 1,024 characters with indexed variable parameters
FOOTER	Optional muted footer text at the bottom	Plain text up to 60 characters (no variables)
BUTTONS	Optional interactive actionable elements	QUICK_REPLY (canned responses), URL (web links), PHONE_NUMBER

---

Template Categories

Meta strictly classifies all templates into three distinct pricing and delivery categories:

1. MARKETING: Promotional offers, product announcements, newsletters, and lead engagement messages.
2. UTILITY: Account updates, order confirmations, billing notifications, and appointment reminders.
3. AUTHENTICATION: One-time passwords (OTP) and two-factor verification codes with auto-fill or copy-code actions.

---

Review & Operational Lifecycles

Status	Meaning	Can Broadcast?
PENDING	Under automated or manual review by Meta	No
APPROVED	Approved and ready for immediate campaign dispatching	Yes
REJECTED	Did not meet Meta Business or Commerce Policies	No
PAUSED	Halted by Meta due to poor user quality feedback	No

---

Available Endpoints

Custom Templates

Method	Endpoint	Description
POST	/api/v1/templates	Create a new template locally and submit to Meta
GET	/api/v1/templates	List paginated templates for your organization
GET	/api/v1/templates/{template_id}	Retrieve single template details and components
DELETE	/api/v1/templates/{template_id}	Delete a template locally and on Meta
POST	/api/v1/templates/sync	Sync all templates from Meta for a specific channel

Templates Library

Method	Endpoint	Description
GET	/api/v1/templates/library	Search and browse pre-approved templates from Meta’s library
POST	/api/v1/templates/library/{template_id}/create	Provision an official library template for your WABA

---

‹ Previous

Create template

POST /api/v1/templates

Next ›