`/export` Komutu ile Müşteri Veritabanı Dışa Aktarma¶

/export komutu, Hotline diyaloglarını kullanıcıları ve grup sohbetlerini içeren tablo biçiminde bir rapor olarak dışa aktarır. Tüm etkin diyalogları dışa aktarabilir, bir veya daha fazla etikete göre seçim yapabilir, belirli etiketleri hariç tutabilir ya da silinmiş konuların bilgilerini alabilirsiniz. Ayrıca dil, username, ad ve telefon gibi güncel Telegram verilerini ekleyebilirsiniz.

Bu sayfada etiket, /mark komutuyla oluşturulan ve atanan Hotline işaretini (mark) ifade eder. Bu nedenle komut sözdizimi ve CSV alanı teknik mark terimini korur.

Nasıl Çalışır¶

Komut yalnızca backend grubundaki General konusunda çalışır. Başlatıldığında General içinde bir mesaj görünür ve operatör kurulum botu ile özel sohbetinde rapor oluşturma bildirimi alır.

Tamamlanan CSV dosyası operatöre bu özel sohbetten gönderilir. General içinde yalnızca mod, satır ve hata sayılarını içeren kısa bir özet yayımlanır. Kurulum botu operatöre özel mesaj gönderemezse dışa aktarma başlamaz.

Ana Özellikler¶

Tüm etkin diyalogları dışa aktarma
Bir veya daha fazla etikete göre seçim
Belirli etiketlere sahip diyalogları hariç tutma
Silinmiş konuların bilgilerini dışa aktarma
Güncel Telegram verileri: username, ad, dil ve telefon
Aynı backend grubunda birden fazla bağlantı varsa bağlantı seçimi
Devam eden dışa aktarmayı durdurma

Dışa Aktarma Formatı¶

Etkin diyaloglar için CSV şu alanları içerir:

Alan	Açıklama
`chat_id`	Telegram sohbet veya kullanıcı kimliği; konular `chat_id(thread_id)` biçimini kullanır
`last_date`	Konudaki son mesajın tarihi
`status`	Mevcut diyalog durumu (`user_answered`, `support_answered`, `closed`)
`title`	Konu adı
`frontend_type`	Konu türü (`private`, `group`, `channel` vb.)
`topic_link`	Backend grubundaki konuya bağlantı
`marks`	`/mark` ile atanan ve bu sayfada etiket olarak adlandırılan Hotline işaretleri
`ignore_chat`	Sohbetin `IGNORE_CHATS` içinde olup olmadığını gösterir

Silinmiş diyaloglarda chat_id, last_date, status, title ve frontend_type alanları bulunur.

with seçeneği username, name, lang ve phone alanlarını ekler. Hotline bir sohbetin güncel Telegram verilerini alamazsa bunlarla birlikte error sütunu da eklenir.

CSV Formatı

CSV dosyası Excel, Google Sheets'te açılabilir veya daha fazla işlem için diğer CRM sistemlerine aktarılabilir.

/export raporu operatöre CSV olarak gönderir. API erişimiyle aynı tamamlanmış rapor /api/v2/export/{export_id}/report?format=tsv üzerinden TSV olarak alınabilir.

Komutu Çağırma¶

Yardım¶

/export
/export help

Her iki komut da İngilizce yardımı gösterir.

Tüm Etkin Diyaloglar¶

/export all

Geçerli bağlantının tüm etkin diyaloglarını dışa aktarır.

Etiketli Diyaloglar¶

/export mark deal
/export mark vip,deal

Birden fazla etiket belirtilirse rapora bunlardan en az birine sahip diyaloglar girer. /export mark vip,deal, vip veya deal etiketli diyalogları seçer.

Belirtilen etiketlerden biri yoksa dışa aktarma başlamaz. Etiket adlarını virgülle ayırın.

Etiketleri Hariç Tutma¶

/export all exclude spam,test
/export mark vip,deal exclude blocked

exclude, ardından belirtilen etiketlerden en az birine sahip diyalogları kaldırır. all ve mark modlarıyla kullanılabilir.

Silinmiş Diyaloglar¶

/export deleted

Silinmiş konu arşivindeki bilgileri dışa aktarır. Bu modda etiketler ve exclude kullanılmaz.

Veriler Hotline veritabanından alınır. Önce konuların varlığını kontrol edip eksikleri arşive taşımak için General içinde /sync all deleted çalıştırın. Çok sayıda diyalog varsa önce sınırlı sayıda dry testi yapın; örneğin /sync 10 dry.

Ek Veriler¶

/export all with username,name
/export mark vip,deal with lang,phone
/export deleted with data

with sonrasında username, name, lang ve phone alanlarını virgülle ayırarak yazın. data, dört alanın tümü için kısaltmadır.

Güncel veriler Telegram üzerinden alınır ve rapor süresini uzatır. Bağlı hesaplar veya botlar için Telegram kısıtlamaları olduğunda bazı satırlarda istenen veriler yerine error değeri bulunabilir.

Bağlantı Seçme¶

/export all instance INSTANCE_ID
/export mark vip,deal instance INSTANCE_ID with data

instance INSTANCE_ID, dışa aktarmayı yalnızca belirtilen bağlantıda çalıştırır. Aynı backend grubuna birden fazla bot veya hesap bağlıysa kullanışlıdır.

Dışa Aktarmayı Durdurma¶

/export stop

Bağlantının etkin dışa aktarmasını durdurur. Kısmi rapor oluşturulmaz. Bir bağlantıda aynı anda yalnızca bir dışa aktarma çalışabilir.

Önemli Notlar¶

Erişim hakları

Erişim EXTENSIONS_ALLOWED ile yönetilir. Liste boşsa veya yoksa komut tüm backend grubu operatörlerine açıktır. Boş olmayan liste yalnızca belirtilen operatörlere izin verir.

Gizlilik

CSV; sohbet kimlikleri, dahili segmentasyon alanları, adlar ve telefonlar içerebilir. Gizlilik kurallarına uyun. Dosyaları hemen indirmeniz ve işiniz bittiğinde sohbetten silmeniz önerilir.

Düzenli dışa aktarma

Yedeklemeler oluşturmak için düzenli veritabanı dışa aktarmaları yapın.

Boyut Sınırı

Tek bir rapor en fazla 100.000 satır içerebilir. Sonuç bu sınırı aşarsa dışa aktarma hatayla sona erer.

/export Komutu ile Müşteri Veritabanı Dışa Aktarma¶