REST API Referansı

E-posta ve şifre ile giriş yapın. JWT access ve refresh token döner. Hesapta 2FA aktifse, önce requiresTwoFactor: true döner — ardından totpCode ile tekrar istek gönderin.

{
  "email": "user\u0040example.com",
  "password": "your_password",
  "totpCode": "123456"  // 2FA aktifse gerekli (opsiyonel)
}

// ── Normal Giriş (2FA kapalı) ──
{
  "accessToken": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "uuid",
    "email": "user\u0040example.com",
    "role": "tenant_admin"
  }
}

// ── 2FA Aktif — İlk Adım (totpCode gönderilmediğinde) ──
{
  "requiresTwoFactor": true,
  "email": "user\u0040example.com"
}
// → Kullanıcıdan 6 haneli TOTP kodunu alıp
//   aynı endpoint'e email + password + totpCode
//   ile tekrar istek gönderin.

Refresh token ile yeni access token alın.

{ "refreshToken": "eyJhbGciOiJIUzI1NiIs..." }

Yeni kullanıcı ve tenant kaydı oluşturun.

{
  "email": "user\u0040example.com",
  "password": "strong_password",
  "name": "Ahmet Yılmaz",
  "companyName": "Acme Inc."
}

Tenant'a ait konuşma listesini döner. Sayfalama, filtreleme ve sıralama destekler.

{
  "data": [
    {
      "id": "conv_abc123",
      "channel": "whatsapp",
      "status": "active",
      "lastMessage": "Siparişim nerede?",
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ],
  "meta": { "total": 42, "page": 1, "limit": 20 }
}

Belirli bir konuşmanın detaylarını ve mesaj geçmişini döner.

Konuşma durumunu güncelle (active, resolved, archived).

{ "status": "resolved" }

Konuşmayı bir operatöre ata.

{ "operatorId": "user_uuid" }

Bir konuşmaya mesaj gönder.

{
  "conversationId": "conv_abc123",
  "content": "Siparişiniz kargoya verildi!",
  "type": "text"
}

Konuşmadaki mesaj geçmişini getir.

Bilgi bankası içeriklerini listele.

Bilgi bankasına yeni içerik ekle.

{
  "title": "İade Politikası",
  "content": "Ürünler 14 gün içinde...",
  "category": "Politikalar"
}

Bilgi bankasından içerik sil.

Bağlı kanalları listele.

Yeni kanal bağlantısı oluştur ve kanal yapılandırmasını kaydet.

Genel analitik verilerini getir (konuşma sayısı, ortalama yanıt süresi, memnuniyet puanı).

{
  "totalConversations": 1250,
  "avgResponseTime": 12.5,
  "satisfactionScore": 4.6,
  "aiResolutionRate": 78.3,
  "period": "last_30_days"
}

Konuşma analitiklerini getir (tarih bazlı dağılım).

Kayıtlı webhook'ları listele.

Yeni webhook kaydı oluştur.

{
  "url": "https://yourapp.com/webhooks/yanitly",
  "events": ["conversation.created", "message.received"],
  "secret": "your_webhook_secret"
}