curl -X POST https://msgx.thepistachio.tech/api/public-api/otp/send \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "code": "482910"
  }'

{
  "success": true,
  "messageId": "wam_AbCdEf123456",
  "to": "919876543210",
  "templateUsed": "otp_verification_en",
  "status": "sent",
  "timestamp": 1719820800000
}

curl -X POST https://msgx.thepistachio.tech/api/public-api/otp/send \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "code": "827461",
    "language": "hi"
  }'

curl https://msgx.thepistachio.tech/api/public-api/otp/templates \
  -H "X-API-Key: pk_live_YOUR_KEY"

{
  "success": true,
  "templates": [
    {
      "id": "uuid-...",
      "name": "otp_verification_en",
      "language": "en",
      "status": "APPROVED",
      "createdAt": "2024-06-01T10:00:00.000Z"
    },
    {
      "id": "uuid-...",
      "name": "my_custom_otp",
      "language": "hi",
      "status": "PENDING",
      "createdAt": "2024-06-02T08:30:00.000Z"
    }
  ]
}

curl -X POST https://msgx.thepistachio.tech/api/public-api/messages/send \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "text",
    "text": { "body": "Hello! Your order #1234 has been shipped." }
  }'

curl -X POST https://msgx.thepistachio.tech/api/public-api/messages/send-template \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "template": {
      "name": "order_shipped",
      "language": "en",
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "ORD-9876" },
            { "type": "text", "text": "Blue Denim Jacket" }
          ]
        }
      ]
    }
  }'

curl -X POST https://msgx.thepistachio.tech/api/public-api/messages/send-media \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "image",
    "media": {
      "url": "https://example.com/invoice.pdf",
      "caption": "Your invoice for June 2024"
    }
  }'

# Button message
curl -X POST https://msgx.thepistachio.tech/api/public-api/messages/send-interactive \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "button",
    "body": { "text": "Did you receive your package?" },
    "buttons": [
      { "id": "yes", "title": "Yes, received!" },
      { "id": "no",  "title": "No, not yet"    }
    ]
  }'

curl https://msgx.thepistachio.tech/api/public-api/messages/wam_AbCdEf123456/status \
  -H "X-API-Key: pk_live_YOUR_KEY"

{
  "success": true,
  "messageId": "wam_AbCdEf123456",
  "status": "read",
  "to": "919876543210",
  "sentAt": "2024-06-01T10:00:00.000Z",
  "deliveredAt": "2024-06-01T10:00:03.000Z",
  "readAt": "2024-06-01T10:01:12.000Z"
}

curl "https://msgx.thepistachio.tech/api/public-api/templates?status=ALL&category=AUTHENTICATION" \
  -H "X-API-Key: pk_live_YOUR_KEY"

curl -X POST https://msgx.thepistachio.tech/api/public-api/templates \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "order_shipped_update",
    "language": "en",
    "category": "UTILITY",
    "components": [
      { "type": "HEADER", "format": "TEXT", "text": "Order Update" },
      {
        "type": "BODY",
        "text": "Hi {{1}}, your order {{2}} has been shipped and will arrive by {{3}}. Thank you for shopping with us.",
        "example": { "body_text": [["Rahul", "#4521", "15 July"]] }
      },
      { "type": "FOOTER", "text": "Reply here for any help" }
    ]
  }'

# Response (201)
{
  "success": true,
  "template": {
    "id": "f3a1c2d4-...",
    "name": "order_shipped_update",
    "language": "en",
    "category": "UTILITY",
    "status": "PENDING",
    "metaTemplateId": "1234567890",
    "createdAt": "2026-07-13T10:00:00.000Z"
  }
}

curl -X POST https://msgx.thepistachio.tech/api/public-api/templates \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "login_otp",
    "language": "en",
    "category": "AUTHENTICATION",
    "components": [
      { "type": "BODY", "add_security_recommendation": true },
      {
        "type": "BUTTONS",
        "buttons": [{ "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy Code" }]
      }
    ]
  }'

curl -X POST https://msgx.thepistachio.tech/api/public-api/templates \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "invoice_receipt",
    "language": "en",
    "category": "UTILITY",
    "components": [
      {
        "type": "HEADER",
        "format": "DOCUMENT",
        "example": { "header_url": "https://yourapp.com/files/invoice-sample.pdf", "header_filename": "invoice.pdf" }
      },
      {
        "type": "BODY",
        "text": "Hi {{1}}, please find your invoice {{2}} for {{3}} attached above. Thank you for your business.",
        "example": { "body_text": [["Rahul", "#INV-4521", "₹4,500"]] }
      }
    ]
  }'

curl -X POST https://msgx.thepistachio.tech/api/public-api/media/upload \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -F "file=@invoice-sample.pdf" \
  -F "type=document"

# Response
{
  "success": true,
  "media": { "handle": "4::abc123...", "type": "document" }
}

