Ana içeriğe atla
GET
/
user
/
conversations
curl -X GET "https://app.whattalk.ai/api/user/conversations?type=widget&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "current_page": 1,
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "widget",
      "message_count": 12,
      "total_cost": 0.0045,
      "ai_enabled": true,
      "created_at": "2025-01-25 14:30:00",
      "updated_at": "2025-01-25 14:45:22"
    },
    {
      "id": "8d0f7780-8536-51ef-055c-f18fd2g01bf8",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "whatsapp",
      "message_count": 8,
      "total_cost": 0.0032,
      "ai_enabled": true,
      "created_at": "2025-01-25 10:15:00",
      "updated_at": "2025-01-25 10:28:45"
    }
  ],
  "first_page_url": "https://app.whattalk.ai/api/user/conversations?page=1",
  "from": 1,
  "last_page": 5,
  "last_page_url": "https://app.whattalk.ai/api/user/conversations?page=5",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://app.whattalk.ai/api/user/conversations?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.whattalk.ai/api/user/conversations?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.whattalk.ai/api/user/conversations?page=2",
  "path": "https://app.whattalk.ai/api/user/conversations",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 68
}
Bu endpoint, kimliği doğrulanmış kullanıcının asistanlarına ait sayfalanmış konuşma listesini döndürür. Bunu konuşma geçmişini görüntülemek, türe göre filtrelemek veya CRM’inizle entegre etmek için kullanın.
Bu endpoint kimlik doğrulaması gerektirir. API anahtarınızı Authorization başlığında Bearer token olarak gönderin.

​
Sorgu Parametreleri

​
type
string
Konuşmaları türe göre filtreleyin. Olası değerler: test, widget, whatsapp, api
​
assistant_id
integer
Konuşmaları asistan kimliğine göre filtreleyin (kimliği doğrulanmış kullanıcıya ait olmalıdır)
​
date_from
string
Bu tarihten itibaren konuşmaları filtreleyin (YYYY-MM-DD formatı)
​
date_to
string
Bu tarihe kadar konuşmaları filtreleyin (YYYY-MM-DD formatı)
​
per_page
integer
Sayfa başına konuşma sayısı (1-100, varsayılan: 15)
​
page
integer
Sayfa numarası (varsayılan: 1)

​
Yanıt Alanları

​
data
array
​
current_page
integer
Mevcut sayfa numarası
​
per_page
integer
Sayfa başına öğe sayısı
​
total
integer
Kriterlere uyan toplam konuşma sayısı
​
last_page
integer
Son sayfa numarası
curl -X GET "https://app.whattalk.ai/api/user/conversations?type=widget&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "current_page": 1,
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "widget",
      "message_count": 12,
      "total_cost": 0.0045,
      "ai_enabled": true,
      "created_at": "2025-01-25 14:30:00",
      "updated_at": "2025-01-25 14:45:22"
    },
    {
      "id": "8d0f7780-8536-51ef-055c-f18fd2g01bf8",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "whatsapp",
      "message_count": 8,
      "total_cost": 0.0032,
      "ai_enabled": true,
      "created_at": "2025-01-25 10:15:00",
      "updated_at": "2025-01-25 10:28:45"
    }
  ],
  "first_page_url": "https://app.whattalk.ai/api/user/conversations?page=1",
  "from": 1,
  "last_page": 5,
  "last_page_url": "https://app.whattalk.ai/api/user/conversations?page=5",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://app.whattalk.ai/api/user/conversations?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.whattalk.ai/api/user/conversations?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.whattalk.ai/api/user/conversations?page=2",
  "path": "https://app.whattalk.ai/api/user/conversations",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 68
}

​
Konuşma Türleri

TürAçıklama
testAsistan test arayüzünden yapılan dahili test konuşmaları
widgetWeb sohbet widget’ından gelen konuşmalar
whatsappWhatsApp Business konuşmaları
apiAPI aracılığıyla oluşturulan konuşmalar

​
Kullanım Alanları

  • Analitik Panosu: Konuşma metriklerini ve trendleri görüntüleyin
  • CRM Entegrasyonu: Konuşma verilerini müşteri veritabanınızla senkronize edin
  • Kalite İzleme: Tür ve asistana göre konuşma hacimlerini inceleyin
  • Fatura İnceleme: Kuruluşunuz genelinde konuşma maliyetlerini takip edin