Messaging API

curl "https://wa.draskenapis.com/messages?page=1&limit=20" \
  -H "x-access-key: $WA_ACCESS_KEY" \
  -H "x-secret-key: $WA_SECRET_KEY"

{
  "statusCode": 200,
  "message": "Success",
  "data": {
    "id": 4821,
    "status": "sent"
  }
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "errors": [
    {
      "field": "to",
      "message": "to should not be empty"
    }
  ]
}

curl -X POST "https://wa.draskenapis.com/messages" \
  -H "x-access-key: $WA_ACCESS_KEY" \
  -H "x-secret-key: $WA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumberId": "109876543210987",
    "to": "447911123456",
    "type": "text",
    "text": "Your order #48210 has shipped and arrives Friday."
  }'

{
  "statusCode": 200,
  "message": "Success",
  "data": {
    "id": 4821,
    "metaMessageId": "wamid.HBgLNDQ3OTExMTIzNDU2FQIAERgSN0YxRDkxQzhBMkI0RDVFNkYA",
    "phoneNumberId": "109876543210987",
    "to": "447911123456",
    "type": "text",
    "status": "sent",
    "createdAt": "2026-08-01T09:24:11.482Z"
  }
}

{
  "phoneNumberId": "109876543210987",
  "to": "447911123456",
  "type": "template",
  "templateName": "order_shipped",
  "templateLanguage": "en_US",
  "templateComponents": [
    {
      "type": "body",
      "parameters": [
        {
          "type": "text",
          "text": "Aanya"
        },
        {
          "type": "text",
          "text": "48210"
        }
      ]
    },
    {
      "type": "button",
      "sub_type": "url",
      "index": "0",
      "parameters": [
        {
          "type": "text",
          "text": "48210"
        }
      ]
    }
  ]
}

{
  "phoneNumberId": "109876543210987",
  "to": "447911123456",
  "type": "template",
  "templateName": "auth",
  "templateLanguage": "en_US",
  "templateComponents": [
    {
      "type": "body",
      "parameters": [
        {
          "type": "text",
          "text": "J$FpnYnP"
        }
      ]
    },
    {
      "type": "button",
      "sub_type": "url",
      "index": "0",
      "parameters": [
        {
          "type": "text",
          "text": "J$FpnYnP"
        }
      ]
    }
  ]
}

{
  "phoneNumberId": "109876543210987",
  "to": "447911123456",
  "type": "image",
  "mediaUrl": "https://cdn.example.com/receipts/48210.jpg",
  "caption": "Your receipt"
}

{
  "phoneNumberId": "109876543210987",
  "to": "447911123456",
  "type": "location",
  "latitude": 19.076,
  "longitude": 72.8777,
  "locationName": "Drasken Labs",
  "locationAddress": "Bandra Kurla Complex, Mumbai"
}

{
  "phoneNumberId": "109876543210987",
  "to": "447911123456",
  "type": "interactive",
  "interactiveType": "button",
  "interactiveBodyText": "Your order is ready. How would you like it?",
  "interactiveButtons": [
    {
      "id": "deliver",
      "title": "Deliver"
    },
    {
      "id": "collect",
      "title": "Collect in store"
    }
  ]
}

{
  "phoneNumberId": "109876543210987",
  "to": "447911123456",
  "type": "interactive",
  "interactiveType": "list",
  "interactiveBodyText": "Pick a delivery slot.",
  "interactiveButtonLabel": "View slots",
  "interactiveSections": [
    {
      "title": "Tomorrow",
      "rows": [
        {
          "id": "slot_am",
          "title": "Morning",
          "description": "09:00 – 12:00"
        },
        {
          "id": "slot_pm",
          "title": "Afternoon",
          "description": "13:00 – 17:00"
        }
      ]
    }
  ]
}

{
  "statusCode": 200,
  "message": "Success",
  "data": [
    {
      "id": 4821,
      "metaMessageId": "wamid.HBgLNDQ3OTExMTIzNDU2FQIAERgSN0Yx",
      "phoneNumberId": "109876543210987",
      "to": "447911123456",
      "type": "text",
      "status": "delivered",
      "createdAt": "2026-08-01T09:24:11.482Z",
      "updatedAt": "2026-08-01T09:24:14.901Z"
    }
  ],
  "meta": {
    "total": 1284,
    "totalPages": 65,
    "page": 1,
    "limit": 20
  }
}

{
  "statusCode": 200,
  "message": "Success",
  "data": {
    "id": 4821,
    "metaMessageId": "wamid.HBgLNDQ3OTExMTIzNDU2FQIAERgSN0Yx",
    "phoneNumberId": "109876543210987",
    "to": "447911123456",
    "type": "text",
    "status": "read",
    "createdAt": "2026-08-01T09:24:11.482Z",
    "updatedAt": "2026-08-01T09:31:02.117Z",
    "payload": {
      "messaging_product": "whatsapp",
      "recipient_type": "individual",
      "to": "447911123456",
      "type": "text",
      "text": {
        "body": "Your order #48210 has shipped."
      }
    }
  }
}

