Skip to main content

​
What are Templates?

Templates are pre-approved message models by Meta for sending via WhatsApp Business API (Gupshup). They are required to initiate conversations or re-engage leads after the 24-hour window.

Marketing

Promotions, news, and campaigns

Utility

Transactional notifications, confirmations, reminders

​
How It Works

1

Create template in Gupshup

Configure the template in the Gupshup dashboard with desired components (header, body, footer, buttons).
2

Wait for Meta approval

Templates must be approved by Meta before use. Possible statuses: APPROVED, PENDING, REJECTED.
3

Sync with Leavo

The meta-service automatically syncs approved templates with Leavo.
4

Use in cadences and follow-ups

Associate templates with cadence steps or configure follow-ups with official templates.

​
Template Model

{
  "id": "uuid",
  "tenant_id": "uuid",
  "gupshup_app_id": "app_12345",
  "template_name": "welcome_v1",
  "template_id": "gupshup_template_id",
  "language": "en",
  "status": "APPROVED",
  "category": "MARKETING",
  "components": [
    {
      "type": "HEADER",
      "format": "TEXT",
      "text": "Welcome, {{1}}!"
    },
    {
      "type": "BODY",
      "text": "Hello {{1}}, thanks for signing up at {{2}}. We're ready to help!"
    },
    {
      "type": "FOOTER",
      "text": "Leavo - Smart automation"
    }
  ],
  "last_synced_at": "2024-01-15T10:00:00Z",
  "created_at": "2024-01-15T10:00:00Z"
}

​
Template Status

StatusDescription
APPROVEDApproved by Meta, ready to use
PENDINGAwaiting Meta review
REJECTEDRejected by Meta (needs adjustment)
Only templates with APPROVED status can be used in cadences and follow-ups.

​
Categories

CategoryUse
MARKETINGPromotions, offers, engagement
UTILITYConfirmations, reminders, updates
AUTHENTICATIONVerification codes, login

​
Endpoints

MethodEndpointDescription
GET/backend/templatesList templates
GET/backend/templates/{id}Get template
DELETE/backend/templates/{id}Delete template
POST/backend/templates/syncSync templates from Gupshup