Çağrılar ve konular

/api/v1/cagrilar — GET

GET/api/v1/cagrilar

Çağrıları listele

Çağrılar created_at artan sırada (artımlı çekim: next_cursor). Özet, çözüm ve konular etiketleme bitince dolar (tagged_at). Paketinizde konu analitiği kapalıysa konular, cozum, tagged_at, konu_duzeltme alanları yanıtta yer almaz ve topic_id/cozum süzgeci 422 unknown_filter döner. Telefon ve ad maskelidir (kişisel veri ayarı açık değilse).

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: calls:read
• Paket özelliği: Veri API — kapalıysa uç 404 not_found döner

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
since	query	string (date-time) | null		Bu andan sonrası (ISO 8601).
until	query	string (date-time) | null		created_at < until (ISO 8601).
channel	query	"web" | "phone_in" | "phone_out" | "web_sohbet" | "sms" | "eposta" | null		phone_in (gelen), phone_out (giden), web.
topic_id	query	string (uuid) | null		Konu kimliği (konu analitiği gerekir).
cozum	query	string | null		Çözüm durumu: pinar_cozdu (asistan çözdü), talep_acildi, temsilciye_yonlendi, cozulmedi, belirsiz.
is_test	query	boolean | null		Deneme aramalarını süz.
cursor	query	string | null		Önceki yanıttaki next_cursor.
limit	query	integer	≥ 1, ≤ 100, varsayılan 50	Sayfa boyutu.

Örnek

curl -s -G "$RZ_API/api/v1/cagrilar" -H "Authorization: Bearer $RZ_KEY" \
  --data-urlencode "since=2026-09-01T00:00:00+03:00" --data-urlencode "channel=phone_in" --data-urlencode "limit=50"

Yanıt 200

{
  "items": [
    {
      "id": "0199…",
      "agent": {
        "id": "0199…",
        "slug": "asistan",
        "name": "Mağaza Asistanı"
      },
      "channel": "phone_in",
      "status": "completed",
      "outcome": "user_hangup",
      "is_test": false,
      "phone": "+90 532 *** ** 67",
      "callee_name": "A***",
      "created_at": "2026-09-24T09:10:00Z",
      "answered_at": "2026-09-24T09:10:01Z",
      "ended_at": "2026-09-24T09:12:40Z",
      "duration_s": 159,
      "summary": "Müşteri kargo durumunu sordu. Teslim tarihi bildirildi.",
      "cozum": "pinar_cozdu",
      "tagged_at": "2026-09-24T09:13:05Z",
      "konu_duzeltme": 0,
      "konular": [
        {
          "id": "0199…",
          "ad": "Kargo durumu",
          "grup": "Kargo ve teslimat",
          "kaynak": "otomatik"
        }
      ],
      "requests": []
    }
  ],
  "next_cursor": "2026-09-24T09:10:00.000000+00:00_0199…",
  "has_more": false
}

Hata durumları: 401, 403, 404, 413, 422, 429 — bkz. Hatalar ve sınırlar.

---

/api/v1/cagrilar/{call_id} — GET

GET/api/v1/cagrilar/{call_id}

Çağrı detayı

Tek çağrı. transcript yalnız anahtarda calls:read:transcript kapsamı varsa dolu, yoksa null. Döküm, kişisel veri ayarı açık değilse maskelenir.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: calls:read
• Paket özelliği: Veri API — kapalıysa uç 404 not_found döner

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
call_id *	path	string (uuid)		Çağrı kimliği (UUID).

Örnek

curl -s "$RZ_API/api/v1/cagrilar/0199…" -H "Authorization: Bearer $RZ_KEY"

Yanıt 200

{
  "id": "0199…",
  "channel": "phone_in",
  "status": "completed",
  "summary": "…",
  "transcript": [
    {
      "idx": 0,
      "role": "assistant",
      "t_start_ms": 900,
      "text": "Merhaba, size nasıl yardımcı olabilirim?"
    }
  ]
}

Hata durumları: 401, 403, 404, 413, 422, 429 — bkz. Hatalar ve sınırlar.

---

/api/v1/konular/istatistik — GET

GET/api/v1/konular/istatistik

Konu istatistiği

Grup → konu adetleri, asistanın çözdüğü oran ve aynı uzunluktaki önceki döneme göre adetler. from/to İstanbul günüdür ve ikisi dahildir; aralık en çok 366 gün (aksi 422 invalid_range).

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: calls:read
• Paket özelliği: Veri API + Konu analitiği — kapalıysa uç 404 not_found döner

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
from *	query	string (date)		Başlangıç günü (İstanbul, dahil).
to *	query	string (date)		Bitiş günü (İstanbul, dahil).
channel	query	"web" | "phone_in" | "phone_out" | "web_sohbet" | "sms" | "eposta" | null		phone_in (gelen), phone_out (giden), web.

Örnek

curl -s -G "$RZ_API/api/v1/konular/istatistik" -H "Authorization: Bearer $RZ_KEY" \
  --data-urlencode "from=2026-09-01" --data-urlencode "to=2026-09-30" --data-urlencode "channel=phone_in"

Yanıt 200

{
  "totals": {
    "calls": 412,
    "tagged": 405,
    "untagged": 7,
    "corrected": 12,
    "correction_rate": 0.0296
  },
  "groups": [
    {
      "ad": "Kargo ve teslimat",
      "count": 160,
      "prev_count": 141,
      "topics": [
        {
          "ad": "Kargo durumu",
          "count": 131,
          "prev_count": 120,
          "resolved_rate": 0.83
        }
      ]
    }
  ]
}

Hata durumları: 401, 403, 404, 413, 422, 429 — bkz. Hatalar ve sınırlar.