Documentation

Cortex API & Widget

Chatbot widget integration, REST API reference, webhook setup and code examples.

Widget Embed

Embed an AI chatbot on any site with a single script tag. No framework dependency, <10KB vanilla JS.

Setup

Add the script tag

Paste it right before the closing </body> tag.

Choose your sector

The data-sector attribute activates a sector-trained chatbot.

Set the theme

Choose dark, light or brand theme with data-theme.

html

<script
  src="https://duzenal.com/widget/cortex-chat.js"
  data-sector="plastic-surgery"
  data-theme="dark"
  data-position="right">
</script>

Configuration

Attribute	Type	Default	Description
data-sector	string	"general"	Sector slug (e.g. plastic-surgery, dental-clinic)
data-theme	"dark" \| "light" \| "brand"	"dark"	Widget color theme
data-position	"right" \| "left"	"right"	Screen position
data-host	string	"https://duzenal.com"	API host (for self-hosted)

Full Configuration

html

<!-- All configuration options -->
<script
  src="https://duzenal.com/widget/cortex-chat.js"
  data-sector="plastic-surgery"
  data-theme="dark"
  data-position="right"
  data-host="https://duzenal.com">
</script>

Theme Options

Widget CSS is sandboxed and won't affect your site's styles.

Dark

For dark interfaces

Light

For light themes

Brand

Cortex brand colors

REST API

Programmatic access to the Cortex platform. All endpoints return JSON.

Method	Endpoint	Description
GET	/api/pdf/{slug}	Download sector presentation PDF
GET	/api/video/{slug}	Stream sector demo video
POST	/api/chatbot/message	Send message to chatbot
POST	/api/chatbot/webhook	Register webhook URL
GET	/api/chatbot/sessions/{id}	Session history
GET	/api/sectors	List all sectors
GET	/api/sectors/{slug}	Sector details

PDF Download

bash

# PDF Download
GET /api/pdf/{slug}

# Example
curl -O https://duzenal.com/api/pdf/plastic-surgery

# Response: application/pdf binary stream

Video Streaming

Supports partial download with Range header.

bash

# Video Streaming
GET /api/video/{slug}

# Example
curl https://duzenal.com/api/video/dental-clinic -o demo.mp4

# Response: video/mp4 stream, Range header supported

Chatbot API

Integrate the chatbot into your own application. Send messages, receive notifications via webhooks.

Send Message

json

POST /api/chatbot/message
Content-Type: application/json

{
  "sector": "plastic-surgery",
  "message": "What are rhinoplasty prices?",
  "session_id": "optional-session-id",
  "metadata": {
    "user_name": "John",
    "source": "website"
  }
}

# Response
{
  "reply": "Rhinoplasty prices vary ...",
  "session_id": "ses_abc123",
  "confidence": 0.94,
  "suggested_actions": [
    { "type": "appointment", "label": "Book Appointment" },
    { "type": "link", "label": "Price List", "url": "/pricing" }
  ]
}

Webhook Integration

json

POST /api/chatbot/webhook
Content-Type: application/json

{
  "url": "https://yoursite.com/api/cortex-webhook",
  "events": ["message.received", "appointment.created", "lead.captured"],
  "secret": "wh_sec_your_signing_secret"
}

# Webhook Payload Example
{
  "event": "lead.captured",
  "timestamp": "2026-05-27T14:30:00Z",
  "data": {
    "name": "John Smith",
    "phone": "+15551234567",
    "sector": "plastic-surgery",
    "interest": "Rhinoplasty",
    "session_id": "ses_abc123"
  },
  "signature": "sha256=..."
}

Security: Every webhook request includes an X-Cortex-Signature header with an HMAC-SHA256 signature.

SDK Setup

Integrate Düzenal into your application with the official SDK. TypeScript/JavaScript support.

Installation

bash

npm install @cortex-ai/sdk

Usage Example

tsx

import { CortexClient } from "@cortex-ai/sdk";

const client = new CortexClient({
  apiKey: "YOUR_API_KEY",
});

// Send a message
const response = await client.chat("Hello");
console.log(response.reply);

// Send with sector context
const sectorResponse = await client.chat("I want to book an appointment", {
  sector: "plastic-surgery",
  sessionId: "optional-session-id",
});
console.log(sectorResponse.reply);
console.log(sectorResponse.confidence);

