Papo'nun Papo REST API'siyle, sitenizde form verilerini alan bir uç nokta oluşturabilir ve kişiler API'sini çağırarak CRM'de özel nitelikler dahil otomatik kayıtlar yaratabilirsiniz — manuel veri girişini ortadan kaldırır ve lead entegrasyonunu hızlandırırsınız.
Elektronik tablo dışa aktarmak veya sistemler arasında veri kopyalamak yerine bu entegrasyon, sitenizdeki her yeni kaydın gerçek zamanlı olarak Papo CRM'inde bir kişiye dönüşmesini sağlar. Akış basittir: form, verileri sizin kontrol ettiğiniz bir backend'e gönderir; bu backend Papo API'sinde kimlik doğrular ve ad, e-posta, telefon ve operasyonunuzun ihtiyaç duyduğu tüm özel alanlarla kişiyi oluşturur.
Entegrasyona genel bakış
| Bileşen | Ne yapar | Örnek |
|---|---|---|
| Sitedeki form | Lead'in adı, e-postası, telefonu ve ek alanlarını toplar. | Kayıt sayfası, açılış sayfası, ödeme. |
| Aracı uç nokta | Form verilerini alır ve Papo API'sini çağırır. | Node.js, Python betiği veya n8n/Zapier otomasyonu. |
| Papo kişiler API'si | Gönderilen verilerle CRM'de kişi oluşturur. | Gizli anahtarla kimliği doğrulanmış POST isteği. |
| Özel nitelikler | Kaynak, ilgi veya puan gibi alanları kişiye ekler. | custom_attributes ile "origem": "site", "plano_interesse": "gold". |
Nasıl çalışır: adım adım
-
Papo panelinde API anahtarlarını oluşturun
Papo hesabınızın geliştirici alanına gidin ve bir gizli anahtar oluşturun. Hesabın genel anahtarı da bu ekranda görünür. Gizli anahtar yalnızca bir kez görünür; güvenli bir yerde saklayın ve asla frontend'de açığa çıkarmayın. -
Sitenizde formu oluşturun
CRM'e göndermek istediğiniz alanlarla formu oluşturun: ad, e-posta, telefon ve ek veriler (ilgi, kaynak, şehir vb.). Form, bir sonraki adımda oluşturacağınız uç noktaya HTTP (POST) isteği göndermelidir. -
Aracı uç noktayı oluşturun
Sunucunuzda veya sunucusuz bir fonksiyonda (Node.js, Python, PHP vb.) form verilerini alan bir rota oluşturun. Bu kod şunlardan sorumlu olacaktır:- Alınan alanları doğrulamak.
- Papo API'si için JSON payload'ını hazırlamak.
- Gizli anahtarla (Bearer token) kimlik doğrulamak ve isteğe bağlı olarak genel anahtarı
X-Papo-Public-Keybaşlığında göndermek. - Papo'nun kişi oluşturma uç noktasını çağırmak.
-
Papo kişiler API'sini çağırın
Kişi oluşturma uç noktasını kullanın (tam yol ve payload biçimi için resmi belgelerehttps://papo.global/pt/docsadresinden bakın). En az ad ve e-posta veya telefon gönderin. API yanıtı, yeni kişinin verileriyle oluşturmayı onaylar. -
Özel nitelikler ekleyin
Hesabınızda özel nitelik tanımları varsa ("origem", "utm_source", "score" gibi), bunları aynı payload içinde veya tamamlayıcı bir çağrıda gönderebilirsiniz. API, kişidecustom_attributestanımlamanıza/birleştirmenize olanak tanır; böylece bu alanları sonradan manuel doldurma ihtiyacı ortadan kalkar. -
Yanıtı işleyin ve kullanıcıya dönün
Oluşturma başarılı olduktan sonra uç noktanız lead'i bir teşekkür sayfasına yönlendirebilir veya başarı mesajı gösterebilir. Hata durumunda (geçersiz anahtar, eksik veri), log kaydı alın ve kullanıcı dostu bir mesaj döndürün.
Papo API'si REST olduğundan ve JSON kullandığından, HTTP desteği olan herhangi bir dil kullanılabilir. Resmi belgeler JavaScript, Python ve curl örneklerinin yanı sıra kimlik doğrulama ayrıntılarını ve hata kodlarını içerir.
Bu entegrasyon kimler için anlamlı
- Lead toplayan siteler ve açılış sayfaları ve verilerin CRM'e manuel aktarımını ortadan kaldırmak isteyenler.
- E-ticaret siteleri ve SaaS'lar kayıt veya satın alma anında otomatik olarak kişi oluşturmak isteyenler.
- Ajanslar ve danışmanlıklar lead'lerin anında takip için gerçek zamanlı olarak CRM'e girmesini gereken kampanyalar yürütenler.
- White label bayiler ve entegratörler müşteriler için özel akışlar kurarak site formlarını manuel müdahale olmadan Papo'ya bağlayanlar.
- Pazarlama ve satış ekipleri segmentasyon için özel nitelikler kullanan ve bu alanların kaynakta otomatik doldurulmasını isteyenler.
Sıkça sorulan sorular
Bu entegrasyonu uygulamak için ileri düzey programlama bilgisine ihtiyacım var mı?
Evet. Sunucunuzda bir uç nokta geliştirmeniz veya form ile Papo API'si arasında köprü kuracak otomasyon araçlarını (n8n, Zapier) kullanmanız gerekir. Kodun kendisi basittir, ancak HTTP ve JSON işleme hakkında temel bilgi gerektirir.
Herhangi bir programlama dili kullanabilir miyim?
Evet. Papo API'si REST'tir ve JSON yanıtlar. HTTP isteklerini destekleyen herhangi bir dil (Python, Node.js, PHP, Ruby vb.) kullanılabilir. Resmi belgeler JavaScript ve Python örnekleri sunar.
Kişi oluştururken özel nitelikleri doğrudan tanımlamak mümkün mü?
Evet. Papo API'si, kişinin custom_attributes değerlerini oluşturma sırasında tanımlamanıza veya daha sonra güncellemenize olanak tanır. Tam payload biçimi ve nitelik tanımlarının hesapta zaten var olup olmadığını kontrol etmek için belgelere bakın.
Gizli anahtarın güvenliğini nasıl sağlarım?
Gizli anahtar asla frontend'de (herkese açık HTML/JavaScript) açığa çıkarılmamalıdır. Yalnızca sunucuda, ortam değişkenlerinde bulunmalıdır. Tüm iletişimlerde HTTPS kullanın ve sızıntı şüphesi varsa anahtarı hemen iptal edin.
API hata döndürürse ne yapmalıyım?
Papo API'si success: false ve kod ile mesaj içeren bir error nesnesiyle standart yanıtlar döndürür. Bu hataları kodunuzda işleyin: zorunlu alanların gönderilip gönderilmediğini doğrulayın, anahtarın etkin olup olmadığını ve payload biçiminin doğru olup olmadığını kontrol edin. Belgeler başlıca hata kodlarını listeler.
Bu entegrasyonu WordPress, Typeform veya RD Station gibi platformların formlarıyla kullanabilir miyim?
Evet. Bu platformlarda webhook'lar yapılandırarak form verilerini aracı uç noktanıza gönderebilirsiniz; bu uç nokta da Papo API'sini çağırır. Başka bir alternatif, form olayını alıp Papo'da kişi oluşturmayı tetikleyen bir akış oluşturmak için Zapier veya n8n üzerinden hazır entegrasyonları kullanmaktır.
Ayrıca okuyun
- Papo API'sini kullanarak CRM'de Şirketleri yönetme
- Papo'yu API ve webhook'larla Zapier'e entegre etme
Papo'da ücretsiz hesap oluşturun ve kayıt formlarını dakikalar içinde CRM'e bağlayın; manuel veri girişi olmadan.