Papo API'sini Kullanarak Toplu Kişi Oluşturma ve Güncelleme

Programlama yoluyla toplu kişi oluşturmak ve güncellemek için Papo REST API'sini kullanın. Gizli anahtar (Bearer token) ve hesabın genel anahtarı ile kimlik doğrulaması yaparak, CRM'de yeni kayıtlar ekleyen veya mevcut verileri değiştiren istekler gönderebilirsiniz — harici veri tabanlarını senkronize etmek, listeleri taşımak veya manuel müdahale olmadan kaydı her zaman güncel tutmak için idealdir.

Papo API'si, bir kişi oluşturmanıza (ad, e‑posta ve/veya telefon ile) ve mevcut bir kişiyi güncellemenize olanak tanıyan yazma uç noktaları sunar. Basit kimlik doğrulama ve JSON formatı ile birleştirildiğinde, bu uç noktalar betikler, otomasyon araçları (n8n gibi) veya özel entegrasyonlar tarafından sırayla yürütüldüğünde toplu işlemleri mümkün kılar.

Entegrasyon sürecinin özeti

Kimlik doğrulama ve uç noktalar nasıl çalışır

Verileri değiştiren her çağrı (oluşturma, güncelleme) hesabın gizli anahtarını gerektirir. Bu anahtar, Authorization başlığında Bearer token olarak veya alternatif olarak X-Papo-Secret-Key başlığında 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.

API'nin temel URL'si https://app.papo.global/api/v1'dir. Buradan itibaren, kişi uç noktaları yeni bir kayıt oluşturmak veya mevcut bir kaydı değiştirmek için uygun HTTP fiillerini kabul eder. Tam dokümantasyon yolları, parametreleri ve kabul edilen alanları ayrıntılı olarak açıkladığından, kodlamadan önce resmi API referansına başvurmanızı öneririz.

Kimlik doğrulama örneği (test isteği)

Anahtarlarınızın çalıştığını doğrulamak için, hesap verilerini döndüren GET /api/v1/me uç noktasını çağırabilirsiniz. Kimlik doğrulama deseni, diğer tüm uç noktalarda kullanılanla aynıdır:

curl https://app.papo.global/api/v1/me \
  -H "Authorization: Bearer sk_live_…" \
  -H "X-Papo-Public-Key: pk_live_…"

Başarılı yanıt, success: true ve hesap bilgilerini içeren data nesnesini içerir. Buradan itibaren, kişilerle ilgili istenen işleme göre uç noktayı ve HTTP yöntemini değiştirmeniz yeterlidir.

Toplu kişi oluşturma ve güncelleme

API her istekte bir kişiyi işlese de, toplu işlem birden fazla çağrının sırayla yürütülmesiyle gerçekleştirilir. Python, Node.js veya n8n'de bir otomasyon betiği şunları yapabilir:

1. Bir CSV dosyasından, veritabanından veya ERP'den kişi listesini okuyun.
2. Her kayıt için gerekli alanlarla JSON yükünü oluşturun.
3. Kişi yoksa oluşturma uç noktasına veya varsa güncelleme uç noktasına (kişi tanımlayıcısını kullanarak) isteği gönderin.
4. Yanıtları toplayın ve olası hataları ele alın (yinelenen e‑posta, geçersiz alan vb.).

API REST olduğu ve JSON kullandığı için, HTTP desteği olan herhangi bir dil çalışır. Papo ayrıca dokümantasyon sayfasında JavaScript ve Python örnekleri sunar; bunlar kişi uç noktalarına uyarlanabilir.

Oluşturma sonrası otomatik tetikleyiciler

API aracılığıyla yeni bir kişi oluşturulduğunda, CRM'in aynı dahili olayları tetiklenir. “Kişi oluşturuldu” tetikleyicisiyle yapılandırılmış bir Flow'unuz varsa, otomasyon otomatik olarak çalışır — örneğin, WhatsApp üzerinden bir karşılama mesajı göndererek veya satış ekibini bilgilendirerek. Bu, API entegrasyonunun yalnızca veri tabanını doldurmakla kalmayıp, aynı zamanda hesapta zaten var olan iletişim akışlarını da etkinleştirdiği anlamına gelir.

Bu entegrasyon kimler için uygundur

• Başka bir CRM'den veya elektronik tablodan geçiş yapan şirketler ve binlerce kişiyi tek seferde içe aktarması gereken, Papo veri tabanını senkronize tutan.
• Harici sistemlerde (açılış sayfaları, ERP'ler, e‑ticaret) potansiyel müşteri toplayan operasyonlar ve bunların otomatik olarak Papo CRM'ine girmesini, hizmet veya kampanyalar almaya hazır olmasını isteyenler.
• Papo ile dahili araçlar arasında özel entegrasyonlar kuran BT ekipleri, API'yi müşteri verilerini her zaman güncel tutmak için bir köprü olarak kullananlar.
• Birden fazla hesabı yöneten ve müşterileri için ölçekli kişi oluşturmayı otomatikleştirmek isteyen white label bayileri.

Sıkça sorulan sorular

Kişi oluşturmak veya güncellemek için gizli anahtara ihtiyacım var mı?

Evet. Tüm yazma işlemleri (oluşturma, güncelleme) hesabın gizli anahtarıyla kimlik doğrulaması gerektirir. Genel anahtar tek başına değişiklikleri yetkilendirmez.

Binlerce kişiyi tek seferde gönderebilir miyim?

API her istekte bir kişiyi işler. Büyük hacimler için, resmi dokümantasyonda açıklanan hız sınırlarına uyarak sıralı gönderimi otomatikleştirmelisiniz.

API aracılığıyla oluşturulan kişiler “Kişi oluşturuldu” Flow'unu tetikler mi?

Evet. Oluşturma olayı, kaynağından bağımsız olarak aynıdır. Bu tetikleyiciye sahip aktif bir Flow varsa, API aracılığıyla eklenen her kişi için çalıştırılır.

Yinelenmeyi önlemek için bir kişinin zaten var olup olmadığını nasıl anlarım?

Oluşturmadan önce arama uç noktalarını (e‑posta veya telefona göre filtreleyerek) kullanabilirsiniz. API dokümantasyonu mevcut sorgu parametrelerini ayrıntılı olarak açıklar.

API, kişinin yalnızca bazı alanlarını güncellemeye izin verir mi?

Evet. Güncelleme isteğinin gövdesinde, yalnızca değiştirmek istediğiniz alanları gönderin. Diğerleri değişmeden kalır.

Uç noktaların ve parametrelerin tam listesini nerede bulabilirim?

Tam referans, API dokümantasyon sayfasında mevcuttur. Orada yolları, yöntemleri, yükleri ve güncel örnekleri bulabilirsiniz.

Ayrıca okuyun

• CRM'de yeni bir kişi oluşturulduğunda bir Flow'u otomatik olarak nasıl tetiklersiniz
• Extrator'da çıkarılan kişileri CSV'ye nasıl aktarır ve Papo CRM'ine nasıl içe aktarırsınız

Ücretsiz başlayın ve CRM'inizi API aracılığıyla Papo'ya entegre edin →

İlk kullanıcı ücretsiz olduğu için, API anahtarlarınızı oluşturabilir ve toplu kişi oluşturmayı başlangıç maliyeti olmadan test edebilirsiniz.