API dokümantasyonu

https://nekna360.com/api/v1

curl https://nekna360.com/api/v1/me \
  -H "Authorization: Bearer n360_xxxxxxxxxxxxxxxx"

HTTP/1.1 403 Forbidden
{ "error": "insufficient_scope", "required": "messages:send" }

GET https://nekna360.com/api/v1/conversations?limit=50
→ { "data": [ … ], "next_cursor": "cmv…" }

GET https://nekna360.com/api/v1/conversations?limit=50&cursor=cmv…

{
  "organization": { "id": "cmv…", "name": "Atlas Yapı", "status": "ACTIVE" },
  "members": [ { "id": "cmu…", "name": "Can Demir", "email": "can@atlas.com", "role": "agent" } ],
  "key": { "name": "NeknaCRM", "scopes": ["messages:read", "messages:send"] }
}

{ "data": [
  { "id": "cmvp…", "type": "WHATSAPP_QR", "name": "WhatsApp +905321234567",
    "status": "connected", "phone": "+905321234567", "connected_at": "2026-10-27T09:12:00.000Z" }
] }

curl -X POST https://nekna360.com/api/v1/channels/whatsapp-qr \
  -H "Authorization: Bearer n360_…" -H "Content-Type: application/json" -d '{ "name": "Satış hattı" }'
→ 201 { "data": { "id": "cmvq…", "type": "WHATSAPP_QR", "status": "pending", "qr": null, … } }

{ "data": {
  "id": "cmvq…", "type": "WHATSAPP_QR", "name": "Satış hattı", "status": "pending", "phone": null,
  "qr": { "value": "2@Xk3…", "svg": "<svg xmlns=…>…</svg>", "generated_at": "2026-10-27T10:02:11.000Z" }
} }

curl -X POST https://nekna360.com/api/v1/contacts \
  -H "Authorization: Bearer n360_…" -H "Content-Type: application/json" \
  -d '{ "name": "Ayşe Yılmaz", "phone": "05321234567", "tags": ["web"], "opt_in": true }'

{ "contacts": [ { "name": "Ayşe", "phone": "05321234567", "opt_in": true }, { "name": "Mert", "phone": "05339876543" } ], "tags": ["fuar-2026"] }
→ { "created": 2, "updated": 0, "skipped": 0, "invalid": 0, "ids": ["cmv…", "cmv…"] }

curl -X POST https://nekna360.com/api/v1/messages \
  -H "Authorization: Bearer n360_…" -H "Content-Type: application/json" \
  -d '{ "channel_id": "cmvp…", "to": "05321234567", "name": "Ayşe Yılmaz",
        "text": "Merhaba Ayşe Hanım, teklifiniz hazır.", "client_ref": "crm-offer-8812" }'

{ "conversation_id": "cmvq…",
  "text": "Teklif ektedir.",
  "media": { "type": "document", "data": "<base64>", "mimetype": "application/pdf", "filename": "teklif.pdf" } }

{ "channel_id": "cmvc…", "to": "+905321234567",
  "template": { "name": "randevu_hatirlatma", "language": "tr", "params": ["Ayşe", "28 Ekim 14:00"] } }

{ "data": {
  "id": "cmvq0jw9o…", "conversation_id": "cmvpyt25…", "channel_id": "cmvp…", "channel_type": "WHATSAPP_QR",
  "contact_id": "cmvpw239…", "direction": "out", "type": "text", "text": "Merhaba Ayşe Hanım, teklifiniz hazır.",
  "media": null, "status": "pending", "error": null, "external_id": null, "source": "api",
  "client_ref": "crm-offer-8812", "created_at": "2026-10-27T09:30:11.388Z"
} }

GET https://nekna360.com/api/v1/conversations?status=open&phone=05321234567

