Konuşmaları ve kişileri programatik olarak toplu halde arşivlemek için Papo REST API'sini kullanın. Kişi güncelleme ve konuşmalara etiket uygulama uç noktalarıyla, kayıtları arşivlenmiş olarak işaretleyebilir, veri tabanınızı manuel müdahale olmadan temiz tutabilirsiniz — büyük veri hacimli operasyonlar veya birden fazla müşteriyi yöneten white label bayileri için idealdir.
Papo, özel bir “arşivle” uç noktası gerektirmez. Bunun yerine, kayıtların durumunu değiştirmek için API'de zaten mevcut olan işlemleri kullanırsınız: bir kişiyi güncelleme (arşivleme etiketi veya özel bir nitelik ekleyerek) ve bir konuşmaya etiket uygulama. Bu şekilde, scriptler veya otomasyonlar binlerce öğeyi toplu olarak işleyebilir ve veri tabanını iş kurallarınıza göre düzenleyebilir.
API ile toplu arşivleme sürecinin özeti
| Adım | Eylem | Önemli detay |
|---|---|---|
| 1. Anahtarları alın | Gizli anahtarı (sk_live_…) oluşturun ve genel anahtarı (pk_live_…) Papo panelinden kopyalayın. | Gizli anahtar yalnızca bir kez görünür; güvenli bir yerde saklayın. |
| 2. Arşivlenecekleri belirleyin | Arşivlenmesi gereken kişileri veya konuşmaları listeleyin (tarih, durum, etkileşim yokluğu vb. göre). | Filtreli listeleme uç noktalarını kullanın veya scripti beslemek için bir CSV dışa aktarın. |
| 3. Kişileri arşivleyin | Her kişi için, “arşivlendi” etiketini veya özel bir niteliği içeren bir güncelleme isteği gönderin. | Kişi güncelleme uç noktası, değiştirmek istediğiniz alanları kabul eder. |
| 4. Konuşmaları arşivleyin | Her konuşma için, etiketler uç noktasını kullanarak “arşivlendi” gibi bir etiket uygulayın. | Etiket, hesapta yoksa otomatik olarak oluşturulur. |
| 5. Sonucu doğrulayın | Kayıtların arşivleme işaretiyle görünüp görünmediğini ve platform filtrelerinin yeni düzeni yansıtıp yansıtmadığını kontrol edin. | Arşivlenmiş öğeleri gizlemek için Kişiler veya Konuşmalar modülündeki filtreleri ayarlayın. |
Nasıl çalışır – adım adım
1. Kimlik doğrulama ve anahtarlar
Verileri değiştiren her çağrı, hesabın gizli anahtarını gerektirir. Authorization başlığında (veya X-Papo-Secret-Key başlığında) Bearer token olarak gönderilmelidir. Genel anahtar (hesap başına sabit) isteğe X-Papo-Public-Key başlığında eşlik edebilir — kullanımı isteğe bağlıdır, ancak gönderilirse gizli anahtarla aynı hesaba karşılık gelmelidir.
Anahtarları Papo panelinde, geliştirici alanında oluşturun. API'nin temel URL'si https://app.papo.global/api/v1'dir. Kesin uç noktaları, parametreleri ve yük örneklerini görmek için resmi dokümantasyona başvurun.
2. Arşivlenecek kayıtları belirleme
Güncellemeleri tetiklemeden önce, hangi kişilerin veya konuşmaların arşivlenmesi gerektiğini bilmeniz gerekir. API, gerekli verileri döndüren listeleme uç noktaları sunar. Örneğin, şunları yapabilirsiniz:
- Kişileri listeleyin (ada, e-postaya, telefona göre arama veya tarih filtreleri) ve X gündür etkileşimde bulunmayanları seçin.
- Konuşmaları listeleyin ve durum veya son mesaj tarihi gibi kriterlerle çapraz kontrol edin.
Liste elinizdeyken, Python, Node.js'te bir script veya n8n'de bir otomasyon her kaydı dolaşarak arşivleme eylemini gerçekleştirebilir.
3. Kişileri toplu olarak arşivleme
Papo API'si mevcut bir kişiyi güncellemenize olanak tanır. Onu arşivlemek için şunları yapabilirsiniz:
- Kişiye bir etiket ekleyin (ör. “arşivlendi”). Güncelleme uç noktası, etiket eklemeyi kabul eder.
- Veya özel bir niteliği (örneğin “durum” veya “arşivlendi” gibi bir alan oluşturduysanız) istediğiniz değerle güncelleyin.
Önemli olan, güncellemeden sonra kişinin aktif olanlardan ayırt edilmesini sağlayan bir işaret taşımasıdır. API her istekte bir kişiyi işlediğinden, toplu işlem art arda birden çok çağrı yapılarak gerçekleştirilir. JavaScript ve Python kod örnekleri API dokümantasyonunda mevcuttur ve güncelleme uç noktası için uyarlanabilir.
4. Konuşmaları toplu olarak arşivleme
Konuşmalar için API, hesapta bir etiket oluşturan (yoksa) ve onu kişiye ve açık konuşmaya uygulayan bir uç nokta sunar. Böylece “arşivlendi” etiketini oluşturabilir ve ana görünümden kaldırmak istediğiniz tüm konuşmalara uygulayabilirsiniz.
Akış kişilerdekine benzer: konuşmaları listeleyin, arşivlenmesi gerekenleri filtreleyin ve her biri için etiket uygulama isteğini gönderin. Etiket, ilk çağrıda yoksa otomatik olarak oluşturulacaktır.
5. Arşivlemeyi kontrol etme
Script bittikten sonra, Papo panelindeki Kişiler ve Konuşmalar modüllerine gidin. Yalnızca “arşivlendi” olarak işaretlenmiş öğeleri görüntülemek için etiket filtresini kullanın — veya tam tersine, onları gizlemek ve aktif kayıtlara odaklanmak için. İşlem beklenen etkiyi göstermediyse, yükleri ve kimlik doğrulama başlıklarını gözden geçirin.
Bu otomasyon kimler için uygundur
- Büyük hacimli kişi operasyonları: veri tabanını düzenli olarak temizlemesi, ana görünümden soğuk adayları veya sonlanmış konuşmaları kaldırması gerekenler.
- White label bayileri: onlarca müşteri hesabını yöneten ve API aracılığıyla otomatik organizasyon hizmeti sunmak isteyenler.
- BT ekipleri ve geliştiriciler: CRM'i her zaman düzenli tutmak için özel entegrasyonlar oluşturanlar ve manuel eylemlere bağımlı olmayanlar.
- Diğer sistemlerden veri taşıyan şirketler: artık günlük kullanımda olmayacak eski kayıtları arşivlemek isteyenler.
Sıkça sorulan sorular
Papo API'sinin arşivlemeye özel bir uç noktası var mı?
Özel bir uç nokta gerekmez. Kayıtları arşivlenmiş olarak işaretlemek için kişi güncelleme ve konuşmalara etiket uygulama uç noktalarını kullanırsınız. Resmi dokümantasyon, kabul edilen parametreleri ayrıntılı olarak açıklar.
Arşivlemek yerine kişileri veya konuşmaları silebilir miyim?
Mevcut API silme uç noktaları sunmaz. Öneri, verileri koruyan ancak ana görünümün dışında tutan etiketler veya özel nitelikler aracılığıyla arşivlemeyi kullanmaktır.
İsteklerin kimlik doğrulamasını nasıl yaparım?
Tüm yazma çağrılarına Authorization: Bearer {gizli_anahtarınız} başlığını ekleyin. Gizli anahtar, Papo panelinde geliştirici bölümünde oluşturulur.
Binlerce kaydı tek seferde arşivlemek mümkün mü?
Evet. Kişi veya konuşma listesinde döngü yapan ve her biri için bir istek gönderen bir script oluşturmanız yeterlidir. n8n gibi araçlar da bu süreci düzenleyebilir.
Arşivlenen konuşmalar gelen kutusundan kaybolur mu?
Var olmaya devam ederler, ancak “arşivlendi” gibi bir etiket uyguladığınızda, bunları varsayılan görünümün dışında filtreleyebilirsiniz. Görüntüleme şekli, Konuşmalar modülünde yapılandırılan filtrelere bağlıdır.
API anahtarlarını nerede bulurum?
Papo panelinde, geliştirici alanına veya API ayarlarına gidin. Gizli anahtar yalnızca oluşturulma anında gösterilir; kaybolursa yeni bir tane oluşturmanız gerekir.
Ayrıca okuyun
- Papo API'sini kullanarak konuşmaları listeleme ve programatik mesaj gönderme
- Papo API'sini kullanarak kişilerin özel niteliklerini yönetme
Ücretsiz başlayın ve API ile veri tabanınızı düzenleyin →
Papo'nun ücretsiz planıyla entegrasyonu test edebilir ve kişileri ve konuşmaları toplu olarak başlangıç maliyeti olmadan arşivleyebilirsiniz.