API Key: Get your API key from the Settings > API Keys page.

Code Examples

Ready-to-use integration examples for different frameworks.

HTML (Vanilla)

Simplest integration. Paste into any HTML page.

html

<script
  src="https://duzenal.com/widget/cortex-chat.js"
  data-sector="plastic-surgery"
  data-theme="dark"
  data-position="right">
</script>

React / Next.js

Use as a component. Cleanup is automatic.

tsx

import { useEffect } from "react";

export function CortexWidget({ sector = "general", theme = "dark" }) {
  useEffect(() => {
    if (document.getElementById("cortex-chat-widget")) return;
    const script = document.createElement("script");
    script.src = "https://duzenal.com/widget/cortex-chat.js";
    script.setAttribute("data-sector", sector);
    script.setAttribute("data-theme", theme);
    document.body.appendChild(script);
    return () => {
      const el = document.getElementById("cortex-chat-widget");
      if (el) el.remove();
    };
  }, [sector, theme]);

  return null;
}

Vue 3

Composition API integration.

vue

<script setup>
import { onMounted, onUnmounted } from "vue";

const props = defineProps({
  sector: { type: String, default: "general" },
  theme: { type: String, default: "dark" },
});

onMounted(() => {
  if (document.getElementById("cortex-chat-widget")) return;
  const script = document.createElement("script");
  script.src = "https://duzenal.com/widget/cortex-chat.js";
  script.setAttribute("data-sector", props.sector);
  script.setAttribute("data-theme", props.theme);
  document.body.appendChild(script);
});

onUnmounted(() => {
  const el = document.getElementById("cortex-chat-widget");
  if (el) el.remove();
});
</script>

Quick Start Guide

Set up the Düzenal platform in 5 steps and greet your first customer with AI.

Sign Up

Create your free Cortex account and activate it in minutes.

Choose Your Sector

Select from 20 sectors and let AI models auto-configure for your industry.

View Sectors

Create Your Chatbot

Build a sector-trained AI chatbot in a few clicks and customize it to your brand.

Setup Chatbot

Embed the Widget

Add a single script tag to connect the chatbot to your website, WhatsApp, or Instagram.

Integration Code

Track Results

Monitor customer interactions and conversions with real-time analytics dashboard.

Analytics Demo

WhatsApp Setup

Requirements

Meta Business Manager account, a verified business, and a phone number not registered with WhatsApp.

Setup Steps

1. Meta Business Manager

Create an account at business.facebook.com and verify your business.

2. WhatsApp Business Platform

Meta Business Manager > All Tools > WhatsApp > Get Started. Add and verify your phone number.

3. API Token

System Users > New user > WhatsApp permissions > Generate Permanent Token.

4. Connect to Cortex

Admin panel > Settings > Integrations > WhatsApp. Enter your API Token and Phone Number ID.

5. Test

Send "hello" to your number via WhatsApp. The AI chatbot should respond.

AI Agent Setup

Creating an Agent

From the AI Agents page: choose a name, role (Support/Sales/Custom), model (Claude Haiku/Sonnet/Deepseek), tone and language.

Knowledge Base

Use Q&A (frequently asked questions), text (services, prices, location), or URL (crawl your website) options.

Handoff Rules

Define rules to transfer to a human operator for specific keywords or low confidence scores.

Testing

Test with live chat on the AI Agents page.

Plans & Pricing

Starter: 2,500 TL/mo

WhatsApp chatbot, 1 flow, 100-contact CRM, email support.

Professional: 5,000 TL/mo

WhatsApp + Instagram, 10 flows, 1,000-contact CRM, AI Agent, priority support.

Enterprise: 12,000 TL/mo

All channels, unlimited flows/CRM, 5 AI Agents, dedicated manager, custom integrations.

Payment

Credit card (iyzico), wire transfer. 20% discount on annual billing.

Security & Compliance

Data Security

Hosted in Turkey, SSL/TLS encryption, daily automatic backups, Docker isolation.

KVKK/GDPR Compliance

Explicit consent mechanism, data subject request (DSR) support, PII masking (local AI). Sensitive data never leaves Turkey.

Backup

Daily DB dump (04:00), 7-day retention, offsite backup (VPS). 99.95% uptime target.

API Access Ready

Request a demo to get your API key and start integrating.

Request Demo

