Kanban'da fırsatları programatik olarak 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 kart oluşturan, fırsatları aşamalar arasında taşıyan ve sonuçları işaretleyen istekler gönderebilir, satış hunisini manuel müdahale olmadan harici sistemlere entegre edebilirsiniz.
Papo API'si Kanban için yazma işlemleri sunar; bu sayede CRM hunileri, aşamaları ve kartlarıyla çalışabilirsiniz. Bu, bir ERP'yi, açılış sayfasını veya ödeme aracını satış hunisiyle senkronize etmeyi ve fırsatları her zaman güncel tutmayı mümkün kılar.
Kanban entegrasyonuna genel bakış
| Aşama | Eylem | Önemli ayrıntı |
|---|---|---|
| 1. Anahtarları alın | Papo panelinde gizli anahtarı (sk_live_…) oluşturun ve genel anahtarı (pk_live_…) kopyalayın. |
Gizli anahtar yalnızca bir kez görünür; güvenli bir yerde saklayın. |
| 2. Çağrıların kimliğini doğrulayın | Tüm yazma isteklerine Authorization: Bearer sk_live_… başlığını ekleyin. |
Genel anahtar X-Papo-Public-Key başlığıyla gönderilebilir (isteğe bağlı). |
| 3. Hunileri ve aşamaları öğrenin | Gerekli tanımlayıcıları almak için Kanban hunilerini ve aşamalarını listeleyin. | API yanıtı, sonraki çağrılarda kullanılan tanımlayıcıları getirir. |
| 4. Kart oluşturun veya taşıyın | Bir aşamada kart oluşturma, bir kişinin kartını başka bir aşamaya taşıma veya sonucu işaretleme işlemini gönderin. | Her işlem bir eylem gerçekleştirir; çok sayıda kayıt için gönderimi döngüyle otomatikleştirin. |
| 5. Yanıtı doğrulayın | API success: true ve kartın veya listenin verilerini döndürür. |
Hata durumunda yanıt gövdesi düzeltme için kod ve mesaj içerir. |
API Kanban'da neler yapmanıza olanak tanır
Kanban uç noktalarıyla programatik olarak şunları yapabilirsiniz:
- Mevcut hunileri ve aşamalarını ad ve konumla listeleyin.
- CRM kartlarını listeleyin.
- Kapanan satış raporları için kazanılan tüm kartları listeleyin.
- Bir aşamada, isteğe bağlı olarak mevcut bir kişiye bağlı kart oluşturun.
- Bir kişinin kartını huninin başka bir aşamasına taşıyın.
- Kartları kazanç veya kayıp olarak işaretleyin.
- Varsayılan veya özel aşamalarla bir Kanban hunisi oluşturun.
Bu işlemler, huninin Papo dışında gerçekleşenleri otomatik olarak yansıtmasını sağlar: onaylanmış bir satın alma, planlanmış bir toplantı veya web sitesinden gelen bir kayıt gibi.
Kimlik doğrulama ve çağrılar nasıl çalışır
Verileri değiştiren her çağrı, hesabın gizli anahtarını gerektirir. Authorization başlığında Bearer token olarak veya alternatif olarak X-Papo-Secret-Key başlığında gönderilmelidir. Genel anahtar isteğe X-Papo-Public-Key başlığıyla 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 Kanban uç noktaları oluşturma, taşıma, güncelleme ve listeleme 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.
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 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.
Harici sistemlerle tipik entegrasyon akışı
Python, Node.js veya n8n gibi araçlardaki bir otomasyon, huninin tam döngüsünü yürütebilir:
- Her sütunun tanımlayıcılarını almak için hunileri ve aşamaları listeleyin.
- Gerekirse bir kişiye bağlayarak başlangıç aşamasında bir kart oluşturun.
- Harici bir olay gerçekleştiğinde kartı yeni bir aşamaya taşıyın — örneğin, onaylanmış ödeme veya planlanmış toplantı.
- Fırsat tamamlandığında kartı kazanç veya kayıp olarak işaretleyin.
- Raporları, panoları veya BI sistemlerini beslemek için kazanılan kartları listeleyin.
API REST olduğundan ve JSON kullandığından, HTTP desteği olan herhangi bir dil çalışır. Her işlemin payload ve alan ayrıntıları resmi dokümantasyonda bulunur.
Bu entegrasyon kimler için uygundur
- Fırsatları açılış sayfaları, ERP'ler veya e-ticaret gibi harici sistemlerde yakalayan ve bunların otomatik olarak Papo hunisine girmesini isteyen şirketler.
- Ödeme olaylarına göre kartları taşıması gereken operasyonlar, ödeme geçitleri veya tahsilat platformları gibi, CRM'i manuel açmadan.
- BI ve veri ekipleri, kazanılan kartları ve değerleri gerçek zamanlı panolara çekmek isteyenler.
- Papo ile dahili araçlar arasında özel entegrasyonlar kuran BT ekipleri, API'yi satış hunisi ile operasyonun geri kalanı arasında köprü olarak kullananlar.
Sık sorulan sorular
Genel anahtarı tüm çağrılarda kullanmam gerekiyor mu?
Hayır. Genel anahtar isteğe bağlıdır, ancak X-Papo-Public-Key başlığında gönderilirse gizli anahtarla aynı hesaba karşılık gelmelidir.
Hunimde hangi aşamaların olduğunu nasıl bilirim?
API üzerinden Kanban hunilerini listeleyin. Yanıt, her huninin aşamalarını tanımlayıcılarıyla birlikte döndürür; bunlar kart oluşturmak veya taşımak için kullanılır.
Bir kişiye bağlı kart oluşturabilir miyim?
Evet. Kart oluşturma, isteğe bağlı olarak mevcut bir kişiye bağlanmanıza olanak tanır; müşteri geçmişi ve verileri fırsatla ilişkili kalır.
API bir kartın değerini güncellemeye izin veriyor mu?
API, Kanban kartları için yazma işlemleri sunar. Değerler dahil olmak üzere güncellenebilecek tam alanlar, resmi API dokümantasyonunda ayrıntılı olarak açıklanmıştır.
API aracılığıyla bir kartı kazanç veya kayıp olarak işaretlemek mümkün mü?
Evet. API, kartları kazanç ve kayıp olarak işaretlemenin yanı sıra raporlar ve panolar için kazanılan tüm kartları listelemenize olanak tanır.
Programlama yapmam gerekiyor mu yoksa otomasyon araçları kullanabilir miyim?
HTTP desteği olan herhangi bir dili veya n8n gibi otomasyon araçlarını kullanabilir, çağrıları istediğiniz akışa göre sırayla yürütebilirsiniz.
Ayrıca okuyun
- Papo API'sini kullanarak toplu kişi oluşturma ve güncelleme
- Papo'dan Webhook (outbound) ile gerçek zamanlı olaylar alma
İlk kullanıcı ücretsizdir ve kredi kartı gerektirmez.