Developer API Integration Documentation

1. Authentication

All API requests must be secure and authenticated using a Bearer token in the request header. Generate your permanent access tokens inside the A to Z Developer console dashboard panel.

Authorization: Bearer YOUR_PERMANENT_ACCESS_TOKEN
Content-Type: application/json

2. Send Text Message (POST /messages)

Trigger standard text messages to qualified clients. The recipient's phone number must contain the country code without spaces or '+' symbols.

curl -X POST https://api.atozmarketingkit.in/v1/messages \
  -H "Authorization: Bearer ea8271a0fd8721c8901" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "919876543210",
    "type": "text",
    "text": {
      "body": "Hello! This is a secure notification sent via AtoZ Developer API node."
    }
  }'

3. Send Template Message (POST /messages)

To start a conversation with a customer, you must use a pre-approved template message. Map variables dynamically using parameters inside the components object.

curl -X POST https://api.atozmarketingkit.in/v1/messages \
  -H "Authorization: Bearer ea8271a0fd8721c8901" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "919876543210",
    "type": "template",
    "template": {
      "name": "order_confirmation",
      "language": { "code": "en" },
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "Rahul Sharma" },
            { "type": "text", "text": "#ORDER-9281A" }
          ]
        }
      ]
    }
  }'

4. Webhook Incoming Message Payload

When a customer replies to your number, Meta sends a POST webhook request to your configured server endpoint. Parse the JSON payload to route answers.

{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "1009848192019",
    "changes": [{
      "value": {
        "messaging_product": "whatsapp",
        "metadata": { "display_phone_number": "917982506651" },
        "contacts": [{ "profile": { "name": "Rahul" }, "wa_id": "919876543210" }],
        "messages": [{
          "from": "919876543210",
          "id": "ABGG5xF9_9281a",
          "timestamp": "1781023164",
          "text": { "body": "I need help with my booking billing" },
          "type": "text"
        }]
      },
      "field": "messages"
    }]
  }]
}