Documentation

Cortex API & Widget

Chatbot widget integration, REST API reference, webhook setup and code examples.

Widget Embed

Embed an AI chatbot on any site with a single script tag. No framework dependency, <10KB vanilla JS.

Setup

Add the script tag

Paste it right before the closing </body> tag.

Choose your sector

The data-sector attribute activates a sector-trained chatbot.

Set the theme

Choose dark, light or brand theme with data-theme.

html

<script
  src="https://duzenal.com/widget/cortex-chat.js"
  data-sector="plastic-surgery"
  data-theme="dark"
  data-position="right">
</script>

Configuration

Attribute	Type	Default	Description
data-sector	string	"general"	Sector slug (e.g. plastic-surgery, dental-clinic)
data-theme	"dark" \| "light" \| "brand"	"dark"	Widget color theme
data-position	"right" \| "left"	"right"	Screen position
data-host	string	"https://duzenal.com"	API host (for self-hosted)

Full Configuration

html

<!-- All configuration options -->
<script
  src="https://duzenal.com/widget/cortex-chat.js"
  data-sector="plastic-surgery"
  data-theme="dark"
  data-position="right"
  data-host="https://duzenal.com">
</script>

Theme Options

Widget CSS is sandboxed and won't affect your site's styles.

Dark

For dark interfaces

Light

For light themes

Brand

Cortex brand colors

REST API

Programmatic access to the Cortex platform. All endpoints return JSON.

Method	Endpoint	Description
GET	/api/pdf/{slug}	Download sector presentation PDF
GET	/api/video/{slug}	Stream sector demo video
POST	/api/chatbot/message	Send message to chatbot
POST	/api/chatbot/webhook	Register webhook URL
GET	/api/chatbot/sessions/{id}	Session history
GET	/api/sectors	List all sectors
GET	/api/sectors/{slug}	Sector details

PDF Download

bash

# PDF Download
GET /api/pdf/{slug}

# Example
curl -O https://duzenal.com/api/pdf/plastic-surgery

# Response: application/pdf binary stream

Video Streaming

Supports partial download with Range header.

bash

# Video Streaming
GET /api/video/{slug}

# Example
curl https://duzenal.com/api/video/dental-clinic -o demo.mp4

# Response: video/mp4 stream, Range header supported

Chatbot API

Integrate the chatbot into your own application. Send messages, receive notifications via webhooks.

Send Message

json

POST /api/chatbot/message
Content-Type: application/json

{
  "sector": "plastic-surgery",
  "message": "What are rhinoplasty prices?",
  "session_id": "optional-session-id",
  "metadata": {
    "user_name": "John",
    "source": "website"
  }
}

# Response
{
  "reply": "Rhinoplasty prices vary ...",
  "session_id": "ses_abc123",
  "confidence": 0.94,
  "suggested_actions": [
    { "type": "appointment", "label": "Book Appointment" },
    { "type": "link", "label": "Price List", "url": "/pricing" }
  ]
}

Webhook Integration

json

POST /api/chatbot/webhook
Content-Type: application/json

{
  "url": "https://yoursite.com/api/cortex-webhook",
  "events": ["message.received", "appointment.created", "lead.captured"],
  "secret": "wh_sec_your_signing_secret"
}

# Webhook Payload Example
{
  "event": "lead.captured",
  "timestamp": "2026-05-27T14:30:00Z",
  "data": {
    "name": "John Smith",
    "phone": "+15551234567",
    "sector": "plastic-surgery",
    "interest": "Rhinoplasty",
    "session_id": "ses_abc123"
  },
  "signature": "sha256=..."
}

Security: Every webhook request includes an X-Cortex-Signature header with an HMAC-SHA256 signature.

SDK Setup

Integrate Düzenal into your application with the official SDK. TypeScript/JavaScript support.

Installation

bash

npm install @cortex-ai/sdk

Usage Example

tsx

import { CortexClient } from "@cortex-ai/sdk";

const client = new CortexClient({
  apiKey: "YOUR_API_KEY",
});

// Send a message
const response = await client.chat("Hello");
console.log(response.reply);

// Send with sector context
const sectorResponse = await client.chat("I want to book an appointment", {
  sector: "plastic-surgery",
  sessionId: "optional-session-id",
});
console.log(sectorResponse.reply);
console.log(sectorResponse.confidence);

