API, MCP and webhooks for developers

curl https://sosyalmedya.website/api/v1/me \
  -H "Authorization: Bearer smw_live_…"

curl -X POST https://sosyalmedya.website/api/v1/messages \
  -H "Authorization: Bearer smw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "905321234567",
    "template": {
      "name": "randevu_hatirlatma",
      "language": "tr",
      "params": ["Ayşe", "yarın 10:00"]
    }
  }'

Authorization: Bearer smw_live_…

https://sosyalmedya.website/api/v1

curl -X POST https://sosyalmedya.website/api/v1/messages \
  -H "Authorization: Bearer smw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "905321234567",
    "template": {
      "name": "randevu_hatirlatma",
      "language": "tr",
      "params": ["Ayşe", "yarın 10:00"]
    }
  }'

curl -X POST https://sosyalmedya.website/api/v1/messages \
  -H "Authorization: Bearer smw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "conversation_id": "CONVERSATION_ID", "text": "Merhaba, nasıl yardımcı olabilirim?" }'

curl "https://sosyalmedya.website/api/v1/conversations?page=1" \
  -H "Authorization: Bearer smw_live_…"

const res = await fetch("https://sosyalmedya.website/api/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SMW_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "905321234567",
    template: { name: "randevu_hatirlatma", language: "tr", params: ["Ayşe", "yarın 10:00"] },
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
console.log(data.message.id, data.message.status);

import os, requests

res = requests.post(
    "https://sosyalmedya.website/api/v1/messages",
    headers={"Authorization": f"Bearer {os.environ['SMW_API_KEY']}"},
    json={
        "to": "905321234567",
        "template": {"name": "randevu_hatirlatma", "language": "tr", "params": ["Ayşe", "yarın 10:00"]},
    },
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")
print(data["message"]["id"], data["message"]["status"])

{
  "error": {
    "code": "window_closed",
    "message": "The 24-hour customer service window is closed …",
    "detail": "no_conversation"
  }
}

{
  "id": "evt_5f0c2a1e-…",
  "type": "message.received",
  "created_at": "2026-10-19T09:41:12.000Z",
  "data": {
    "message": {
      "id": "…", "conversation_id": "…", "number_id": "…",
      "direction": "in", "type": "text", "text": "Fiyat alabilir miyim?",
      "status": "received", "source": "contact", "media": null,
      "created_at": "2026-10-19T09:41:11.000Z"
    },
    "conversation": {
      "id": "…", "contact": { "wa_id": "905321234567", "name": "Ayşe" },
      "unread_count": 1, "window_open": true,
      "window_expires_at": "2026-10-20T09:41:11.000Z"
    },
    "number": { "id": "…", "display_phone_number": "+90 532 000 00 00" }
  }
}

import crypto from "node:crypto";

// rawBody: ayrıştırılmamış gövde (string) · header: X-SMW-Signature
export function verifySignature(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
  const expected = crypto.createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest("hex");
  return expected.length === parts.v1?.length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}

import hashlib, hmac, time

def verify_signature(raw_body: bytes, header: str, secret: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(","))
    if abs(time.time() - int(parts["t"])) > 300:
        return False
    expected = hmac.new(secret.encode(), parts["t"].encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, parts.get("v1", ""))

https://sosyalmedya.website/api/mcp

# OAuth (tarayıcıda giriş) / OAuth (sign in in the browser)
claude mcp add --transport http sosyalmedya https://sosyalmedya.website/api/mcp

# API anahtarıyla / With an API key
claude mcp add --transport http sosyalmedya https://sosyalmedya.website/api/mcp \
  --header "Authorization: Bearer smw_live_…"

{
  "mcpServers": {
    "sosyalmedya": {
      "url": "https://sosyalmedya.website/api/mcp",
      "headers": {
        "Authorization": "Bearer smw_live_…"
      }
    }
  }
}

{
  "servers": {
    "sosyalmedya": {
      "type": "http",
      "url": "https://sosyalmedya.website/api/mcp",
      "headers": {
        "Authorization": "Bearer smw_live_…"
      }
    }
  }
}

{
  "mcpServers": {
    "sosyalmedya": {
      "serverUrl": "https://sosyalmedya.website/api/mcp",
      "headers": {
        "Authorization": "Bearer smw_live_…"
      }
    }
  }
}

https://sosyalmedya.website/api/v1/openapi.json