Marketting Lite API

Overview

The Marketing Lite API allows businesses to send WhatsApp marketing template messages such as promotions, offers, announcements, and campaign notifications. These messages must use pre-approved templates and comply with WhatsApp business messaging policies

Marketing templates are typically used for:

• Promotional campaigns
• Product announcements
• Offers and discounts
• Event invitations
• Business updates

Pre-approved templates ensure non-spam communication and require user opt-in before sending promotional messages.

Endpoint

POST https://app.pingtochat.com/api/v1.0/{phone_number_id}/{api_key}/marketing_messages

HTTP Method

POST

---

📌 Headers

Header	Value	Description
Content-Type	application/json	Request format
Authorization	Bearer <access_token>	API authentication

Request Body Example

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "919XXXXXXXXX",
  "type": "template",
  "template": {
    "name": "marketing_template_name",
    "language": {
      "code": "en"
    }
  }
}

Request Parameters

Parameter	Type	Required	Description
messaging_product	string	Yes	Always “whatsapp”
recipient_type	string	Yes	Usually “individual”
to	string	Yes	Recipient phone number with country code
type	string	Yes	Template message type
template.name	string	Yes	Approved template name
template.language.code	string	Yes	Template language

Template Components

1️⃣ Header (Optional)

• Text / Image / Video / Document
• Used for attention-grabbing content

2️⃣ Body (Required)

• Main marketing message content

3️⃣ Footer (Optional)

• Extra info, disclaimers, contact details

4️⃣ Buttons (Optional)

• Quick reply
• Website link
• Phone call button
• Copy code button

Success Response Example

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "91xxxxxxxxxx",
      "wa_id": "91xxxxxxxxxx",
      "status_id": "NTg0MTI="
    }
  ],
  "messages": [
    {
      "id": "phoSwcGtbL",
      "message_status": "accepted"
    }
  ]
}

Common Error Responses

Status	Meaning
400	Invalid request
401	Authentication failed
403	Template not approved
500	Server error