CozumMerkezi API Dokumantasyon

CozumMerkezi REST API

Widget entegrasyonu, operator islemleri ve webhook yapilandirmasi icin API referansi.

Base URL: https://cozummerkezi.net/api/v1

Kimlik Dogrulama

Widget API — API Key

Header: X-API-Key: CM_XXXXXXXXXXXX

Operator API — Bearer Token (Sanctum)

Header: Authorization: Bearer {token}

Auth

POST /auth/login

Operator giris — token dondurur

POST /auth/logout

Cikis — token iptal (Bearer Token)

Widget API

POST /widget/init

Widget baslat, operator durumu al

POST /widget/chat/start

Yeni chat oturumu baslat

POST /widget/chat/message

Mesaj gonder

GET /widget/chat/messages

Mesajlari cek (polling)

POST /widget/chat/end

Chat sonlandir

POST /widget/chat/rate

Memnuniyet puani ver

GET /widget/chat/history

Gecmis chat oturumlari (visitor_id veya email ile)

GET /widget/chat/session

Oturum detay ve tum mesajlar (session_id ile)

POST /widget/ticket/create

Ticket olustur

GET /widget/ticket/list

Ticket listesi (email ile)

GET /widget/ticket/my

Kullaniciya ait ticketlar (visitor_id veya email ile)

GET /widget/ticket/{id}

Ticket detay

POST /widget/ticket/{id}/reply

Ticket yanitla

POST /widget/upload

Dosya yukle

GET /widget/kb/search

Bilgi bankasi arama

GET /widget/kb/categories

Kategoriler

GET /widget/kb/article/{slug}

Makale detay

GET /widget/campaigns

Aktif kampanyalar

Operator API

GET /operator/dashboard

Dashboard verileri

GET /operator/chats

Aktif chat listesi

GET /operator/chat/{id}/messages

Chat mesajlari

POST /operator/chat/{id}/message

Mesaj gonder

POST /operator/chat/{id}/transfer

Chat devret

POST /operator/chat/{id}/close

Chat kapat

POST /operator/chat/{id}/accept

Chat kabul et

GET /operator/tickets

Ticket listesi

POST /operator/ticket/{id}/reply

Yanit yaz

PUT /operator/ticket/{id}/status

Durum degistir

POST /operator/status

Online/offline toggle

GET /operator/canned-responses

Hazir yanitlar

Context API

POST /context/customer-info

Musteri bilgisi gonder

POST /context/page-info

Sayfa bilgisi gonder

POST /context/error-log

Hata log gonder

POST /context/screenshot

Ekran goruntusu gonder

Webhook Events

EVENT yeni_chat

Yeni chat basladi

EVENT yeni_ticket

Yeni ticket olusturuldu

EVENT chat_kapandi

Chat sonlandirildi

EVENT ticket_cozuldu

Ticket cozuldu

EVENT memnuniyet_puan

Memnuniyet puani verildi

EVENT operator_cevrimdisi

Operator cevrimdisi oldu

Ornek Kullanim

// Widget baslat
curl -X POST https://cozummerkezi.net/api/v1/widget/init \
  -H "X-API-Key: CM_DEMO_2026" \
  -H "Content-Type: application/json" \
  -d '{"ziyaretci_id": "abc123"}'

// Operator giris
curl -X POST https://cozummerkezi.net/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "password": "sifre123"}'

// Webhook payload ornegi
{
  "olay": "yeni_chat",
  "zaman": "2026-04-12T14:30:00+03:00",
  "veri": {
    "oturum_id": 42,
    "ziyaretci_adi": "Ahmet Yilmaz",
    "kanal": "web"
  }
}