API Key: Get your API key from the Settings > API Keys page.

Code Examples

Ready-to-use integration examples for different frameworks.

HTML (Vanilla)

Simplest integration. Paste into any HTML page.

html

<script
  src="https://duzenal.com/widget/cortex-chat.js"
  data-sector="plastic-surgery"
  data-theme="dark"
  data-position="right">
</script>

React / Next.js

Use as a component. Cleanup is automatic.

tsx

import { useEffect } from "react";

export function CortexWidget({ sector = "general", theme = "dark" }) {
  useEffect(() => {
    if (document.getElementById("cortex-chat-widget")) return;
    const script = document.createElement("script");
    script.src = "https://duzenal.com/widget/cortex-chat.js";
    script.setAttribute("data-sector", sector);
    script.setAttribute("data-theme", theme);
    document.body.appendChild(script);
    return () => {
      const el = document.getElementById("cortex-chat-widget");
      if (el) el.remove();
    };
  }, [sector, theme]);

  return null;
}

Vue 3

Composition API integration.

vue

<script setup>
import { onMounted, onUnmounted } from "vue";

const props = defineProps({
  sector: { type: String, default: "general" },
  theme: { type: String, default: "dark" },
});

onMounted(() => {
  if (document.getElementById("cortex-chat-widget")) return;
  const script = document.createElement("script");
  script.src = "https://duzenal.com/widget/cortex-chat.js";
  script.setAttribute("data-sector", props.sector);
  script.setAttribute("data-theme", props.theme);
  document.body.appendChild(script);
});

onUnmounted(() => {
  const el = document.getElementById("cortex-chat-widget");
  if (el) el.remove();
});
</script>

Quick Start Guide

Set up the Düzenal platform in 5 steps and greet your first customer with AI.

Sign Up

Create your free Cortex account and activate it in minutes.

Choose Your Sector

Select from 20 sectors and let AI models auto-configure for your industry.

View Sectors

Create Your Chatbot

Build a sector-trained AI chatbot in a few clicks and customize it to your brand.

Setup Chatbot

Embed the Widget

Add a single script tag to connect the chatbot to your website, WhatsApp, or Instagram.

Integration Code

Track Results

Monitor customer interactions and conversions with real-time analytics dashboard.

Analytics Demo

WhatsApp Setup

Requirements

Meta Business Manager account, a verified business, and a phone number not registered with WhatsApp.

Setup Steps

1. Meta Business Manager

Create an account at business.facebook.com and verify your business.

2. WhatsApp Business Platform

Meta Business Manager > All Tools > WhatsApp > Get Started. Add and verify your phone number.

3. API Token

System Users > New user > WhatsApp permissions > Generate Permanent Token.

4. Connect to Cortex

Admin panel > Settings > Integrations > WhatsApp. Enter your API Token and Phone Number ID.

5. Test

Send "hello" to your number via WhatsApp. The AI chatbot should respond.

AI Agent Setup

Creating an Agent

From the AI Agents page: choose a name, role (Support/Sales/Custom), model (Claude Haiku/Sonnet/Deepseek), tone and language.

Knowledge Base

Use Q&A (frequently asked questions), text (services, prices, location), or URL (crawl your website) options.

Handoff Rules

Define rules to transfer to a human operator for specific keywords or low confidence scores.

Testing

Test with live chat on the AI Agents page.

Plans & Pricing

Starter: 2,500 TL/mo

WhatsApp chatbot, 1 flow, 100-contact CRM, email support.

Professional: 5,000 TL/mo

WhatsApp + Instagram, 10 flows, 1,000-contact CRM, AI Agent, priority support.

Enterprise: 12,000 TL/mo

All channels, unlimited flows/CRM, 5 AI Agents, dedicated manager, custom integrations.

Payment

Credit card (iyzico), wire transfer. 20% discount on annual billing.

Security & Compliance

Data Security

Hosted in Turkey, SSL/TLS encryption, daily automatic backups, Docker isolation.

KVKK/GDPR Compliance

Explicit consent mechanism, data subject request (DSR) support, PII masking (local AI). Sensitive data never leaves Turkey.

Backup

Daily DB dump (04:00), 7-day retention, offsite backup (VPS). 99.95% uptime target.

API Access Ready

Request a demo to get your API key and start integrating.

Request Demo