vCon ile veri dışa aktarma

Tamamlanmış bir aramayı IETF vCon konteyneri olarak dışa aktarın: taraflar, döküm, kayıt referansı ve analiz tek taşınabilir JSON dosyasında. Asistan bazında açılır.

Güncellendi: 17 Ağustos 2026

Tamamlanmış herhangi bir aramayı IETF vCon konteyneri olarak dışa aktarabilirsiniz — bir görüşmenin taşınabilir, kendi kendine yeten kaydı. Standart adı draft-ietf-vcon-vcon-container.

Yeni bir şey kaydedilmiyor

Bu özellik ek veri toplamıyor. Bir arama zaten katılımcıları, sıra sıra dökümü, isteğe bağlı kaydı ve arama sonrası analizi üretiyor. vCon dışa aktarımı bu mevcut kaydı standart konteynere paketliyor — böylece görüşme, karşı tarafta özel bir entegrasyon yazılmadan platformdan çıkabiliyor.

Uç

GET /v1/calls/{call_id}/vcon

application/json döner. İki koşul birlikte sağlanmalı: arama sizin çalışma alanınıza ait olmalı ve aramanın asistanında vCon dışa aktarımı açık olmalı.

curl https://api.call2me.app/v1/calls/call_abc123/vcon \
  -H "Authorization: Bearer sk_live_..." \
  -o call_abc123.vcon.json

Panelde aynı dosya tek tıkla iner: Aramalar sayfasında, vCon açık bir asistana ait tamamlanmış aramaların yanında indirme simgesi görünür.

Varsayılan kapalı, asistan bazında açılır

Dışa aktarım, ilgili asistan için açana kadar kapalıdır; diğer asistanların davranışı hiç değişmez. Asistan detay sayfasından enable_vcon_export ayarını açarsınız.

curl -X PATCH https://api.call2me.app/v1/agents/agent_abc123 \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"enable_vcon_export": true}'

Dışa aktarım kapalıyken uç 403 değil 404 döner. Bu bilinçli bir tercih: 403 yanıtı "bu arama var" bilgisini doğrulardı ve bir arama kimliği, o görüşmenin gerçekleşip gerçekleşmediğini yoklamak için kullanılabilir hale gelirdi.

Neyin karşılığı ne

vCon alanı	Kaynak
parties[0] (role: agent)	Asistan adı + platform tarafındaki numara
parties[1] (role: customer)	Karşı tarafın numarası
dialog[] type: text	Konuşmacı etiketli döküm
dialog[] type: recording	Kayıt varsa kaydın adresi
dialog[] type: incomplete	Açılmayan veya başarısız aramalar, sonuç nedeniyle
analysis transcript	Yapılandırılmış konuşma sıraları, JSON kodlu
analysis summary / sentiment	Arama sonrası analiz
analysis extraction	Kendi çıkarım alanlarınız, asistanın şeması referanslı

Konteynerin uuid alanı arama kimliğinden deterministik olarak türetilir. Aynı aramayı yeniden dışa aktardığınızda yeni bir kimlik değil, aynı vCon kimliği üretilir — arşivinizde mükerrer kayıt oluşmaz.

Kayıt dosyanın içinde değil

Kayıt sesi JSON içine gömülmez; dialog kaydı kayda adresle referans verir. Böylece dosya küçük kalır ve medyanın saklama/silme kuralları sizin depolama politikanızda kalır.

Neden standart, neden özel bir yapı değil

Arama verisinin arama bittikten sonra uzun bir ömrü var: kalite denetimi, uyum arşivi, CRM zenginleştirme, model değerlendirme. Bunların her biri normalde sağlayıcının özel JSON yapısına karşı yazılmış bir dönüştürücü gerektirir — ve sağlayıcı yapıyı değiştirdiğinde o iş çöpe gider.

vCon bu maliyeti kaydırır. Alıcı sistem, belki zaten tanıdığı belgelenmiş bir konteyneri okur; kayıt referansı, döküm ve analiz üç ayrı gevşek parça değil, tek dosyada birlikte gelir.

Henüz yapılmayanlar

Uygulamanın sınırları konusunda açık olmak gerekir:

JWS imzalama / JWE şifreleme sarmalayıcıları — konteyner imzasız ve şifresiz üretilir.
consent (onay) eki — ayrı takip ediliyor; onay yaklaştırma yerine doğru modellenmeyi hak ediyor.
vCon içe alma — başka sistemlerin ürettiği vCon dosyalarını okuma.
Toplu dışa aktarma ve webhook ile teslim — dışa aktarım şimdilik arama başına ve istek üzerine.

Dışa aktarılan dosya arama dökümünü ve kişisel verileri içerir. Kendi tarafınızda saklama süresi, erişim yetkisi ve silme politikası tanımlamadan arşivlemeyin.

Arama uçları

Toplu dışa aktarma talebi

Sık sorulanlar

vCon nedir?

vCon (virtualized conversation), görüşme verisi için bir IETF konteyner biçimi. Kimlerin katıldığını, ne konuşulduğunu, varsa kaydı ve üretilen analizi tek bir kendi kendine yeten JSON belgesinde paketler; böylece görüşme sistemler arasında özel entegrasyon yazılmadan taşınabilir.

Her arama otomatik olarak vCon üretiliyor mu?

Hayır. Dışa aktarım varsayılan olarak kapalıdır ve asistan bazında açılır. Kapalıyken uç 404 döner; böylece bir aramanın var olup olmadığı bile sızmaz.

vCon açmak neyin kaydedildiğini değiştirir mi?

Hayır. Yeni hiçbir veri toplanmaz. Katılımcılar, döküm, isteğe bağlı kayıt ve arama sonrası analiz zaten üretiliyor; dışa aktarım bu mevcut kaydı standart konteynere paketliyor.

Ses kaydı dosyanın içinde mi geliyor?

Hayır. Kayıt dosyaya gömülmez; adresle referans verilir. Böylece JSON küçük kalır ve medyanın saklama kuralları sizin depolama politikanızda kalır.

Aynı aramayı tekrar dışa aktarabilir miyim?

Evet. vCon uuid alanı arama kimliğinden deterministik türetildiği için tekrar dışa aktarım yeni bir kimlik değil aynı vCon kimliğini üretir.

850santral