{
  "type": "HEADER",
  "format": "DOCUMENT",
  "example": { "header_handle": ["4::abc123..."] }
}

curl -X POST https://msgx.thepistachio.tech/api/public-api/messages/send-template \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "template": {
      "name": "invoice_receipt",
      "language": "en",
      "components": [
        {
          "type": "header",
          "parameters": [{ "type": "document", "document": { "link": "https://yourapp.com/files/inv-4521.pdf", "filename": "invoice.pdf" } }]
        },
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "Rahul" },
            { "type": "text", "text": "#INV-4521" },
            { "type": "text", "text": "₹4,500" }
          ]
        }
      ]
    }
  }'

curl https://msgx.thepistachio.tech/api/public-api/templates/order_shipped_update \
  -H "X-API-Key: pk_live_YOUR_KEY"

# Response
{
  "success": true,
  "template": {
    "id": "f3a1c2d4-...",
    "name": "order_shipped_update",
    "language": "en",
    "category": "UTILITY",
    "status": "APPROVED",
    "rejectionReason": null,
    "components": [ ... ],
    "metaTemplateId": "1234567890"
  }
}

curl -X POST https://msgx.thepistachio.tech/api/public-api/webhooks/configure \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/api/whatsapp-webhook",
    "secret": "your_signing_secret",
    "events": ["messages", "statuses"]
  }'

// Incoming message event
{
  "type": "message.received",
  "tenantId": "uuid-...",
  "data": {
    "from": "919876543210",
    "messageId": "wam_InCoMiNg",
    "text": "Hello!",
    "timestamp": "2024-06-01T10:05:00.000Z"
  }
}

// Delivery status event
{
  "type": "message.delivered",
  "tenantId": "uuid-...",
  "data": {
    "messageId": "wam_AbCdEf123456",
    "status": "delivered",
    "timestamp": "2024-06-01T10:00:03.000Z"
  }
}

const crypto = require('crypto');

function verifyWebhook(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// Express example
app.post('/api/whatsapp-webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.headers['x-webhook-signature'];
  if (!verifyWebhook(req.body, sig, process.env.WEBHOOK_SECRET)) {
    return res.status(401).send('Unauthorized');
  }
  const event = JSON.parse(req.body);
  console.log('Event:', event.type, event.data);
  res.status(200).send('OK');
});

curl "https://msgx.thepistachio.tech/api/public-api/webhooks/logs?status=failed&limit=10" \
  -H "X-API-Key: pk_live_YOUR_KEY"

const axios = require('axios');

const MSGX_KEY = process.env.MSGX_API_KEY; // pk_live_...
const BASE = 'https://msgx.thepistachio.tech/api/public-api';

async function sendOtp(phone, code) {
  const { data } = await axios.post(`${BASE}/otp/send`, {
    to: phone,   // e.g. '919876543210'
    code: code   // your generated OTP
  }, {
    headers: { 'X-API-Key': MSGX_KEY }
  });
  return data; // { success, messageId, status }
}

// Usage
const otp = Math.floor(100000 + Math.random() * 900000).toString();
// Store otp in your DB/Redis with TTL
await sendOtp('919876543210', otp);

import requests, random, os

MSGX_KEY = os.environ['MSGX_API_KEY']  # pk_live_...
BASE = 'https://msgx.thepistachio.tech/api/public-api'

def send_otp(phone: str, code: str) -> dict:
    resp = requests.post(
        f'{BASE}/otp/send',
        json={'to': phone, 'code': code},
        headers={'X-API-Key': MSGX_KEY},
        timeout=10
    )
    resp.raise_for_status()
    return resp.json()

# Usage
otp = str(random.randint(100000, 999999))
# Store otp in DB/Redis with TTL
send_otp('919876543210', otp)

<?php
$key  = getenv('MSGX_API_KEY');  // pk_live_...
$base = 'https://msgx.thepistachio.tech/api/public-api';

function sendOtp(string $phone, string $code): array {
    global $key, $base;
    $ch = curl_init("$base/otp/send");
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => json_encode(['to' => $phone, 'code' => $code]),
        CURLOPT_HTTPHEADER     => [
            'X-API-Key: ' . $key,
            'Content-Type: application/json',
        ],
    ]);
    $body = curl_exec($ch);
    curl_close($ch);
    return json_decode($body, true);
}

// Usage
$otp = strval(random_int(100000, 999999));
// Store $otp in DB/Redis with TTL
sendOtp('919876543210', $otp);

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

const base = "https://msgx.thepistachio.tech/api/public-api"

func sendOTP(phone, code string) error {
    payload, _ := json.Marshal(map[string]string{"to": phone, "code": code})
    req, _ := http.NewRequest("POST", base+"/otp/send", bytes.NewBuffer(payload))
    req.Header.Set("X-API-Key", os.Getenv("MSGX_API_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil { return err }
    defer resp.Body.Close()

    var result map[string]any
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
    return nil
}

func main() {
    _ = sendOTP("919876543210", "482910")
}