{ "data": [ {
  "id": "cmvq…", "channel_id": "cmvp…", "channel_type": "WHATSAPP_QR", "channel_name": "WhatsApp +9053…",
  "contact": { "id": "cmvp…", "name": "Ayşe Yılmaz", "phone": "+905321234567", "email": null },
  "status": "open", "assignee_id": null, "unread_count": 2,
  "last_message_at": "2026-10-27T09:31:02.000Z", "last_preview": "Fiyat alabilir miyim?",
  "last_inbound_at": "2026-10-27T09:31:02.000Z", "created_at": "2026-10-20T08:00:00.000Z"
} ], "next_cursor": null }

{ "status": "closed" }        { "assignee_id": "cmu…" }

{
  "id": "evt_4f0c2b0e9a6c4c8f9d3a1b7e5c2d8f10",
  "type": "message.received",
  "created_at": "2026-10-27T09:31:02.412Z",
  "org_id": "cmvpuinuk…",
  "data": {
    "message": {
      "id": "cmvq…", "conversation_id": "cmvq…", "channel_id": "cmvp…", "channel_type": "WHATSAPP_QR",
      "contact_id": "cmvp…", "direction": "in", "type": "text", "text": "Fiyat alabilir miyim?",
      "media": null, "status": "received", "external_id": "3EB0…", "source": "customer", "created_at": "2026-10-27T09:31:02.000Z"
    },
    "contact": { "id": "cmvp…", "name": "Ayşe Yılmaz", "phone": "+905321234567" }
  }
}

{ "url": "https://crm.example.com/webhooks/nekna360", "events": ["message.received", "message.status"], "description": "NeknaCRM" }
→ 201 { "data": { "id": "cmvq…", …, "secret": "whsec_…" } }

{ "events": ["*"] }      { "active": false }

import crypto from "node:crypto";

app.post("/webhooks/nekna360", express.raw({ type: "application/json" }), (req, res) => {
  const ts = req.get("x-n360-timestamp");
  const sig = req.get("x-n360-signature") || "";
  const expected = crypto.createHmac("sha256", process.env.N360_WEBHOOK_SECRET)
    .update(ts + "." + req.body).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
  if (!fresh || sig.length !== expected.length || !crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) {
    return res.sendStatus(401);
  }
  const event = JSON.parse(req.body);
  res.sendStatus(200);           // answer first…
  queue.add(event);              // …then process
});

$body = file_get_contents('php://input');
$ts  = $_SERVER['HTTP_X_N360_TIMESTAMP'] ?? '';
$sig = $_SERVER['HTTP_X_N360_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', $ts . '.' . $body, getenv('N360_WEBHOOK_SECRET'));
if (abs(time() - (int) $ts) > 300 || !hash_equals($expected, $sig)) {
    http_response_code(401);
    exit;
}
$event = json_decode($body, true);
http_response_code(200);

import hmac, hashlib, time

def verify(raw_body: bytes, ts: str, sig: str, secret: str) -> bool:
    if abs(time.time() - int(ts)) > 300:
        return False
    expected = hmac.new(secret.encode(), ts.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, sig)

https://nekna360.com/api/partner/v1
Authorization: Bearer np_…

{ "ref": "crm-tenant-42", "name": "Atlas Yapı", "plan": "profesyonel", "trial_days": 14,
  "limits": { "qr_channels": 2, "monthly_messages": 5000 }, "owner_email": "ali@atlas.com" }

→ 201 { "data": { "id": "cmv…", "ref": "crm-tenant-42", "status": "trial", "plan": { "code": "profesyonel", … },
         "limits": { "channels": 10, "qr_channels": 2, … }, "usage": { "channels": 0, "qr_channels": 0 }, … },
        "created": true, "api_key": "n360_…", "invite_url": "https://nekna360.com/davet/…" }

{ "status": "active", "plan": "kurumsal", "limits": { "qr_channels": 5 } }

{ "revoke_others": true }   → 201 { "api_key": "n360_…" }

{ "email": "ali@atlas.com", "role": "owner" }   → 201 { "invite_url": "https://nekna360.com/davet/…", "expires_in_days": 7 }