Messages API

    Send WhatsApp messages with ease

    Messages API

    v2.0Simplified

    Send WhatsApp messages with just phone numbers and template names. No IDs required!

    Base URL

    https://zaptick.io/api

    Send Template Message (Super Simple!)

    ⚡ New

    Our simplified API makes sending template messages incredibly easy. Just provide a phone number and template name - we automatically handle contact lookup, template ID resolution, WABA selection, and wallet deduction!

    ✨ What Makes It Simple:

    ✅ No contact ID needed - just phone number
    ✅ No template ID needed - just template name
    ✅ Auto contact creation if doesn't exist
    ✅ Auto WABA selection (uses active account)
    ✅ Auto wallet deduction
    ✅ Clear error messages
    POST/api/send

    📋 Example 1: Simple Template (No Variables)

    Request
    curl -X POST https://zaptick.io/api/send \
  -H "X-API-Key: zaptick_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+919876543210",
    "templateName": "welcome_message"
  }'

    📝 Example 2: Template with Variables

    Request
    curl -X POST https://zaptick.io/api/send \
  -H "X-API-Key: zaptick_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+919876543210",
    "templateName": "order_update",
    "variables": {
      "1": "John Doe",
      "2": "#ORD-12345",
      "3": "March 25, 2024"
    }
  }'

    📄 Example Template Body:

    Hi {{1}},
    Your order {{2}} will be delivered on {{3}}.
    Thank you for shopping with us!

    💰 Example 3: Payment Reminder

    Request
    curl -X POST https://zaptick.io/api/send \
  -H "X-API-Key: zaptick_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+917499247072",
    "templateName": "payment_reminder",
    "variables": {
      "1": "Lisa",
      "2": "INV-2024-001",
      "3": "299.00",
      "4": "March 15, 2024"
    }
  }'

    ✅ Success Response

    {
  "success": true,
  "message": "Template message sent successfully",
  "data": {
    "whatsappMessageId": "wamid.HBgNOTE5ODc2...",
    "phone": "+919876543210",
    "templateName": "order_update",
    "contactId": "contact_abc123",
    "wabaId": "waba_xyz789"
  }
}

    📚 Request Parameters

    phonerequired

    Recipient's phone number with country code (e.g., +919876543210)

    templateNamerequired

    Name of your approved template (case-sensitive)

    variablesoptional

    Object with variable numbers as keys ({"1": "value1", "2": "value2"})

    Supported Template Types

    This API supports ALL WhatsApp template types. Just provide the template name - we handle the rest!

    ✅ Text Templates

    • • Simple text messages
    • • Text with variables
    • • Formatted text (*bold*, _italic_)

    🔘 Templates with Buttons

    • • Quick Reply buttons
    • • URL buttons (static or dynamic)
    • • Phone Call buttons

    📸 Templates with Media

    • • Image headers
    • • Video headers
    • • Document headers (PDF, DOC)

    🎠 Carousel Templates

    • • Swipeable product cards
    • • Up to 10 cards
    • • Each with image & buttons

    🔒 Authentication Templates

    • • OTP codes
    • • One-tap copy button
    • • Auto-fill support

    ⏰ Limited-Time Offer

    • • Countdown timers
    • • Expiration dates
    • • Promotional offers

    ❌ Common Errors & Solutions

    Template not found

    ✓ Check spelling (case-sensitive) • ✓ Ensure template is APPROVED • ✓ Wait 10min after approval

    Insufficient wallet balance

    ✓ Recharge wallet at zaptick.io/wallet • Message cost varies by country

    Invalid phone number

    ✓ Include country code (+919876543210) • ✓ Remove spaces • ✓ Must be WhatsApp-enabled

    Missing variables

    ✓ Count placeholders in template ({{1}}, {{2}}...) • ✓ Provide all required variables

    Ready to start sending messages?

    Generate your API key and start building amazing WhatsApp integrations today.