{
  "id": 4817,
  "metaMessageId": "wamid.HBgMOTE5OTU4OTA2MDM1FQIAERgSODkx",
  "phoneNumberId": "109876543210987",
  "to": "447911123456",
  "type": "text",
  "status": "failed",
  "error": {
    "code": 131047,
    "title": "Re-engagement message",
    "detail": "Message failed to send because more than 24 hours have passed since the customer last replied to this number."
  },
  "createdAt": "2026-08-16T06:09:20.840Z",
  "updatedAt": "2026-08-16T06:09:23.841Z"
}

{
  "statusCode": 200,
  "message": "Success",
  "data": {
    "rangeDays": 14,
    "totals": {
      "sent": 1284,
      "delivered": 1268,
      "read": 966,
      "failed": 16,
      "total": 1284
    },
    "deliveryRate": 0.987,
    "readRate": 0.762,
    "series": [
      {
        "date": "2026-07-19",
        "delivered": 84,
        "failed": 1
      },
      {
        "date": "2026-07-20",
        "delivered": 91,
        "failed": 0
      }
    ]
  }
}

{
  "id": 84213,
  "event": "inbound_message",
  "wabaId": "220011334455",
  "occurredAt": "2026-08-16T09:12:04.881Z",
  "data": {
    "kind": "inbound_message",
    "title": "Reply received",
    "detail": "Asha: Yes, that works",
    "recipient": "919822010210",
    "messageId": "wamid.HBgMOTE5ODIyMDEwMjEwFQIAEhgUM0E0…",
    "metaField": "messages",
    "raw": {
      "messaging_product": "whatsapp",
      "messages": [
        "…"
      ]
    }
  }
}

import express from "express"
import crypto from "node:crypto"

const app = express()

// The raw body is what was signed — parse it after verifying, never before.
app.post("/hooks/whatsapp", express.raw({ type: "application/json" }), (req, res) => {
  const signature = req.get("X-Drasken-Signature-256") ?? ""
  const timestamp = req.get("X-Drasken-Timestamp") ?? ""

  const expected =
    "sha256=" +
    crypto
      .createHmac("sha256", process.env.WEBHOOK_SECRET)
      .update(`${timestamp}.${req.body}`)
      .digest("hex")

  const a = Buffer.from(signature)
  const b = Buffer.from(expected)
  if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) {
    return res.sendStatus(401)
  }

  // Answer first, work afterwards: anything slower than a few seconds is
  // treated as a failed delivery and retried.
  res.sendStatus(200)

  const event = JSON.parse(req.body.toString())
  void handle(event)
})

const BASE = "https://wa.draskenapis.com"
const headers = {
  "x-access-key": process.env.WA_ACCESS_KEY,
  "x-secret-key": process.env.WA_SECRET_KEY,
  "Content-Type": "application/json",
}

async function sendText(to, text) {
  const res = await fetch(`${BASE}/messages`, {
    method: "POST",
    headers,
    body: JSON.stringify({
      phoneNumberId: process.env.WA_PHONE_NUMBER_ID,
      to,                       // E.164 digits only: 447911123456
      type: "text",
      text,
    }),
  })

  const body = await res.json()
  if (!res.ok) {
    // body.message carries Meta's own reason for a rejected send.
    throw new Error(`${res.status}: ${body.message}`)
  }
  return body.data
}

async function getMessage(id) {
  const res = await fetch(`${BASE}/messages/${id}`, { headers })
  const body = await res.json()
  return body.data
}

const sent = await sendText("447911123456", "Your order has shipped.")
console.log(sent.id, sent.metaMessageId)
console.log((await getMessage(sent.id)).status)

import os
import requests

BASE = "https://wa.draskenapis.com"
HEADERS = {
    "x-access-key": os.environ["WA_ACCESS_KEY"],
    "x-secret-key": os.environ["WA_SECRET_KEY"],
}

payload = {
    "phoneNumberId": os.environ["WA_PHONE_NUMBER_ID"],
    "to": "447911123456",
    "type": "template",
    "templateName": "order_shipped",
    "templateLanguage": "en_US",
    "templateComponents": [
        {"type": "body", "parameters": [{"type": "text", "text": "Aanya"}]}
    ],
}

response = requests.post(f"{BASE}/messages", json=payload, headers=HEADERS, timeout=30)
body = response.json()

if not response.ok:
    raise RuntimeError(f"{response.status_code}: {body.get('message')}")

print(body["data"]["id"], body["data"]["metaMessageId"])