Papo REST API'siyle CRM'deki Şirketleri listeleyebilir, arayabilir, oluşturabilir, güncelleyebilir ve kişileri Şirketlere bağlayabilirsiniz — hepsi kimlik doğrulamalı isteklerle, paneli açmadan. B2B müşteri yönetimini harici sistemler, ERP'ler, CRM'ler veya otomasyon araçlarıyla senkronize tutmanın programatik yoludur.
Papo API'si, operasyonunuzun B2B hesaplarını düzenlemesi, bağlı kişileri konsolide etmesi ve her şirketin son konuşmalarını takip etmesi için Şirketler modülünün kaynaklarını sunar. Gizli anahtarla kimlik doğrulama ve JSON yanıtları sayesinde bu uç noktalar, hesap görünümünü script'lere, otomasyonlara ve white label bayilerine entegre etmenizi sağlar.
API üzerinden Şirketler işlemlerinin özeti
| İşlem | Ne yapar | Ne zaman kullanılır |
|---|---|---|
| Şirketleri listele | CRM'de kayıtlı şirketleri ad, alan adı ve kişi sayısıyla döndürür. | Hesap tabanını denetlemek veya şirketleri başka bir sistemle senkronize etmek için. |
| Ada veya alan adına göre ara | CRM'de belirli şirketleri bulur. | Verileri güncellemeden veya kişileri bağlamadan önce B2B hesabını bulmak için. |
| Şirket ayrıntılarını getir | Bir şirketin verilerini tanımlayıcıya göre döndürür. | Entegrasyon sırasında belirli bir hesabı sorgulamak için. |
| Şirket oluştur | Yeni bir şirket oluşturur; ad zorunludur, alan adı ve açıklama isteğe bağlıdır. | Bir ERP, site veya harici akıştan B2B hesaplarını otomatik olarak kaydetmek için. |
| Şirketi güncelle | Mevcut bir şirketin adını, alan adını ve açıklamasını günceller. | CRM'i her zaman B2B müşteri tabanıyla uyumlu tutmak için. |
| Kişi bağla | CRM'deki mevcut bir kişiyi bir şirkete bağlar. | Kişiler ve hesaplar arasındaki ilişkiyi ve geçmişi konsolide etmek için. |
| Kişileri ve konuşmaları listele | Şirkete bağlı kişileri ve bu kişilerin son konuşmalarını getirir. | Hizmet veya takip sırasında hesabın tam görünümüne sahip olmak için. |
API kimlik doğrulaması nasıl çalışır
Şirketler işlemleri dahil tüm yazma rotaları, hesabın gizli anahtarını gerektirir. Bu anahtar Bearer token olarak gönderilmelidir. Hesabın genel anahtarı 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. Anahtarlar Papo panelinin geliştirici alanında oluşturulur. Gizli anahtar oluşturma sırasında yalnızca bir kez görünür; güvenli bir yerde saklayın ve sızma şüphesi varsa iptal edin.
API REST olduğu ve JSON kullandığı için HTTP desteği olan herhangi bir dil, Şirketleri script'lere, ERP'lere, CRM'lere veya otomasyon araçlarına entegre etmek için kullanılabilir. https://papo.global/pt/docs adresindeki resmi dokümantasyon, kimlik doğrulama, parametreler, yanıtlar ve kod örnekleriyle ilgili ayrıntıları sunar.
API ile Şirketler pratikte nasıl yönetilir
- Papo panelinin geliştirici alanına gidin ve bir gizli anahtar oluşturun. Hesabın genel anahtarını da kopyalayın.
- Her istekte gizli anahtarla Bearer token olarak kimlik doğrulayın. Doğrulamayı güçlendirmek isterseniz, dokümantasyonda belirtilen başlıkta genel anahtarı gönderin.
- CRM'deki şirketleri listelemek için Şirketler listeleme uç noktasını çağırın. Yanıt, her hesabın adını, alan adını ve kişi sayısını getirir.
- Belirli bir şirketi bulmak için ada veya alan adına göre arama uç noktasını kullanın. Böylece verileri güncellemek veya kişileri bağlamak için gereken tanımlayıcıyı elde edersiniz.
- Bir şirket oluşturmak için zorunlu adı içeren bir JSON payload gönderin. Alan adı ve açıklama isteğe bağlı veriler olarak eklenebilir.
- Bir şirketi güncellemek için güncelleme uç noktasında yeni ad, alan adı veya açıklama değerlerini gönderin.
- Mevcut bir kişiyi bağlamak için bağlama işleminde kişinin tanımlayıcısını ve şirketin tanımlayıcısını kullanın.
API her istekte bir işlem gerçekleştirdiği için toplu yönetim, çağrıları sırayla yürüterek yapılır. Python, Node.js ile yazılmış bir script veya n8n gibi araçlardaki bir otomasyon, bir CSV veya ERP'den hesapları okuyabilir, şirketleri kaydedebilir, kişileri bağlayabilir ve hata yönetimi için yanıtları toplayabilir.
Bu entegrasyon kimler için anlamlı
- Hesaplarını başka bir CRM veya ERP'de tutan B2B şirketleri ve bunları Papo'nun Şirketler modülüyle otomatik olarak senkronize etmek isteyenler.
- Ajanslar, danışmanlıklar, SaaS ve sağlayıcılar gibi kurumsal müşterilerle çalışan satış ekipleri ve kişileri ve konuşmaları şirket bazında konsolide etmesi gerekenler.
- Şirketleri formlardan, landing page'lerden veya harici sistemlerden toplayan operasyonlar ve bunları CRM'de manuel tekrar olmadan oluşturmak isteyenler.
- White label bayileri ve entegratörler Papo'yu müşteri sistemlerine bağlayan ve hesap yönetimini farklı ortamlar arasında tutarlı tutmak isteyenler.
- API'yi şirket tabanı ile operasyonun geri kalanı arasında köprü olarak kullanarak özel entegrasyonlar kuran BT ekipleri.
Sık sorulan sorular
Bir Şirkete bağlamadan önce kişiyi oluşturmam gerekiyor mu?
Evet. API, CRM'de zaten var olan bir kişiyi bağlar. Yeni bir kişi kaydetmek için kişi oluşturma uç noktalarını kullanın ve ardından şirketle bağlantıyı kurun.
API üzerinden bir Şirkette hangi verileri güncelleyebilirim?
Şirketin adını, alan adını ve açıklamasını güncellemek mümkündür. Oluşturma ad gerektirir; alan adı ve açıklama isteğe bağlıdır.
API bir Şirketin konuşmalarını listelemeye izin veriyor mu?
Evet. Şirketler modülü, bir şirkete bağlı kişileri ve bu kişilerin son konuşmalarını listelemeye izin vererek hizmet sırasında hesap görünümünü kolaylaştırır.
Kimlik doğrulama, Papo'nun diğer uç noktalarında kullanılanla aynı mı?
Evet. Yazma rotaları, Bearer token olarak gönderilen hesabın gizli anahtarını gerektirir. Genel anahtar isteğe bağlıdır ve gönderilirse aynı hesaba karşılık gelmelidir.
Tam yolları ve payload biçimini nerede bulabilirim?
https://papo.global/pt/docs adresinde bulunan resmi API dokümantasyonunda. Orada Şirketler ve diğer kaynaklar için kimlik doğrulama, parametreler, yanıtlar ve kod örnekleriyle ilgili ayrıntılar yer alır.
Mevcut CRM'imle Şirketler tabanını senkronize etmek için API'yi kullanabilir miyim?
Evet. API REST olduğu ve JSON kullandığı için listeleme, oluşturma, güncelleme ve kişi bağlama işlemlerini sırayla otomatikleştirerek iki sistemi uyumlu tutabilirsiniz.
Ayrıca okuyun
- Papo CRM'de Şirketler modülü nasıl kullanılır
- Papo API'siyle kişilerin özel niteliklerini yönetme
Ücretsiz başlayın ve CRM'de Şirketleri API üzerinden yönetin → Papo'nun ilk kullanıcısı sonsuza kadar ücretsizdir, kart gerekmez.