Chatbot Kurulum Rehberi

# 1. Chatbot oluştur
curl -X POST https://duzenal.com/api/v1/chatbots \
  -H "X-API-Key: ctx_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Müşteri Destek Botu",
    "sector": "plastik-cerrahi",
    "language": "tr",
    "tone": "professional",
    "welcome_message": "Merhaba! Nasıl yardımcı olabilirim?",
    "fallback_message": "Bu konuda sizi danışmanımıza bağlayayım.",
    "collect_lead": true,
    "lead_fields": ["name", "phone", "email"]
  }'

# Yanıt
{
  "chatbot_id": "bot_abc123",
  "name": "Müşteri Destek Botu",
  "sector": "plastik-cerrahi",
  "status": "active",
  "widget_script": "<script src=\"https://duzenal.com/widget/cortex-chat.js\" data-chatbot-id=\"bot_abc123\"...",
  "api_endpoint": "https://duzenal.com/api/v1/chatbot/bot_abc123/message"
}

# Metin belgesi ekle
curl -X POST https://duzenal.com/api/v1/training/documents \
  -H "X-API-Key: ctx_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "chatbot_id": "bot_abc123",
    "type": "text",
    "title": "Fiyat Listesi 2026",
    "content": "Burun estetiği: 45.000 TL - 65.000 TL\nYüz germe: 60.000 TL - 90.000 TL\nGöz kapağı: 25.000 TL - 40.000 TL",
    "tags": ["fiyatlar", "hizmetler"]
  }'

# URL tarama
curl -X POST https://duzenal.com/api/v1/training/documents \
  -H "X-API-Key: ctx_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "chatbot_id": "bot_abc123",
    "type": "url",
    "url": "https://sirketiniz.com/hizmetler",
    "title": "Hizmetler Sayfası",
    "auto_refresh": true
  }'

# PDF yükle (multipart)
curl -X POST https://duzenal.com/api/v1/training/documents \
  -H "X-API-Key: ctx_your_key_here" \
  -F "chatbot_id=bot_abc123" \
  -F "type=pdf" \
  -F "title=2026 Fiyat Kataloğu" \
  -F "file=@/path/to/catalog.pdf"

# Handoff kuralları yapılandır
curl -X PUT https://duzenal.com/api/v1/chatbots/bot_abc123/handoff \
  -H "X-API-Key: ctx_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "rules": [
      {
        "condition": "confidence_below",
        "threshold": 0.6,
        "action": "transfer_to_human",
        "message": "Sizi bir uzmanımıza bağlıyorum..."
      },
      {
        "condition": "keyword_match",
        "keywords": ["şikayet", "iade", "hukuki", "avukat"],
        "action": "transfer_to_human",
        "priority": "high"
      },
      {
        "condition": "inactivity",
        "timeout_seconds": 300,
        "action": "send_followup",
        "message": "Hâlâ burada mısınız? Yardımcı olabilir miyim?"
      }
    ],
    "transfer_channels": ["telegram", "whatsapp"],
    "business_hours": {
      "enabled": true,
      "timezone": "Europe/Istanbul",
      "schedule": {
        "weekdays": "09:00-18:00",
        "saturday": "10:00-15:00",
        "sunday": null
      },
      "out_of_hours_message": "Çalışma saatlerimiz dışındasınız. Yarın 09:00'da yanınızdayız!"
    }
  }'

# Chatbot'a mesaj gönder
curl -X POST https://duzenal.com/api/v1/chatbot/bot_abc123/message \
  -H "X-API-Key: ctx_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Burun estetiği için randevu almak istiyorum",
    "session_id": "user_xyz789",
    "channel": "website",
    "metadata": {
      "user_name": "Ahmet Yılmaz",
      "page_url": "https://sirketiniz.com/hizmetler",
      "referrer": "google_ads"
    }
  }'

# Yanıt
{
  "ok": true,
  "reply": "Merhaba Ahmet Bey! Burun estetiği için randevu almak istediğinizi duydum. En yakın uygun tarihimiz 5 Haziran Perşembe günü. Saat 14:00 veya 16:00'da uygun mu?",
  "session_id": "user_xyz789",
  "confidence": 0.95,
  "intent": "appointment_request",
  "entities": {
    "service": "burun estetiği",
    "action": "randevu"
  },
  "suggested_actions": [
    { "type": "appointment", "label": "14:00 - Randevu Al", "slot": "2026-06-05T14:00:00Z" },
    { "type": "appointment", "label": "16:00 - Randevu Al", "slot": "2026-06-05T16:00:00Z" },
    { "type": "link", "label": "Tüm Hizmetler", "url": "/hizmetler" }
  ]
}

# Chatbot performans istatistikleri
curl https://duzenal.com/api/v1/chatbots/bot_abc123/analytics \
  -H "X-API-Key: ctx_your_key_here" \
  -G \
  --data-urlencode "from=2026-05-01" \
  --data-urlencode "to=2026-05-31"

# Yanıt
{
  "chatbot_id": "bot_abc123",
  "period": { "from": "2026-05-01", "to": "2026-05-31" },
  "messages": { "total": 4821, "user": 2416, "bot": 2405 },
  "sessions": { "total": 847, "avg_duration_minutes": 4.2 },
  "leads_captured": 124,
  "appointments_booked": 38,
  "handoffs_triggered": 17,
  "avg_confidence": 0.91,
  "top_intents": ["fiyat_sorgusu", "randevu_talebi", "konum"],
  "satisfaction_score": 4.3
}