Templates

WhatsApp message templates are pre-approved message formats that can be sent outside the 24-hour messaging window. Templates must be approved by Meta before use.

Template Model

Field	Type	Description
id	integer	Unique template ID
name	string	Template name (lowercase, underscores)
language	string	Language code (ar, en_US, etc.)
category	string	MARKETING, UTILITY, AUTHENTICATION
status	string	Approval status
body_json	object	Template body and parameters

Template Statuses

Status	Description
PENDING	Submitted, awaiting Meta review
APPROVED	Approved and ready to send
REJECTED	Rejected by Meta
PAUSED	Temporarily paused due to quality
DISABLED	Disabled by Meta

Creating Templates

Templates are created and managed from the CubeConnect dashboard under Templates. The dashboard provides a visual editor for:

• Template name and category selection
• Body text with parameter placeholders (1, 2, etc.)
• Header (text, image, video, or document)
• Footer text
• Quick reply buttons or CTA buttons

Using Templates via API

Send templates using the Send Template endpoint:

{
  "phone": "+966501234567",
  "message_type": "template",
  "data": {
    "name": "order_confirmation",
    "params": ["ORD-1234", "500 SAR"]
  }
}

Template Categories

Marketing

• Promotional offers and discounts
• Product announcements
• Event invitations
• Newsletter updates

Utility

• Order confirmations and updates
• Shipping notifications
• Appointment reminders
• Account alerts

Authentication

• Login verification codes (OTP)
• Two-factor authentication
• Email/phone verification

Template Parameters

Parameters are positional placeholders in the template body:

Hello {{1}}, your order {{2}} has been shipped.
Estimated delivery: {{3}}.

• Parameters are numbered starting from 1
• Each parameter maps to the corresponding index in the params array
• Parameters must be provided in order when sending

Template Quality

Meta monitors template quality based on:

• Read rate - Percentage of recipients who read the message
• Block rate - Percentage of recipients who block your number
• Report rate - Percentage of recipients who report the message

Low-quality templates may be paused or disabled. CubeConnect tracks these metrics and updates template statuses via webhook events.

WARNING

Keep your template quality high by:

• Sending templates only to customers who have opted in
• Keeping content relevant and valuable
• Avoiding excessive promotional messaging